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Предисловие 


Эта книга охватывает язык программирования ^ѵаЗсгірі и прикладные интер¬ 
фейсы ^ѵаЗсгірі, реализованные в веб-броузерах. Я писал ее для тех, кто уже 
имеет некоторый опыт программирования и желает изучить ^ѵаЗсгірі, а также 
для программистов, уже использующих ^ѵаЗсгірі, но стремящихся подняться 
на более высокий уровень мастерства и по-настоящему овладеть языком и веб¬ 
платформой. Моя цель состояла в том, чтобы максимально полно и подробно опи¬ 
сать ^ѵаЗсгірі и платформу. В результате получилась эта объемная и подробная 
книга. Однако смею надеяться, что вы будете вознаграждены за внимательное 
изучение книги и время, потраченное на ее чтение, будет компенсировано более 
высокой производительностью труда. 

Книга делится на четыре части. Часть I охватывает сам язык ^ѵаЗсгірі. Часть II 
охватывает клиентский ^ѵабсгірі: прикладные программные интерфейсы ^ѵа- 
бсгірі;, определяемые стандартом НТМЬб и сопутствующими ему стандартами 
и реализованные в веб-броузерах. Часть III представляет собой справочник по ба¬ 
зовому языку, а часть IV - справочник по клиентскому ^ѵабсгірі. Глава 1 вклю¬ 
чает краткий обзор глав первой и второй частей книги (раздел 1.1). 

Это шестое издание книги охватывает стандарты ЕСМАЗсгірі 5 (последняя вер¬ 
сия спецификации базового языка) и НТМЬб (последняя версия спецификации 
веб-платформы). Положения стандарта ЕСМАЗсгірі 5 будут рассматриваться на 
протяжении всей первой части. Нововведения, появившиеся в НТМЬб, в основ¬ 
ном будут обсуждаться в конце части II, но мы будем рассматривать их и в других 
главах. Совершенно новыми в этом издании являются глава 11 «Подмножества 
и расширения ^ѵаЗсгірі», глава 12 «Серверный ЛѵаЭсгірі», глава 19 «Библиоте¬ 
ка зС^иегу» и глава 22 «Прикладные интерфейсы НТМЬб». 

Читатели предыдущих изданий могут заметить, что в этом издании я полностью 
переписал многие главы. Главы первой части книги, посвященные основам язы¬ 
ка и охватывающие объекты, массивы, функции и классы, были переписаны за¬ 
ново и приведены в соответствие с современными приемами программирования. 
Ключевые главы второй части, описывающие документы и события, точно так же 
были полностью переписаны, чтобы привести их к современному уровню. 
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Несколько слов о пиратстве 

Если вы читаете электронную версию этой книги, за которую вы (или ваш 
работодатель) ничего не платили (или позаимствовали ее у третьего лица, не 
заплатившего за книгу), то, скорее всего, эта копия является пиратской. Ра¬ 
бота над шестым изданием продолжалась более года, и мне приходилось тру¬ 
диться над книгой полный рабочий день в течение всего этого времени. Оп¬ 
лату за свой труд я получаю, лишь когда кто-то покупает эту книгу. И един¬ 
ственным источником дохода, который позволит мне продолжить работу 
над седьмым изданием, является гонорар от продажи шестого издания. 

Я не приветствую пиратство, но, если вы читаете пиратскую копию, прочи¬ 
тайте несколько глав. Это позволит вам убедиться, что данная книга явля¬ 
ется ценным источником информации о ^ѵаЗсгірі, лучше организованным 
и более качественным, чем бесплатные (и законные) источники информа¬ 
ции, доступные в Веб. Если вы согласитесь с тем, что эта книга является 
ценным источником информации, пожалуйста, заплатите за эту ценность, 
приобретя легальную копию книги (электронную или бумажную). Если же 
вы посчитаете, что эта книга ничуть не лучше открытых источников ин¬ 
формации в Веб, пожалуйста, уничтожьте пиратскую копию и пользуйтесь 
открытыми источниками информации. 


Типографские соглашения 

В этой книге приняты следующие типографские соглашения: 

Курсив 

Обозначает первое вхождение термина. Курсив также применяется для выде¬ 
ления адресов электронной почты, адресов ШІЬ и имен файлов и каталогов. 

Моноширинный шрифт 

Применяется для форматирования программного кода на языке ^ѵаЗсгірі, 
листингов С88 и НТМЬ и вообще всего, что непосредственно набирается на 
клавиатуре при программировании. 

Моноширинный курсив 

Обозначает аргументы функций и любые другие элементы, которые в про¬ 
грамме необходимо заменить реальными значениями. 

Использование программного кода примеров 

Примеры для этой книги доступны в электронном виде. Соответствующие ссыл¬ 
ки можно найти на странице книги на веб-сайте издательства: 

1ііір://огеіІІу.сот/саіаІоё/9780596805531/ 

Данная книга призвана оказать помощь в решении ваших задач. Вы можете сво¬ 
бодно использовать примеры программного кода из этой книги в своих приложе¬ 
ниях и в документации. Вам не нужно обращаться в издательство за разрешением, 
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если вы не собираетесь воспроизводить существенные части программного кода. 
Например, если вы разрабатываете программу и задействуете в ней несколько от¬ 
рывков программного кода из книги, вам не нужно обращаться за разрешением 1 : 
Однако в случае продажи или распространения компакт-дисков с примерами из 
этой книги вам необходимо получить разрешение от издательства О’КеШу. При 
цитировании данной книги или примеров из нее и при ответе на вопросы получе¬ 
ние разрешения не требуется. При включении существенных объемов программ¬ 
ного кода примеров из этой книги в вашу документацию вам необходимо полу¬ 
чить разрешение издательства. 

Если вы соберетесь использовать программный код из этой книги, я приветст¬ 
вую, но не требую добавлять ссылку на первоисточник при цитировании. Под 
ссылкой подразумевается указание авторов, издательства и І8ВК. Например: 
<^аѵа8сгірі: ТЬе БеІіпШѵе Оиісіе, Ьу Баѵісі Папа^ап (О’КеШу). Соругі^М 2011 
Баѵісі Иапа^ап, 978-0-596-80552-4». 

Дополнительную информацию о порядке использования программного кода при¬ 
меров можно найти на странице Мір://огеіІІу.сот/риЪ/а/огеіІІу/а8к_ііт/2001/со(Іе- 
роІісу.МтІ. За получением разрешения на использование значительных объмов 
программного кода примеров из этой книги обращайтесь по адресу регтіззіопз® 
огеіііу.сот. 

Ошибки и контактная информация 

Издательство на своем сайте публикует список ошибок, найденных в книге. Вы 
можете ознакомиться со списком и отправить свои замечания об обнаруженных 
вами ошибках, посетив веб-страницу: 

Мір://огеіІІу.сот/саіаІоё/9780596805531 

С вопросами и предложениями технического характера, касающимися этой кни¬ 
ги, обращайтесь по адресу: 

Ъоокдие8ііоп8@огеіІІу.сот 

Дополнительную информацию о книгах, обсуждения. Центр ресурсов издатель¬ 
ства О’КеШу вы найдете на веб-сайте: 

Мір://ъѵъѵъѵ.огеіІІу.сот 

Можно найти нас на сайте ЕасеЬоок: кіір:///асеЪоок.сот/огеіІІу 
Следить за последними новостями на сайте ТѴіМег: 

Ыір://ІюШег.сот/огеіІІутедіа . 

Просматривать видеоматериалы на сайте ѴоиТиЪе: 
Мір://и)ияѵ.уоиіиЪе.сот/огеіІІутедіа . 

Благодарности 

Работая над этой книгой, я получал помощь от многих людей. Я хотел бы побла¬ 
годарить моего редактора, Майка Лукидеса (Міке Ьоикібев), который старался 
удержать меня в рамках планов и вносил полезные комментарии. Спасибо также 
моим техническим редакторам: Захару Кессину (2асЬагу Кеввіп), просмотрев- 
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шему многие главы в первой части, и Рафаэлю Ценно (КаНаеІе Сессо), который 
редактировал главу 19 и материал с описанием тега <сапѵаз> в главе 21. Как обыч¬ 
но, блестяще справился со своей работой производственный отдел издательства 
О’КеШу: Дэн Фокссмит (Бап ГаихзтШі), руководивший производственным про¬ 
цессом, Тереза Элси (Тегева Еізеу), выполнявшая литературную правку, Роб Ро¬ 
мано (КоЪ Котапо), готовивший иллюстрации, и Элен Тротман Цайг (ЕИеп Тго- 
иітап 2аі&), создавшая алфавитный указатель. 

В нашу эпоху широкого развития средств электронной коммуникации практиче¬ 
ски невозможно перечислить всех, кто оказывал помощь в том или ином виде. 
И мне хотелось бы поблагодарить всех, кто отвечал на мои вопросы, касающиеся 
ЕСМА8сгірІ 5, лѵЗс, всех участников списков рассылки и всех, кто делился со мной 
своими идеями, касающимися программирования на ЛѵаЗсгірІ. Я глубоко со¬ 
жалею, что не могу перечислить всех поименно, но хочу сказать, что мне было 
приятно работать с таким ярким сообществом программистов на ЛѵаЗсгірі. 

В работе над предыдущими изданиями книги принимали участие следующие ре¬ 
дакторы и рецензенты: Эндрю Шульман (Апс1ге\ѵ 8сЬи1тап), Анжело Сиригос (Ап- 
&е1о 8ігщоз), Аристотель Пагальцис (Агізіоііе Ра^аіігіз), Брендан Эйх (Вгепбап 
ЕісЬ), Кристиан Хейльманн (СЬгізііап Неіітапп), Дэн Шейфер (Бап 8Ьа1ег), Дэйв 
С. Митчелл (Баѵе С. МіісЬеІІ), Деб Камерон (БеЬ Сатегоп), Дуглас Крокфорд (Бо- 
и^іаз Сгоскіогб), д-р Танкред Хиршманн (Бг. Тапкгеб НігзсЬтапп), Дилан Ши- 
ман (Буіап ЗсЬіетапп), Френк Уиллисон (Егапк \Уі11ізоп), Джефф Штерне (СеоН 
81еагпз), Герман Вентер (Негтап Ѵепіег), Джей Ходжес (Лу Носі^ез), Джефф Яте 
@е$$ Уаіез), Джозеф Кесселман ^озерЬ Кеззеітап), Кен Купер (Кеп Соорег), Ларри 
Салливан (Ьаггу 8и11іѵап), Линн Роллинс (Ьупп Коіііпз), Нил Беркман (Кеіі Вегк- 
тап). Ник Томпсон (№ск ТЬотрзоп), Норрис Бойд (Коггіз Воусі), Паула Фергюсон 
(Раиіа Гег^изоп), Питер-Пауль Кох (Реіег-Раиі Коек), Филипп Ле Хегарет (РЫИрре 
Ье Не^агеі), Ричард Якер (КісЬагсІ Уакег), Сандерс Клейнфельд (Запбегз КІеіпІеМ), 
Скотт Фурман (8соіі Еигтап), Скотт Иссакс (8со11 Іззасз), Шон Каценбергер (8Ьоп 
КаІ 2 епЬег^ег), Терри Аллен (Теггу АИеп), Тодд Дихендорф (ТосЫ БіІсЬепсІогІ), 
Вайдур Аппарао (Ѵісіиг Аррагао) и Валдемар Хорват (\УаЫетаг Ног\ѵаі). 

Это издание книги было в значительной степени переписано заново, из-за чего 
моя семья провела массу вечеров без меня. Хочу выразить им мою любовь и бла¬ 
годарность за то, что терпели мое отсутствие. 


Дэвид Флэнаган (НИр^/іѵіѵіѵАаѵі^Іапаёап.сот), март 2011 
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Введение в ^ѵаБсгірІ 


^ѵабсгірі - это язык программирования для Веб. Подавляющее большинство 
веб-сайтов используют ^ѵабсгірі, и все современные веб-броузеры - для настоль¬ 
ных компьютеров, игровых приставок, электронных планшетов и смартфонов - 
включают интерпретатор ^ѵабсгірі, что делает ЛѵаЗсгірІ самым широкоприме¬ 
нимым языком программирования из когда-либо существовавших в истории, 
^ѵабсгірі входит в тройку технологий, которые должен знать любой веб-разра¬ 
ботчик: язык разметки НТМЬ, позволяющий определять содержимое веб-стра¬ 
ниц, язык стилей С88, позволяющий определять внешний вид веб-страниц, 
и язык программирования ^ѵабсгірі, позволяющий определять поведение веб¬ 
страниц. Эта книга поможет вам овладеть языком программирования. 

Если вы знаете другие языки программирования, вам может оказаться полезна 
информация, что ЛѵаЗсгірі является высокоуровневым, динамическим, нетипи- 
зированным и интерпретируемым языком программирования, который хорошо 
подходит для программирования в объектно-ориентированном и функциональ¬ 
ном стилях. Свой синтаксис ^ѵабсгірі унаследовал из языка ^ѵа, свои перво¬ 
классные функции - из языка 8сЬете, а механизм наследования на основе прото¬ 
типов - из языка 8е1і\ Но вам не требуется знать все эти языки или быть знакомы¬ 
ми с их терминологией для чтения этой книги и изучения ^ѵабсгірі. 

Название языка « ЛѵаЗсгірі» может вводить в заблуждение. За исключением по¬ 
верхностной синтаксической схожести, ^ѵабсгірі полностью отличается от язы¬ 
ка программирования Лѵа. ЛѵаЗсгірі давно перерос рамки языка сценариев, 
превратившись в надежный и эффективный универсальный язык программиро¬ 
вания. Последняя версия языка (смотрите врезку) определяет множество новых 
особенностей, позволяющих использовать его для разработки крупномасштабно¬ 
го программного обеспечения. 
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Глава 1. Введение в ^ѵаБсгір* 


іаѵаБсгірІ: названия и версии 

^ѵабсгірі был создан в компании Ыеізсаре на заре зарождения Веб. Назва¬ 
ние « ^ѵабсгірі» является торговой маркой, зарегистрированной компанией 
8ип Місгозузіетз (ныне Огасіе), и используется для обозначения реализа¬ 
ции языка, созданной компанией Ыеізсаре (ныне Могіііа). Компания Ыеізса- 
ре представила язык для стандартизации европейской ассоциации произво¬ 
дителей компьютеров ЕСМА (Еигореап Сотриіег Мапиіасіигег’в Аззосі- 
аііоп), но из-за юридических проблем с торговыми марками стандартизован¬ 
ная версия языка получила несколько неуклюжее название «ЕСМА8сгірі». 
Из-за тех же юридических проблем версия языка от компании Місговоіі 
получила официальное название <^8сгірі». Однако на практике все эти 
реализации обычно называют ^ѵаЗсгірІ. В этой книге мы будем использо¬ 
вать название «ЕСМА8сгірі» только для ссылки на стандарт языка. 

В течение прошлого десятилетия все веб-броузеры предоставляли реализа¬ 
цию версии 3 стандарта ЕСМАЗсгірі, и в действительности разработчикам 
не было необходимости задумываться о номерах версий: стандарт языка 
был стабилен, а его реализации в веб-броузерах в значительной мере были 
совместимыми. Недавно вышла новая важная версия стандарта языка под 
названием ЕСМА8сгірі 5, и к моменту написания этих строк производите¬ 
ли броузеров приступили к созданию его реализации. Эта книга охватыва¬ 
ет все нововведения, появившиеся в ЕСМА8сгірі 5, а также все особенно¬ 
сти, предусмотренные стандартом ЕСМАЗсгірі 3. Иногда вам будут встре¬ 
чаться названия этих версий языка, сокращенные до Е83 и Е85, а также 
название ЛѵаЗсгірі, сокращенное до 

Когда речь заходит непосредственно о самом языке, при этом подразумева¬ 
ются только версии 3 и 5 стандарта ЕСМА8сгірі. (Четвертая версия стан¬ 
дарта ЕСМА8сгірі разрабатывалась много лет, но из-за слишком амбициоз¬ 
ных целей так и не была выпущена.) Однако иногда можно встретить упо¬ 
минание о версии ЛѵаЗсгірі, например: ^ѵабсгірі 1.5 или ^ѵаЗсгірі 1.8. 
Эти номера версий присваивались реализациям ^ѵаЗсгірі, выпускаемым 
компанией Могіііа, причем версия 1.5 соответствует базовому стандарту 
ЕСМА8сгірі 3, а более высокие версии включают нестандартные расшире¬ 
ния (подробнее об этом рассказывается в главе 11). Наконец, номера версий 
также присваиваются отдельным интерпретаторам, или «механизмам» За- 
ѵаЗсгірі. Например, компания Ооо^іе разрабатывает свой интерпретатор 
^ѵабсгірі под названием Ѵ8, и к моменту написания этих строк текущей 
версией механизма Ѵ8 была версия 3.0. 


Чтобы представлять хоть какой-то интерес, каждый язык программирования 
должен иметь свою платформу, или стандартную библиотеку, или АРІ функций 
для выполнения таких базовых операций, как ввод и вывод. Ядро языка ^ѵа- 
8сгірі определяет минимальный прикладной интерфейс для работы с текстом, 
массивами, датами и регулярными выражениями, но в нем отсутствуют опера¬ 
ции ввода-вывода. Ввод и вывод (а также более сложные возможности, такие как 
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сетевые взаимодействия, сохранение данных и работа с графикой) перекладыва¬ 
ются на «окружающую среду», куда встраивается ЛѵаЗсгірІ. Обычно роль окру¬ 
жающей среды играет веб-броузер (однако в главе 12 мы увидим два примера ис¬ 
пользования ^ѵабсгірі без привлечения веб-броузера). Первая часть этой книги 
охватывает сам язык ^ѵабсгірі и его минимальный прикладной интерфейс. Вто¬ 
рая часть описывает использование ЛѵаЗсгірі в веб-броузерах и охватывает при¬ 
кладной интерфейс, предоставляемый броузерами, который иногда называют 
«клиентским ^ѵабсгірі». 

Третья часть книги представляет собой справочник по базовому АРІ языка. На¬ 
пример, чтобы ознакомиться с прикладным интерфейсом ^ѵаЗсгірі для работы 
с массивами, вы можете отыскать и прочитать раздел «Аггау» в этой части кни¬ 
ги. Четвертая часть - это справочник по клиентскому ^ѵабсгірі. Например, что¬ 
бы ознакомиться с прикладным интерфейсом ЛѵаЗсгірі для работы с графикой, 
определяемым стандартом НТМЬб для тега <сапѵаз>, можно отыскать и прочи¬ 
тать раздел «Сапѵаз» в четвертой части книги. 

В этой книге мы сначала рассмотрим низкоуровневые основы, а затем перейдем 
к базирущимся на них высокоуровневым абстракциям. Желательно читать гла¬ 
вы, придерживаясь порядка, в котором они следуют в книге. Однако изучение но¬ 
вого языка программирования никогда не было линейным процессом, точно так 
же и описание языка трудно представить в линейном виде: каждая особенность 
языка тесно связана с другими особенностями, поэтому данная книга полна пере¬ 
крестных ссылок - иногда назад, а иногда вперед - на сведения, с которыми вы 
еще не ознакомились. Эта глава являет собой первый краткий обзор основ языка 
и прикладного интерфейса клиентского ^ѵаЗсгірі и представляет ключевые осо¬ 
бенности, чем упрощает более глубокое их изучение в последующих главах. 


Исследование іаѵаБсгірі 

Изучая новый язык программирования, очень важно стараться пробовать 
запускать примеры, представленные в книге, изменять их и опять запус¬ 
кать, чтобы проверить, насколько правильно вы понимаете особенности 
языка. Для этого необходим интерпретатор ^ѵабсгірі. К счастью, любой 
веб-броузер включает интерпретатор ^ѵабсгірі, а если вы читаете эту кни¬ 
гу, у вас, скорее всего, на компьютере установлено более одного веб-броузера. 

Далее в этой главе мы увидим, что код на языке ^ѵабсгірі можно встраи¬ 
вать в НТМЬ-файлы, в теги <зсгір1:>, и при загрузке НТМЬ-файла этот код 
будет выполняться броузером. К счастью, нам не требуется поступать так 
всякий раз, когда нужно опробовать короткий фрагмент программного кода 
ЛѵаЗсгірі. Появление мощного и оригинального расширения ГігеЬи^ для 
Гігеіох (изображено на рис. 1.1 и доступно для загрузки на сайте кіір:// 
§еі{ігеЪиё.сот/) подтолкнуло производителей веб-броузеров к включению 
в них инструментов веб-разработчика, необходимых для отладки, проверки 
и изучения. Обычно эти инструменты можно отыскать в меню Тооіб (Инстру¬ 
менты или Сервис) броузера в виде пункта Оеѵеіорег Тооіб (Средства разработчика) 
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или ѴѴеЬ Сопзоіе (Веб-консоль). (Броузер Гігеіох 4 включает собственный встро¬ 
енный инструмент ѴѴеЬ Сопзоіе, но к настоящему моменту расширение Гіге- 
Ъи& обладает более широкими возможностями.) Как правило, консоль 
можно запустить нажатием горячей комбинации клавиш, такой как Р12 
или СІгІ-БЬііМ. Обычно эти инструменты открываются в виде отдельной па¬ 
нели в верхней или нижней части окна броузера, но некоторые броузеры 
открывают их в отдельном окне (как изображено на рис. 1.1), что часто бо¬ 
лее удобно. 

Панель или окно типичного «инструмента разработчика» включает мно¬ 
жество вкладок, позволяющих исследовать структуру НТМЬ-документа, 
стили С88, наблюдать за выполнением сетевых запросов и т. д. Среди них 
имеется вкладка ЗаѵаБсгірІ сопзоіе (Консоль ЗаѵаБсгірІ), где можно вводить 
строки программного кода ЛѵаЗсгірі и выполнять их. Это самый простой 
способ поэкспериментировать с ^ѵаЗсгірІ, и я рекомендую использовать 
его во время чтения этой книги. 

В современных броузерах имеется простой переносимый АРІ консоли. Для 
вывода текста в консоль можно использовать функцию сопзоіе. 1од(). Зачас¬ 
тую такая возможность оказывается удивительно полезной при отладке, 
и некоторые примеры из этой книги (даже в разделе, посвященном базово¬ 
му языку) используют сопзоіе. 1од() для вывода простого текста. Похожий, 
но более навязчивый способ вывода информации или отладочных сообще¬ 
ний заключается в передаче строки текста функции а1егі:( ), которая ото¬ 
бражает его в окне модального диалога. 



Рис . 1.1. Отладочная консоль расширения РігеЪиё для Ріге^ох 
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Этот раздел представляет собой обзор языка ^ѵабсгірі, а также обзор первой частй 
этой книги. После этой вводной главы мы опустимся на самый нижний уровень 
^ѵабсгірі: в главе 2 «Лексическая структура» будут описаны основные лексиче¬ 
ские конструкции ^ѵабсгірі, такие как комментарии, точки с запятой и набор 
символов Юникода. В главе 3 «Типы данных, значения и переменные» мы начнем 
рассматривать более интересные темы: здесь будут описаны переменные ^ѵабсгірі 
и значения, которые можно присваивать этим переменным. Ниже приводится при¬ 
мер программного кода, иллюстрирующий предмет обсуждения этих двух глав: 

// Все, что следует за двумя символами слэша, является комментарием. 

// Внимательно читайте комментарии: они описывают программный код ЦаѵаЗсгірІ:. 

// Переменная - это символическое имя некоторого значения. 

// Переменные объявляются с помощью ключевого слова ѵаг: 

ѵаг х; // Объявление переменной с именем х. 


// Присваивать значения переменным можно с помощью знака = 
х = 0; // Теперь переменная х имеет значение 0 

х // => 0: В выражениях имя переменной замещается ее значением. 


// ЦаѵаЗсгірІ: поддерживает значения различных типов 


х = 1; 
х = 0.01; 
х = "РеПо ѵюгісГ 
х = ' ^аЗсг^!': 
х = 1: гие: 
х = ^аізе; 
х = піЛІ; 
х = ііпсІеНпесІ; 


// Числа. 

// Целые и вещественные числа представлены одним типом. 
// Строки текста в кавычках. 

// Строки можно также заключать в апострофы. 

// Логические значения. 

// Другое логическое значение. 

// пиіі - особое значение, обозначающее "нет значения". 
// Значение ііпсіе^іпесі подобно значению пціі. 


Двумя другими очень важными типами данных, которыми могут манипулиро¬ 
вать программы на ^ѵабсгірі, являются объекты и массивы. Они будут рассмат¬ 
риваться в главе 6 «Объекты» и в главе 7 «Массивы» однако они настолько важ¬ 
ны, что вы не раз встретитесь с ними, прежде чем дойдете до этих глав. 

// Наиболее важным типом данных в ЦаѵаЗсгірІ: являются объекты. 

// Объект - это коллекция пар имя/значение или отображение строки в значение. 

ѵаг Ьоок = { // Объекты заключаются в фигурные скобки. 

Ііоріс: "ЦаѵаЗсгірІ:", // Свойство "Ііоріс" имеет значение "ЦаѵаЗсгірІГ. 

ТгХ: 1:гие // Свойство "Ра!!" имеет значение ігце. 

}; // Фигурная скобка отмечает конец объекта. 


// Доступ к свойствам объектов выполняется с помощью . или []: 

Ьоок. Ііоріс // => "ЦаѵаЗсгірІ:" 

Ьоокр'РаІ:"] // => Ігііе: другой способ получить значение свойства. 

Ьоок.ацІіЬог = "Ріападап"; // Создать новое свойство присваиванием. 

Ьоок.сопіепіз = {}; // {} - пустой объект без свойств. 


// ЦаѵаЗсгірІ: поддерживает массивы (списки с числовыми индексами) значений: 
ѵаг ргітез = [2, 3, 5, 7]; // Массив из 4 значений, ограничивается [ и ]. 

ргітез[0] // => 2: первый элемент (с индексом 0) массива, 

ргітез.ІепдІЬ // => 4: количество элементов в массиве. 

ргітез[ргітез.ІепдіЬ-І] // => 7: последний элемент массива. 

ргітез[4] = 9: // Добавить новый элемент присваиванием. 
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ргітез[4] = 11; 
ѵаг етріу = []; 
етріу.ІепдІЬ 


// Или изменить значение имеющегося элемента. 
// [] - пустой массив без элементов. 

// => О 


// Массивы и объекты могут хранить другие массивы и объекты: 
ѵаг роіпіз = [ // Массив с 2 элементами. 

{х:0, у:0}, // Каждый элемент - это объект. 

{х: 1, У: 1} 

]; 


ѵаг сіаіа = { 

Ігіаіі: [[1,2], [3.4]], 
Ігіа12: [[2.3]. [4,5]] 

}; 


// Объект с 2 свойствами 

// Значение каждого свойства - это массив. 

// Элементами массива являются массивы. 


Синтаксические конструкции, представленные выше и содержащие списки эле¬ 
ментов массивов в квадратных скобках или отображения свойств объектов в зна¬ 
чения внутри фигурных скобок, часто называют выражениями инициализации , 
которые будут рассматриваться в главе 4 «Выражения и операторы». Выраже¬ 
ние - это фраза на языке ^ѵабсгірі, которую можно вычислить, чтобы получить 
значение. Например, применение . и [ ] для ссылки на значение свойства объекта 
или элемента массива является выражением. Возможно, вы заметили, что в лис¬ 
тинге, приведенном выше, в строках, содержащих только выражение, коммента¬ 
рии начинаются со стрелки (=>), за которой следует значение выражения. Этому 
соглашению мы будем следовать на протяжении всей книги. 

Наиболее типичным способом формирования выражений в ^ѵаВсгірі является 
использование операторов , подобно тому, как показано ниже: 

// Операторы выполняют действия со значениями (операндами) и воспроизводят 

// новое значение. Наиболее часто используемыми являются арифметические операторы: 


3 + 2 

// => 

5 

сложение 

3 - 2 

// => 

1 

вычитание 

3 * 2 

// => 

6 

умножение 

3/2 

// => 

1 . 

5: деление 


роіпІз[1].х - роіп1з[0].х // => 1: можно использовать более сложные операнды 
"3" + "2" // => "32": + складывает числа, объединяет строки 


// В ЭаѵаЗсгірІ имеются некоторые сокращенные формы арифметических операторов 
ѵаг соьпі = 0; // Объявление переменной 


соип1:-»-+; 
соипі:-- ; 
соипі: += 2; 
соипі: *= 3: 
соипі 


// Увеличение значения переменной на 1 
// Уменьшение значения переменной на 1 
// Добавить 2: то же, что соипі = соипі + 2; 

// Умножить на 3: то же, что соипі = соипі * 3; 

// => 6: имена переменных сами являются выражениями 


// Операторы сравнения позволяют проверить два значения на равенство 
// или неравенство, выяснить, какое значение меньше или больше, и т. д. 

// Они возвращают значение Ігье или Іаізе. 

ѵаг х = 2, у = 3; // Знаки = выполняют присваивание, а не сравнение 

х == у // => Іаізе: равенство 

х != у // => Ігие: неравенство 

х < у // => Ігье: меньше 

х <= у // => Iгие: меньше или равно 

х > у // => Іаізе: больше 

х >= у // => Іаізе: больше или равно 

"Іѵѵо" == "ІЬгее" // => Іаізе: две разных строки 
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’*1:ѵѵо" > "ІИ гее" // => 1: гие : при упорядочении по алфавиту строка "Ію” больше, чем "ІИ" 

^аізе == (х > у) // => Ігію: ^аізе равно ^аізе 

• 

// Логические операторы объединяют или инвертируют логические значения 
(х == 2) && (у == 3) // => Ігце: оба сравнения истинны. && - "И" 

(х > 3) || (у < 3) // => ^аізе: оба сравнения ложны. || - "ИЛИ" 

! (х == у) // .=> Игію: ! инвертирует логическое значение 


Если фразы в языке ^ѵабсгірі называются выражениями, то полные предложе¬ 
ния называются инструкциями; они рассматриваются в главе 5 «Инструкции». 
В программном коде, приведенном выше, строки, заканчивающиеся точками 
с запятой, являются инструкциями. (В примере ниже можно увидеть инструк¬ 
ции, состоящие из нескольких строк, которые не завершаются точками с запя¬ 
той.) Между инструкциями и выражениями много общего. Грубо говоря, выра¬ 
жение - это конструкция, которая вычисляет значение, но ничего не делает: она 
никак не изменяет состояние программы. Инструкции, напротив, не имеют зна¬ 
чения (или их значение не представляет интереса для нас), но они изменяют со¬ 
стояние программы. Выше уже были показаны инструкции объявления пере¬ 
менных и присваивания значений. Еще одной обширной категорией инструкций 
являются управляющие конструкции , такие как условные инструкции и инст¬ 
рукции циклов. Примеры этих инструкций будут показаны далее, после того, 
как мы познакомимся с функциями. 

Функция - это именованный и параметризованный блок программного кода Л- 
ѵаВсгірі, который определяется один раз, а использоваться может многократно. 
Формальное знакомство с функциями мы отложим до главы 8 «Функции», одна¬ 
ко, как и в случае с объектами и массивами, мы много раз встретимся с функция¬ 
ми, прежде чем доберемся до этой главы. Ниже приводятся несколько примеров 
простых функций: 


// Функции - это параметризованные блоки программного кода ^ѵаЗсгірІ, 
// которые можно вызывать многократно. 


Гипсіііоп ріизі(х) { 
геііігп х+1; 

} 


// Определить функцию с именем " ріиві " и с параметром "х‘ 
// Вернуть значение на 1 больше полученного 
// Функции заключаются в фигурные скобки 


ріизі (у) 


// => 4: у имеет значение 3, поэтому этот вызов вернет 3+1 


ѵаг здцаге = -рцпсІііопСх) 
геііигп х*х; 

}; 

здцаге(р1из1(у)) 


// Функции можно присваивать переменным 

// Вычислить значение функции 

// Точка с запятой отмечает конец присваивания. 

// => 16: вызов двух функций в одном выражении 


При объединении функций с объектами получаются методы: 

// Функции, присвоенные свойствам объектов, называются методами. 

// Все объекты в ТаѵаЗсгірІ: имеют методы: 

ѵаг а = []; // Создать пустой массив 

а.ризН(1,2,3); // Метод ризИ() добавляет элементы в массив 

а.геѵегзеО; // Другой метод: переставляет элементы в обратном порядке 


// Можно определять собственные методы. Ключевое слово "ІПіз" ссылается на объект, 

// в котором определен метод: в данном случае на массив роіпіз. 
роіпіз.сіізі: = Гипс1:іоп( ) { // Метод вычисления расстояния между точками 

ѵаг рі = 1:Иіз[ 0]; // Первый элемент массива, относительно которого вызван метод 
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ѵаг р2 = 1:Гііз[ 1 ]; // Второй элемент объекта "ІПіз" 

ѵаг а = р2.х-р1.х; // Разность координат X 

ѵаг Ь = р2.у-р1.у; // Разность координат У 

геіцгп МаІП.здгі:(а*а + // Теорема Пифагора 

Ь*Ь); // МаІП. зцгЦ ) вычисляет корень квадратный 

>; 

роіпіз. СІІ5І( ) // => 1.414: расстояние между 2-мя точками 


Теперь, как было обещано, рассмотрим несколько функций, которые демонстри¬ 
руют применение наиболее часто используемых управляющих инструкций Лѵа- 
8сгірі: 


// В ОаѵаЗсгір! имеются условные инструкции и инструкции циклов, синтаксически 
// похожие на аналогичные инструкции С, С++, Оаѵа и в других языках. 


Іцпсііоп аЬз(х) { 

І1= (х >= 0) { 
геіцгп х; 

} 

еізе { 

геіцгп -х; 

} 

} 

Іцпсііоп Іасіогіаі(п) { 

ѵаг ргобцс! = 1; 

ѵѵИі!е(п > 1) { 
ргосіисі: *= п; 
п—: 

} 

геіигп ргосіисі:; 


// Функция, вычисляющая абсолютное значение 
// Инструкция іі ... 

// выполняет этот код, если сравнение дает Ігце. 

// Конец предложения іі. 

// Необязательное предложение еізе выполняет свой код, 

// если сравнение дает значение Іаізе. 

// Фигурные скобки можно опустить, если предложение 
// содержит 1 инструкцию. 

// Обратите внимание на инструкции геіцгп внутри іі/еізе. 


// Функция, вычисляющая факториал 
// Начать с произведения, равного 1 
// Повторять инструкции в {}, пока выраж 
// Сокращенная форма выражения ргосіисі = ргосіисі 
// Сокращенная форма выражения п = п - 1 
// Конец цикла 
// Вернуть произведение 


в () истинно 
п: 


} 

1ас1огіа1(4) 

Іцпсііоп 1ас1огіа12(п) { 
ѵаг і, ргосіцс! = 1; 
1ог(і=2; і <= п; і++) 
ргосіцс! *= і; 

геіцгп ргосіцс!: 


// => 24: 1*4*3*2 

// Другая версия, использующая другой цикл 
// Начать с 1 

// і автоматически увеличивается с 2 до п 
// Выполнять в каждом цикле. {} можно опустить, 
// если тело цикла состоит из 1 инструкции 
// Вернуть факториал 


} 

1ас!огіа12(5) // => 120: 1*2*3*4*5 


^ѵабсгірі - объектно-ориентированный язык, но используемая в нем объектная 
модель в корне отличается от модели, используемой в большинстве других язы¬ 
ков. В главе 9 «Классы и модули» детально рассматривается объектно-ориентиро¬ 
ванное программирование на языке ^ѵабсгірі на большом количестве примеров; 
эта глава является одной из самых больших в книге. Ниже приводится очень 
простой пример, демонстрирующий определение класса ^ѵабсгірі для представ¬ 
ления точек на плоскости. Объекты, являющиеся экземплярами этого класса, 
обладают единственным методом с методом г(), который вычисляет расстояние 
между данной точкой и началом координат: 


// Определение функции-конструктора для инициализации нового объекта Роіпі 
іцпсііоп Роіпі(х.у) { // По соглашению имя конструкторов начинается с заглавного символа 
ІПіз.х = х; // ІПіз - ссылка на инициализируемый объект 
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іЬіз.у = у; // Сохранить аргументы в свойствах объекта 

} // Ничего возвращать не требуется 

// Чтобы создать новый экземпляр, необходимо вызвать функцию-конструктор 
// с ключевым словом "пеѵѵ” 

ѵаг р = пеѵѵ Роіпі:(1, 1); // Точка на плоскости с координатами (1,1) 

// Методы объектов Роіпі: определяются за счет присваивания функций свойствам 
// объекта-прототипа, ассоциированного с функцией-конструктором. 

Роіпі.ргоіоіуре. г = іцпсііоп() { 

геіцгп МаіІтзцгіС // Вернуть корень квадратный от х ? + у 7 

іЬіз.х * іЬіз.х + // іЬіз - это объект Роіпі, относительно которого... 
іЬіз.у * іЬіз.у // ...вызывается метод. 

); 

}; 

// Теперь объект р типа Роіпі (и все последующие объекты Роіпі) наследует метод г() 
р.г() // => 1.414... 

Глава 9 является кульминацией первой части, а главы, которые следуют за ней, 
связывают некоторые оборванные концы и завершают исследование базового язы¬ 
ка. В главе 10 «Шаблоны и регулярные выражения» описывается грамматика регу¬ 
лярных выражений и демонстрируются приемы использования регулярных выра¬ 
жений для реализации сопоставления с текстовыми шаблонами. В главе 11 «Под¬ 
множества и расширения ЛѵаЗсгірІ» рассматриваются подмножества и расши¬ 
рения базового языка ^ѵаВсгірі. Наконец, прежде чем перейти к исследованию 
клиентского ЛѵаВсгірі в веб-броузерах, в главе 12 «Серверный Лѵа8сгірі» будут 
представлены два способа использования ЛѵаЗсгірі за пределами веб-броузеров. 

1.2. Клиентский .ІаѵаБсгірІ 

Изучение клиентского ^ѵабсгірі представляет собой задачу, нелинейную из-за 
перекрестных ссылок в значительно меньшей мере, чем базовый язык, и поэтому 
вполне возможно изучать особенности использования ^ѵаЗсгірі в веб-броузерах 
в линейном порядке. Возможно, вы взялись за чтение этой книги, чтобы изучить 
клиентский ^ѵаЗсгірі - тему далекой второй части, поэтому здесь мы приводим 
краткий обзор основных приемов программирования клиентских сценариев, ко¬ 
торый сопровождается подробным примером. 

Глава 13 « ^ѵаЗсгірі в веб-броузерах» является первой главой второй части, в ко¬ 
торой описываются детали использования ЛѵаЗсгірі в веб-броузерах. Самое 
важное, что вы узнаете в этой главе, - программный код ^ѵаЗсгірі может встраи¬ 
ваться в НТМЬ-файлы с помощью тега <зсгірі>: 

<Ьіт1> 

<ИеасІ> 

<зсгірі згс="1іЬгагу.І8"х/8сгірі> <!-- подключить библиотеку ЭаѵаЗсгірі --> 

</ИеасІ> 

<ЬосІу> 

<р>Это абзац НТМІ_</р> 

<зсгірі> 

// Это некоторый программный код на клиентском ЭаѵаЗсгірі, 

// встроенный непосредственно в НТМІ_-файл 
</зсгірі> 
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<р>Далее опять следует разметка НТМІ_.</р> 
</ЬосІу> 

</Шт1> 


Глава 14 «Объект ѴѴіпсІолѵ» исследует приемы управления веб-броузером и описы¬ 
вает некоторые наиболее важные глобальные функции клиентского ^ѵаЗсгірі. 
Например: 

<зсгір1:> 

Гцпсіііоп тоѵеоп() { 

// Вывести модальный диалог, чтобы получить ответ пользователя 
ѵаг апзмег = сопГігт("ВеасІу Іо тоѵе оп?"); 

// Если пользователь щелкнул на кнопке "ОК". заставить броузер загрузить новую страницу 
іГ (апзмег) ѵл/іпсіоѵѵ . Іоса^іоп = "Ш1:р://доод1е.сот"; 

} 

// Запустить функцию, объявленную выше, через 1 минуту (60000 миллисекунд). 
зе1:Тітеоц1:(тоѵеоп, 60000); 

</зсгір1:> 


Обратите внимание, что примеры программного кода на клиентском ^ѵаЗсгірі 
в этом разделе длиннее примеров на базовом языке, которые мы видели выше 
в этой главе. Эти примеры не предназначены для ввода в окне консоли ГігеЬи^ 
(или в другом подобном инструменте). Однако вы можете вставлять их в НТМЬ- 
файлы и затем запускать, открывая файлы в веб-броузере. Так, пример, приве¬ 
денный выше, является самостоятельным НТМЬ-файлом. 

Глава 15 «Работа с документами» переходит к исследованию фактической рабо¬ 
ты, выполняемой с помощью ^ѵаЗсгірі на стороне клиента, - управлению содер¬ 
жимым документа НТМЬ. Она покажет вам, как выбирать определенные элемен¬ 
ты НТМЬ из документов, как устанавливать НТМЬ-атрибуты этих элементов, 
как изменять содержимое элементов и как добавлять в документ новые элемен¬ 
ты. Следующая функция демонстрирует некоторые из простейших приемов поис¬ 
ка и изменения элементов документа: 

// Выводит сообщение в специальной области для отладочных сообщений внутри документа. 

// Если документ не содержит такой области, она создается. 

Гцпсіііоп сІеЬцд(тзд) { 

// Отыскать область для отладочных сообщений в документе, поиск по НТМІ_- атрибуту іб 
ѵаг Іод = босцтепі:. деГЕ1етеп1:ВуІсК"сіеЬцд1од"); 


} 


// Если элемент с атрибутом іб="сіеЬцд1од" 

і? (Под) { 

Іод = сіоситепі:. сгеаІіеЕІетепІ: ("сііѵ"); 
Іод.іб = "беЬцдІод"; 

Іод.іппегНТМІ. = "<М>0еЬцд І_од</М>"; 
босцтепі:. Ьобу. аррепсІ(М1сІ(1од); 

} 

// Теперь обернуть сообщение в теги <рге> 
ѵаг рге = босцтепі:.сгеаІіеЕІетепІ:("рге"); 
ѵаг Іехі: = босцтепі:.сгеа1:еТех1:Мосіе(тзд); 
рге. аррепсіСИіІсІ (Ііехі:); 

Іод. аррепсЮШсі(рге); 


отсутствует, создать его. 

// Создать элемент <біѵ> 

// Установить атрибут іб 
// Начальное содержимое 
// Добавить в конец документа 


и добавить в элемент Іод 
// Создать тег <рге> 

// Обернуть тзд в текстовый узел 
// Добавить текст в тег <рге> 

// Добавить <рге> в элемент Іод 


Глава 15 демонстрирует, как с помощью ^ѵаЗсгірі можно управлять НТМЬ-эле- 
ментами, которые определяют содержимое веб-страниц. Глава 16 «Каскадные таб- 
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лицы стилей» демонстрирует, как с помощью ^ѵаЗсгірі можно управлять кас¬ 
кадными таблицами стилей С88, определяющими представление содержимого. 
Чаще всего для этой цели используется атрибут НТМЬ-элементов зііуіе или сіазз: 


Ецпсііоп ИісІеСе, ге^іоѵѵ) { 
іЕ (ге^іоѵѵ) { 

е.5іу1е.Ьізріау = "попе" 

} 

еізе { 

е. зііуіе. ѵізіЬіІіІіу = "ЫЬЬеп"; 

} 

} 


// Скрывает элемент е, изменяя его стиль 
// Если 2-й аргумент Ігие, 

// скрыть элемент и использовать 
// занимаемое им место 
// Иначе 

// сделать е невидимым, но оставить 
// занимаемое им место пустым 


Ецпсііоп ЬідЫідМі(е) { // Выделяет е, устанавливая класс С53 
// Просто добавляет или переопределяет НТМІ_-атрибут сіазз. 

// Предполагается, что таблица стилей С55 уже содержит определение класса "ЫПіе" 

ІЕ (!е.сІаззМате) е.сІаззМате = "ЫШе"; 
еізе е.сІаззМате += " ЬШіе"; 

} 

^ѵа8сгірі позволяет не только управлять содержимым и оформлением НТМЬ-до- 
кументов в броузерах, но и определять поведение этих документов с помощью об¬ 
работчиков событий . Обработчик событий - это функция ^ѵаЗсгірі, которая ре¬ 
гистрируется в броузере и вызывается броузером, когда возникает событие опреде¬ 
ленного типа. Таким событием может быть щелчок мышью или нажатие клавиши 
(или какое-то движение двумя пальцами на экране смартфона). Обработчик собы¬ 
тия может также вызываться броузером по окончании загрузки документа, при 
изменении размеров окна броузера или при вводе данных в элемент НТМЬ-формы. 
Глава 17 «Обработка событий» описывает, как определять и регистрировать обра¬ 
ботчики событий и как вызываются эти обработчики при появлении событий. 

Простейший способ объявления обработчиков событий заключается в использо¬ 
вании НТМЬ-атрибутов, имена которых начинаются с приставки «оп». Обработ¬ 
чик «опсііск» особенно удобен при создании простых тестовых программ. Предпо¬ 
ложим, что вы сохранили функции сІеЬидО и ЬісІе(), представленные выше, в фай¬ 
лах с именами йеЪиё,]8 и М<1е,]8, В этом случае можно было бы написать простой 
тестовый НТМЬ-файл, использующий элементы <Ьігиоп> с атрибутами опсііск, 
определяющими обработчики событий: 

<зсгірі: 5гс="йеЬіідо5"></зсгір1:> 

<зс гірі: згс="Иіс1е . із"х/зсгірі> 

Неііо 

<Ьііиоп опс1іск="Ысіе(1:Ьі5, ігііе); сІеЬид('Иісіе Ьііиоп 1'); ">Нісіе1</Ьциоп> 

<Ьциоп опс1іск="Міс1е(ІіИіз); сІеЬид(*Пісіе Ьііиоп 2'); ”>Нісіе2</Ьііиоп> 

Іл/огісі 


Ниже приводится еще один пример программного кода на клиентском ^ѵаЗсгірі, 
использующего механизм событий. Он регистрирует обработчик очень важного 
события «Іоаб» и дополнительно демонстрирует более сложный способ регистра¬ 
ции обработчика события «сііск»: 

// Событие "ІоасГ возбуждается, когда документ будет полностью загружен. 

// Обычно мы вынуждены ждать этого события, прежде чем можно будет запустить 

// наш программный код ЗаѵаЗсгірі. 

ѵііг\боѵі . опіоасі = ЕипсііопО { // Запустит функцию после загрузки документа 
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// Отыскать все теги <ітд> в документе 

ѵаг ітадез = сіоситепі; . де1:Е1етеп1;зВуТадМате( "ітд"); 

// Обойти их все в цикле, добавить к каждому обработчик события "сііск", 

// чтобы обеспечить сокрытие любого изображения после щелчка на нем. 

Гог(ѵаг і = 0; і < ітадез. ІепдІіГі; і++) { 
ѵаг ітаде = ітадез[і]; 

іГ (ітаде.абсіЕѵеп1:І_і5І:епег) // Другой способ регистрации обработчика 
ітаде.асісіЕѵеп1:І_і5І:епег("сііск", Иісіе, Гаізе); 
еізе // Для совместимости с версией ІЕ8 и ниже 

ітаде.аиасИЕѵепіС'опсІіск", Ііісіе); 

} 

// Это функция-обработчик событий, которая регистрируется выше 

Гипсііоп ИіРе(еѵеп1:) { еѵепі.іагдеі.зіуіе.ѵізіЬіШу = "Иісісіеп"; } 

}; 

Главы 15, 16 и 17 описывают, как с помощью ЛѵаЗсгірі управлять содержимым 
(НТМЬ), представлением (С88) и поведением (обработка событий) веб-страниц. 
Прикладной интерфейс, описываемый в этих главах, является достаточно слож¬ 
ным, и до недавнего времени испытывал проблемы с совместимостью между бро¬ 
узерами. По этим причинам многие или большинство программистов на клиент¬ 
ском ЛѵаЗсгірі предпочитают использовать клиентские библиотеки или фрейм¬ 
ворку упрощающие программирование. Наиболее популярна из этих библио¬ 
тек - библиотека іС^иегу, которая обсуждается в главе 19 «Библиотека зС^иегу». 
Библиотека зС^иегу определяет простой и удобный программный интерфейс для 
управления содержимым документа, его представлением и поведением. Она была 
тщательно протестирована и может использоваться во всех основных броузерах, 
включая довольно старые, такие как ІЕ6. 

Программный код, использующий ](}иегу, легко отличить по частому использо¬ 
ванию функции $(). Ниже показано, как будет выглядеть функция сІеЬидО, пред¬ 
ставленная выше, если переписать ее с использованием зСіиегу: 

Гітсііоп беЬцд(тзд) { 

ѵаг Іод = $("#с!еЬид1од"); // Отыскать элемент для вывода тзд. 

іГ (Іод.ІепдіИ == 0) { // Если отсутствует, создать его... 

Іод = $("<сііѵ іб='беЬид1од'><М>0еЬид І_од</Мх/сІіѵ>"); 

Іод. аррепсІТо(сІоситеп1:. Ьобу); // и вставить в конец тела документа. 

} 

1од.аррепсІ($("<рге/>").1:ех1:(тзд)): // Завернуть тзд в тег <рге> 

} // и добавить в элемент Іод 

В этих четырех главах из второй части в действительности рассматривается все, 
что касается веб-страниц. Другие четыре главы переключают внимание на веб¬ 
приложения, Эти главы не о том, как использовать веб-броузеры для отображения 
документов, содержимое, представление и поведение которых управляется с помо¬ 
щью Лѵа8сгірі. Они рассказывают об использовании веб-броузеров как приклад¬ 
ной платформы и описывают прикладной интерфейс, предоставляемый современ¬ 
ными броузерами для поддержки сложных, современных клиентских веб-прило¬ 
жений. Глава 18 «Работа с протоколом НТТР» описывает, как с помощью ЛѵаЗсгірі 
можно управлять НТТР-запросами - своего рода сетевой прикладной интерфейс. 
Глава 20 «Сохранение данных на стороне клиента» описывает механизмы, позво¬ 
ляющие сохранять данные (и даже целые приложения) на стороне клиента для ис- 



1.2. Клиентский ІаѵаБсгір* 


33 


пользования в последующих сеансах работы. Глава 21 «Работа с графикой и ме¬ 
диафайлами на стороне клиента» охватывает клиентский прикладной интерфейс, 
позволяющий создавать произвольные графические изображения в НТМЬ-теге 
<сапѵаз>. И наконец, глава 22 «Прикладные интерфейсы НТМЬб» охватывает но¬ 
вые прикладные интерфейсы веб-приложений, определяемые или принятые стан¬ 
дартом НТМЬб. Сетевые взаимодействия, организация хранения данных, работа 
с графикой - все эти службы операционных систем, доступные посредством веб¬ 
броузеров, образуют новую, платформонезависимую среду выполнения приложе¬ 
ний. Если вы нацелены на броузеры, которые поддерживают эти новые приклад¬ 
ные интерфейсы, то сейчас наступает самое интересное время для программистов 
на клиентском ЛѵаВсгірі. Здесь не приводятся примеры программного кода из 
этих заключительных четырех глав, однако расширенный пример, представлен¬ 
ный ниже, использует некоторые из этих новых прикладных интерфейсов. 

1.2.1. Пример: калькулятор платежей по ссуде на .ІаѵаБсгірІ: 

Эта глава завершается расширенным примером, объединяющим в себе многие из 
описанных выше приемов и демонстрирующим полноценную программу на кли¬ 
ентском ^ѵаВсгірі (плюс НТМЬ и С88). В примере 1.1 представлена реализация 
простого калькулятора для вычисления платежей по ссуде (рис. 1.2). 



Епіег Ьоап Баіа: 

Атоипі оГ ІІіе Ьап ($) 

Аппиаі іпіегезі (%): 
Бераутепі: регіосі (уеагз) ;зо 
йрсосіе (іо ішй Іеікіегз): 


Го ап Ваіапсе, Сиіпиіаііѵе Едику, апД ІпіегехС Раутепіх 


тоооо 


Аррюхііпаіе Раутепіх: Саісиіаіс 

... 

МопЙіІу раутепі: $ 536.82 

ТоЫ раутепі. $193255.78 

ТоЫ іпіегезі $93255.78 


І_оап Ваіапсе 


8родоог$: Арріу Гог у сиг Іо ап ѵтіЙі опе оГ Йіезв йпе Іеікіегг 

♦ Бапк . оГІаѵиЙсфі: 

♦ БТМШйШяш 


Рис . 1.2. Веб-приложение - калькулятор платежей по ссуде 

Стоит потратить время на внимательное рассмотрение примера 1.1. Вряд ли вы 
сумеете досконально разобраться в нем, однако благодаря подробным коммента¬ 
риям вы должны по крайней мере получить общее представление о том, как дей¬ 
ствует это веб-приложение. Пример демонстрирует множество особенностей базо¬ 
вого языка Лѵа8сгірі, а также некоторые важные приемы программирования на 
клиентском ^ѵаЗсгірі: 
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• Поиск элементов в документе. 

• Получение ввода пользователя с помощью элементов форм. 

• Изменение содержимого элементов документа. 

• Сохранение данных в броузере. 

• Управление НТТР-запросами. 

• Создание графики с помощью элемента <сапѵаз>. 

Пример 1.1. Калькулятор вычисления платежей по ссуде на За ѵа8сгірі 

СЮОСТѴРЕ М:т1> 

<М:т1> 

<НеасІ> 

<1:і1:1е>Эаѵа8сгір1: І_оап Са1сц1а1:ог<ДШе> 

<5І:у1е> /* Таблица стилей С88: определяет внешний вид вывода программы */ 

.оиііриі: { Топі-ѵі/еідііі: Ьоісі; } /* Жирный шрифт для вычисленных значений */ 

йраутепі: { Ііехіі-сіесогаіііоп: цпбегііпе; } /* Для элементов с іб="раутеп1:" */ 
йдгарН { Ьогбег: зоіісі Ыаск Ірх; } /* Простая рамка для диаграммы */ 

1 :Гі, Щ { ѵегіісаі-аіідп: Іор; } /* Выравнивание в ячейках таблицы */ 

</з1:у1е> 

</Неаб> 

<ЬосІу> 

<! — 

Это НТМІ_-таблица с элементами <іпрц1:>, позволяющими вводить данные, и с элементами 
<зрап>, в которых отображаются результаты вычислений. Эти элементы имеют идентификаторы, 
такие как "іпіегезі" и "уеагз". Данные идентификаторы используются в Эаѵа8сгірІ-коде, 
который следует за определением таблицы. Обратите внимание, что для некоторых элементов 
ввода определены обработчики событий "опсПапде" и "опсііск". В них заданы 
строки Эаѵа8сгірІ-кода, выполняемого при вводе данных или щелчке на кнопке. 

--> 

<*аЫе> 

<1:г><1:И>Еп1:ег І_оап ОаІа:<ДІі> 

<хбх/хб> 

<ІН>І_оап Ваіапсе, Сштшіаіііѵе Ециіііу, апсі Іпіегезі: Раутеп1:з</1:Гі></1:г> 

<1:г><і:сі>Атоип1: оГ ІіГіе Іоап ($):<ДсІ> 

<^с1><іпри1; ісІ=”атоип1:*’ опсИапде=’ са1сц1а1:е(); ”></1:сІ> 

<1:6 го\л/зрап=8> 

<сапѵаз іб="дгарН" \л/і61:П="400" НеідН1:=”250' , ></сапѵа5><ДсІ><Д г> 

<1: г><1:с1>Аппиа1 іпіегезі: (%):<ДсІ> 

<16><іпрці: І6="арг" опсНапде="са1си1а1:е(); "хДсіхД г> 

<1г><1:6>Вераутеп1: регіоб (уеагз) :<Д6> 

<1:сІ><іпри1: і6="уеагз" опсНапде="са1си1а1:е(): "><Д6> 

<1:г><1:6>2ірсо6е (Іо 1"іп6 Іепбегз):<Д6> 

<Щхіпрц 1 : і 6 =” 2 ірсо 6 е" опсПапде="са1сц1а1:е(); "><Д6> 

<1:г><1:И>Арргохіта1:е Раутеп1:з:<ДП> 

<ІсІхЫіиоп опс1іск="са1сц1а1:е(); ">Са1сц1а1:е</Ьииоп><Дб><Д г> 

<1г><1:6>Моп1:П1у раутепі: :<Д6> 

<Щ>$<5рап с1азз="ои1:ри1:" і6="раутеп1:'’></зрап><Д6><Дг> 

<1г><1:6>То1:а1 раутепі: :<Д6> 

<Щ>$<5рап сіазз^оіііры*" і6="1:о1:а1"></зрап><Д6><Дг> 

<1г><1с1>То1:а1 іпіегезі: :<Д6> 

<1:6>$<зрап с1азз="ои1:ри1:" і6="1:о1:а1іп1:егез1:"></зрап><Д6><Д г> 
<1:г><і:П>8ропзогз:<ДІі><1:6 со1зрап=2> 

Арріу Го г уоиг Іоап \л/іГГі опе оі 1 ІіНезе Гіпе Іепбегз: 
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<с!іѵ іс!="1епсІег5"></с1іѵ><АсІ></1: г> 

<ДаЫе> 

* 

<!-- Остальная часть примера - Эаѵа$сгір1і-код в теге <зсгір1і> ниже. Обычно сценарии --> 
<!-- помещаются в начало документа, в заголовок <Неаб>, но в данном случае вам проще --> 
<!-- будет понять пример, если ЭаѵаЗсгірі-код будет находиться ниже НТМ1_-содержимого. --> 
<зсгір1:> 

"ызе зігісіі"; // Использовать строгий режим ЕСМАЗсгірІ: 5, если броузер поддерживает его 

Л 

* Этот сценарий определяет функцию саІсиІаіеО, вызываемую обработчиками событий 

* в разметке НТМІ_ выше. Функция читает значения из элементов <іпри1і>, вычисляет размеры 

* платежей по ссуде, отображает результаты в элементах <зрап>. Кроме того, она сохраняет 

* пользовательские данные, отображает ссылки на кредитные учреждения и рисует диаграмму. 
*/ 

^ипсіііоп саІсиІаіеО { 

// Отыскать элементы ввода и вывода в документе 

ѵаг атоцпі: = с!оситеп1:.де1:Е1етеп1:ВуІсІ("атоип1:''); 

ѵаг арг = с!оситеп1:.де1:Е1етеп1:ВуІсІ("арг''); 

ѵаг уеагз = сіосцтепі:. де1:Е1етеп1:ВуІсІ("уеагз"); 

ѵаг гірсосіе = с!оситеп1:.де1:Е1етеп1:ВуІсІ("2ірсосІе"); 

ѵаг раутепі: = сіоситепі:. де1:Е1етеп1:ВуІсІ("раутепі:”); 

ѵаг Ііоііаі = сіоситепі:. де1:Е1етеп1:ВуІсІ( ’ііоііаі”); 

ѵаг Іоіаііпіегезі: = сіосцтепі.деіЕ1етеп1:ВуІсІ("1:о1:а1іп1:еге5І:"); 

// Получить ввод пользователя из элементов ввода. Предполагается, что все данные 
// являются корректными. Преобразовать процентную ставку из процентов 
// в десятичное число и преобразовать годовую ставку в месячную ставку. 

// Преобразовать период платежей в годах в количество месячных платежей. 

ѵаг ргіпсіраі = рагзеРІоаІ:(атоцпі:.ѵаіие); 

ѵаг іпіегезі: = рагзеР1оа1і(арг. ѵаіце) / 100 / 12; 

ѵаг раутепііз = рагзеР1оа1:(уеагз.ѵаіце) * 12; 

// Теперь вычислить сумму ежемесячного платежа. 

ѵаг х = МаІП.ро\л/(1 + іпіегезі, раутепііз); // МаІП.ро\л/() вычисляет степень 
ѵаг топІНІу = (ргіпсіраі*х*іпііегезі:)/(х-1); 

// Если результатом является конечное число, следовательно, пользователь 
// указал корректные данные и результаты можно отобразить 
ІТ (ізРіпі1іе(топ1:И1у)) { 

// Заполнить поля вывода, округлив результаты до 2 десятичных знаков 
раутепі:. іппегНТМІ. = топіИІу. 1:оРіхесІ(2); 

Іоіаі. іппегНТМІ. = (топіПІу * раутепііз). 1оРіхесІ(2); 

Іоіаі іпііе тез!. іппегНТМІ = ((топ1іП1у*раутеп1із)-ргіпсіра1). іоРіхесК2); 

// Сохранить ввод пользователя, чтобы можно было восстановить данные 
// при следующем открытии страницы 

заѵе(атоцп1і.ѵаіце, арг.ѵаіце, уеагз.ѵаіце, 2 ірсосІе.ѵаіце); 

// Реклама: отыскать и отобразить ссылки на сайты местных 
// кредитных учреждений, но игнорировать сетевые ошибки 
ігу { // Перехватывать все ошибки, возникающие в этих фигурных скобках 
деИепсІегз(атоцп1і.ѵаіце, арг. ѵаіце, уеагз. ѵаіце, гірсобе.ѵаіце); 

} 

саісН(е) { /* И игнорировать эти ошибки */ } 

// В заключение вывести график изменения остатка по кредиту, а также 
// графики сумм, выплачиваемых в погашение кредита и по процентам 
сИагІ:(ргіпсіраі , іпіегезі:, топІіНІу, раутепііз); 
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} 

еізе { 

// Результат не является числом или имеет бесконечное значение, 

// что означает, что были получены неполные или некорректные данные. 

// Очистить все результаты, выведенные ранее. 

раутепГ. іппегНТМІ_ = // Стереть содержимое этих элементов 

ГоГаІ.іппегНТМІ = 

ГоГаІіпГегезГ.іппегНТМІ = 

сНагГ(); // При вызове без аргументов очищает диаграмму 

} 

} 

// Сохранить ввод пользователя в свойствах объекта ІосаІЗГогаде. Значения этих свойств 
// будут доступны при повторном посещении страницы. В некоторых броузерах (например. 

// в РігеГох) возможность сохранения не поддерживается, если страница открывается 

// с адресом 1Ж1_ вида Гііе://. Однако она поддерживается при открытии страницы через НТТР. 

ГцпсГіоп заѵе(атоііпГ, арг, уеагз, гірсосіе) { 

іГ (ѵііпдоѵі . ІосаІЗГогаде) { // Выполнить сохранение, если поддерживается 
ІосаІЗГогаде.1оап_атоцпГ = атоітГ; 

ІосаІЗГогаде.1оап_арг = арг; 

ІосаІЗГогаде.1оап_уеагз = уеагз; 

ІосаІЗГогаде. 1оап_гірсосІе = гірсосіе; 

} 

} 

// Автоматически восстановить поля ввода при загрузке документа, 
міпсіом. опіоасі = ГипсГіоп() { 

// Если броузер поддерживает ІосаІЗГогаде и имеются сохраненные данные 
іГ (міпсіоѵѵ. ІосаІЗГогаде && ІосаІЗГогаде. 1оап_атоип1і) { 

РосцтепГ . деГЕІетепГВуІсК "атоипі:"). ѵаіце = ІосаІЗГогаде. 1оап_атоип1:; 
боситепГ. де1:Е1етеп1:ВуІсІ( "арг"). ѵаіье = ІосаІЗГогаде. 1оап_арг; 
боситепГ. деГЕ1етеп1:ВуІсі( "уеагз"). ѵаіие = ІосаІЗГогаде. 1оап_уеагз; 

Роситепі:. деГЕ1етепГВуІсІ("2ірсосІе"). ѵаіье = ІосаІЗГогаде. 1оап_2ірсосіе; 

} 

}; 

// Передать ввод пользователя серверному сценарию, который может (теоретически) возвращать 
// список ссылок на сайты местных кредитных учреждений, готовых предоставить кредит. 

// Данный пример не включает фактическую реализацию такого сценария поиска кредитных 
// учреждений. Но если такой сценарий уже имеется, данная функция могла бы работать с ним. 
ГипсГіоп деГІ_епсІег5(атоип1:, арг, уеагз, гірсосіе) { 

// Если броузер не поддерживает объект ХМЕНирПециезГ, не делать ничего 
ІГ (! ѵѵіпРоѵѵ. ХМЕНГГрВециезГ) геГигп; 

// Отыскать элемент для отображения списка кредитных учреждений 
ѵаг аб = РосцтепГ. деГЕ1етепГВуІР("1епсіегз"); 

іГ (!аб) геГцгп; // Выйти, если элемент отсутствует 

// Преобразовать ввод пользователя в параметры запроса в строке УВІ_ 
ѵаг цгі = "деПепРегз. рНр" + // Адрес ІІВІ службы плюс 

"?атГ=" + епсосІеиВІСотропепГ(атоипГ) + // данные пользователя 
"&арг=" + епсосІеиВІСотропепГ(арг) + //в строке запроса 

”&уг5=" + епсосІеивІСотропепГ(уеагз) + 

"& 2 ір=" + епсоРеШСотропепГ (гірсосіе); 

// Получить содержимое по заданному адресу ІІВІ с помощью ХМЕНГГрВециезГ 

ѵаг гец = пем ХМЕНГГрВедцезГ(); // Создать новый запрос 

гед.ореп("СЕТ", и гі ); // Указать тип запроса НТТР СЕТ для игі 
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гед. зепсКпцП); // Отправить запрос без тела 

// Перед возвратом зарегистрировать обработчик события, который будет вызываться 
// при получении НТТР-ответа от сервера. Такой прием асинхронного программирования^ 
// является довольно обычным в клиентском Йаѵа8сгір1:. 
гед. опгеасІузІіаІіесНапде = ТііпсТіопО { 

ІГ (гед. геасІуЗТаІіе == 4 && гед.зТаТііз == 200) { 

// Если мы попали сюда, следовательно, был получен корректный НТТР-ответ 
ѵаг гезропзе = гед. гезропзеТехІ:; // НТТР-ответ в виде строки 

ѵаг Іепйегз = 080И.рагзе(гезропзе); // Преобразовать в 08-массив 

// Преобразовать массив объектов Іепбег в НТМІ_-строку 
ѵаг ІізТ = 

Гог(ѵаг і = 0; і < ІепсІегз.ІепдІІі; і++) { 

Іізі: += "<И><а ИгеТ= + ІепйегзСі]. цгі + + 

Іепсіе гз[ і ]. паше + "</а>"; 

} 

// Отобразить полученную НТМІ_-строку в элементе, 

// ссылка на который была получена выше, 
ай. іппегНТМІ_ = "<и1>" + Іізі + "</и1>”; 

} 

} 

} 

// График помесячного изменения остатка по кредиту, а также графики сумм, 

// выплачиваемых в погашение кредита и по процентам в НТМ1_-элементе <сапѵаз>. 

// Если вызывается без аргументов, просто очищает ранее нарисованные графики. 

Гііпсііоп сНаг1:(ргіпсіра1. іпіегезі, топіНІу. раутепіз) { 

ѵаг дгарН = йосцтепі.деіЕ1етепіВуІсІ("дгарІі"); // Ссылка на тег <сапѵаз> 

д гарН . ѵ/ісШі = дгарГі. ѵѵісИііт; // Магия очистки элемента сапѵаз 


// Если функция вызвана без аргументов или броузер не поддерживает 
// элемент <сапѵаз>, то просто вернуть управление. 

ІГ (агдцшепіз.ІепдІН == 0 11 ІдгарІі.деіСопіехі) геіцгп; 

// Получить объект "контекста" для элемента <сапѵаз>, 

// который определяет набор методов рисования 

ѵаг д = дгарІі.деіСопіехі("2сГ); // Рисование выполняется с помощью этого объекта 
ѵаг ѵі/ісШі = дгарП.\л/ій1:П, ПеідІті: = дгарН.ПеідПі; // Получить размер холста 

// Следующие функции преобразуют количество месячных платежей 
// и денежные суммы в пикселы 

Гцпсііоп раутепіТоХ(п) { геішгп п * ѵѵісИіН/раутепІіз; } 

Гцпсііоп атоипІіТоУ(а) { геішгп ПеідП1:-(а*ПеідП1:/(топ1:П1у*раутеп1:з*1.05));} 


// Платежи - прямая линия из точки (0,0) в точку (раутепіз,топ1:П1у*раутеп1:з) 


д.тоѵеТо(раутеп1:ТоХ(0), атоипІіТоУ(О)); 
д. 1іпеТо(раутеп1:ТоХ(раутеп1:з), 

ато и п іТо V (то п 1: Н1 у * рау те п 1: з)); 
д. 1іпеТо(раутеп1:ТоХ(раутеп1:з), атоцпІіТоУ(О)); 
д.сІозеРаіПО; 
д. ГШ81:у1е = "ЙГ88"; 

9.Ш10; 

д.ГопІ: = "Ьоій 12рх запз-зегіі 1 "; 
д. Гі11Тех1і("То1:а1 Іпіегезі: Раутепіз", 20,20); 


// Из нижнего левого угла 
// В правый верхний 

// В правый нижний 
// И обратно в начало 
// Светло-красный 
// Залить треугольник 
// Определить шрифт 
// Вывести текст в легенде 


// Кривая накопленной суммы погашения кредита не является линейной 
// и вывод ее реализуется немного сложнее 
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ѵаг едиіііу = 0; 

д. ЬедіпРа1:И(); // Новая фигура 

д. тоѵеТо(раутеп1іТоХ(0), атоипІіТоУ(О)); // из левого нижнего угла 

Гог(ѵаг р = 1; р <= раутепііз; р++) { 

// Для каждого платежа выяснить долю выплат по процентам 

ѵаг ІЬізМопІіЬзІпІіегезІі = (ргіпсіраі-ециіііу)*іп1:егезі:; 

едціііу += (топІіИІу - ІіЬізМопІіЬзІпІіегезІі); // Остаток - погашение кред. 

д. 1іпеТо(раутеп1іТоХ(р), атоцпІіТоУ(едіііІіу)); // Линию до этой точки 

} 


д. 1іпеТо(раутеп1іТоХ(раутеп1і5), атоітІіТоУ(О)); 
д. с1озеРа1іЬ(); 
д. ГіІІЗІіуІе = "дгееп"; 
д.ГШО; 

д. Гі11Тех1і("То1іа1 ЕдцЦу", 20,35); 


// Линию до оси X 
// И опять в нач. точку 
// Зеленый цвет 
// Залить обл. под кривой 
// Надпись зеленым цветом 


// Повторить цикл, как выше, но нарисовать график 


ѵаг Ьаі = ргіпсіраі; 
д. ЬедіпРа1:Гі(); 

д. тоѵеТо(раутеп1іТоХ(0), атоипііТоУ(ЬаІ)); 

Гог(ѵаг р = 1; р <= раутепііз; р++) { 

ѵаг ШзМопІіЬзІпІіегезІі = Ьаі * іпііе гезі; 

Ьаі -= (топІЫу - ШзМопІіЬзІпІіегезІі); // 

д. 1іпеТо(раутеп1:ТоХ(р), атоипІіТоУ (Ьаі)); // 

} 

д. 1іпеІл/іЫ:Ь = 3; // 

д.з1гоке(); // 

д.ГіІІЗІуІе = "Ыаск"; // 

д. Ш1Тех*("І_оап Ваіапсе", 20,50); // 

// Нарисовать отметки лет на оси X 
д.ІехІА1ідп="сепіег"; // 

ѵаг у = атоипІіТоУ(О); // 

І'огСѵаг уеаг=1; уеаг*12 <= раутепііз; уеаг++) { // 

ѵаг х = раутеп1іТоХ(уеаг*12); // 

д. Гі11Пес1і(х-0.5, у-3,1,3); // 


іГ (уеаг == 1) д. ШІТехІС'Уеаг", х, у-5); // 
іГ (уеаг % 5 == 0 && уеаг*12 !== раутепііз) // 
д. Гі11Тех1і(8іігіпд(уеаг), х, у-5); 

} 


// Суммы платежей у правой границы 
д. ІехІАІідп = "гідЫі"; // 

д. ІехІВазеІіпе = "тісШе"; // 

ѵаг Ііскз = [топ1іЫу*раутеп1із, ргіпсіраі]; // 
ѵаг гідЫЕсІде = раутеп1іТоХ(раутепііз); // 

Гог(ѵаг і = 0; і < Ііскз.ІепдіЬ; і++) { // 

ѵаг у = атоип1іТоУ(1ііскз[і ]); // 

д.^іІІРесІі(гідГі1іЕс1де-3, у-0.5, 3,1); // 

д. Ш1Тех1і(Зіігіпд(1ііск5[і].1іоРіхесК0)), // 


гідЫіЕЬде-5, у); 

} 

} 

</зсгір1і> 

</ЬосІу> 

</Ыіт1> 


остатка по кредиту 


Остаток от погаш. по кредиту 
Линию до этой точки 

Жирная линия 

Нарисовать кривую графика 
Черный цвет для текста 
Элемент легенды 


Текст меток по центру 
Координата У на оси X 
Для каждого года 
Вычислить позицию метки 
Нарисовать метку 
Подписать ось 
Числа через каждые 5 лет 


Текст по правому краю 
Центрировать по вертикали 
Вывести две суммы 
Координата X на оси У 
Для каждой из 2 сумм 
Определить координату У 
Нарисовать метку 
И вывести рядом сумму. 


* 




Базовый іаѵаБсгірІ 


Данная часть книги включает главы со 2 по 12, она описывает базовый язык Л- 
ѵаВсгірі и задумана как справочник по языку ЛѵаЗсгірі. Прочитав главы этой 
части один раз, вы, возможно, будете неоднократно возвращаться к ним, чтобы 
освежить в памяти более сложные особенности языка. 

• Глава 2 «Лексическая структура» 

• Глава 3 «Типы данных, значения и переменные» 

• Глава 4 «Выражения и операторы» 

• Глава 5 «Инструкции» 

• Глава 6 «Объекты» 

• Глава 7 «Массивы» 

• Глава 8 «Функции» 

• Глава 9 «Классы и модули» 

• Глава 10 «Шаблоны и регулярные выражения» 

• Глава 11 «Подмножества и расширения ЛѵаВсгірі» 

• Глава 12 «Серверный ЛѵаВсгірі» 




Лексическая структура 


Лексическая структура языка программирования - это набор элементарных пра¬ 
вил, определяющих, как пишутся программы на этом языке. Это низкоуровне¬ 
вый синтаксис языка; он определяет вид имен переменных, символы, используе¬ 
мые для обозначения комментариев, и то, как одна инструкция отделяется от 
другой. Эта короткая глава описывает лексическую структуру ^ѵа8сгірЬ 

2.1. Набор символов 

При написании программ на ^ѵа8сгір1 используется набор символов Юникода. 
Юникод является надмножеством кодировок А8СІІ и Ьаііп-І и поддерживает 
практически все письменные языки, имеющиеся на планете. Стандарт ЕСМА- 
8сгір1 3 требует, чтобы реализации ^ѵа8сгір1 обеспечивали поддержку стандар¬ 
та Юникода версии 2.1 или выше, а стандарт ЕСМА8сгірі 5 требует, чтобы реали¬ 
зации обеспечивали поддержку стандарта Юникода версии 3 или выше. Более 
подробно о Юникоде и ^ѵа8сгір1 говорится во врезке в разделе 3.2. 

2.1.1. Чувствительность к регистру 

^ѵа8сгір1 - это язык, чувствительный к регистру символов. Это значит, что 
ключевые слова, имена переменных и функций и любые другие идентификато¬ 
ры языка должны всегда содержать одинаковые наборы прописных и строчных 
букв. Например, ключевое слово ѵѵНіІе должно набираться как «лѵЬіІе», а не <ЛѴЬі- 
1е» или <ЛѴНІЬЕ». Аналогично опііпе, Опііпе, ОпІ_іпе и ОЮМЕ - это имена четырех 
разных переменных. 

Заметим, однако, что язык разметки НТМЬ (в отличие от ХНТМЬ) не чувствите¬ 
лен к регистру. Так как НТМЬ и клиентский ^ѵа8сгірі тесно связаны, это разли¬ 
чие может привести к путанице. Многие ^ѵа8сгір1-объекты и их свойства имеют 
те же имена, что и теги и атрибуты языка НТМЬ, которые они обозначают. Однако 
если в НТМЬ эти теги и атрибуты могут набираться в любом регистре, то в Заѵа- 
8сгір1 они обычно должны набираться строчными буквами. Например, атрибут 
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опсііск обработчика события чаще всего задается в НТМЬ как опСІіск, однако в За- 
ѵа8сгірі-коде (или в ХНТМЬ-документе) он должен быть обозначен как опсііск. 

X' 

2.1.2. Пробелы, переводы строк 

и символы управления форматом 

^ѵа8сгірі игнорирует пробелы, которые могут присутствовать между лексема¬ 
ми в программе. Кроме того, ^ѵабсгірі также по большей части игнорирует сим¬ 
волы перевода строки (за одним исключением, о котором рассказывается в разде¬ 
ле 2.5). Поэтому пробелы и символы перевода строки могут без ограничений ис¬ 
пользоваться в исходных текстах программ для форматирования и придания им 
удобочитаемого внешнего вида. 

Помимо обычного символа пробела (\и0020) ^ѵа8сгірі дополнительно распознает 
как пробельные следующие символы: табуляция (\и0009), вертикальная табуля¬ 
ция (\и000В), перевод формата (\и000С), неразрывный пробел (\и00А0), маркер по¬ 
рядка следования байтов (\иРЕРР), а также все символы Юникода, относящиеся 
к категории 2з. Следующие символы распознаются интерпретаторами ^ѵа8сгірі 
как символы конца строки: перевод строки (\и000А), возврат каретки (\іЮ0(Ю), раз¬ 
делитель строк (\и2028) и разделитель абзацев (\и2029). Последовательность из 
символов возврата каретки и перевода строки интерпретируется как единствен¬ 
ный символ завершения строки. 

Символы Юникода, управляющие форматом (категория С1), такие как КІСНТ- 
ТО-ЬЕЕТ МАКК (\и200Р) и ЬЕЕТ-ТО-КІСНТ МАКК (\и200Е), управляют визуаль¬ 
ным представлением текста, в котором они присутствуют. Они имеют большое 
значение для корректного отображения текста на некоторых языках и являются 
допустимыми в комментариях ^ѵа8сгірі, строковых литералах и в литералах 
регулярных выражений, но не в идентификаторах (таких как имена перемен¬ 
ных), определяемых в программах ^ѵа8сгірі. Исключение составляют 2ЕКО 
АѴГОТН ТОШЕК (\и20(Ю) и 2ЕКО АѴГОТН ЖШ-ТОШЕК (\и200С), которые можно 
использовать в идентификаторах при условии, что они не являются первыми 
символами идентификаторов. Как отмечалось выше, символ управления поряд¬ 
ком следования байтов (\иРЕРР) интерпретируется как пробельный символ. 

2.1.3. Экранированные последовательности Юникода 

Некоторые компьютеры и программное обеспечение не могут отображать или 
обеспечивать ввод полного набора символов Юникода. Для поддержки програм¬ 
мистов, использующих подобную устаревшую технику, ^ѵа8сгірі определяет 
специальные последовательности, состоящие из шести символов А8СП, представ¬ 
ляющие 16-битные кодовые пункты Юникода. Эти экранированные последова¬ 
тельности Юникода начинаются с символов \и, за которыми следуют точно четыре 
шестнадцатеричные цифры (при этом символы А-Е могут быть и строчными, 
и прописными). Экранированные последовательности Юникода могут появляться 
в строковых литералах ^ѵа8сгірі, в литералах регулярных выражений и в иден¬ 
тификаторах (но не в ключевых словах языка). Экранированная последователь¬ 
ность Юникода для символа ё, например, имеет вид \и00Е9, и с точки зрения ^ѵа- 
8сгірі следующие две строки являются идентичными: 

"саГё" === "саГ\и00е9" // => Ігие 
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Экранированные последовательности Юникода могут также появляться в ком¬ 
ментариях, но поскольку комментарии игнорируются, в данном контексте они 
воспринимаются как последовательность символов А8СІІ и не интерпретируют¬ 
ся как символы Юникода. 

2.1.4. Нормализация 

Юникод позволяет закодировать один и тот же символ несколькими способами. 
Строка «ё», например, может быть закодирована как единственный символ Юни¬ 
кода \и00Е9 или как обычный А8СІІ-символ е, со следующим за ним диакритиче¬ 
ским знаком \и0301. Эти два способа представления обеспечивают одинаковое 
отображение в текстовом редакторе, но имеют различные двоичные коды и с точ¬ 
ки зрения компьютера считаются различными. Стандарт Юникода определяет 
предпочтительные способы кодирования для всех символов и задает процедуру 
нормализации для приведения текста к канонической форме, пригодной для срав¬ 
нения. Интерпретаторы ^ѵа8сгір1 полагают, что интерпретируемый программ¬ 
ный код уже был нормализован, и не предпринимают никаких попыток нормали¬ 
зовать идентификаторы, строки или регулярные выражения. 

2.2. Комментарии 

^ѵа8сгірі поддерживает два способа оформления комментариев. Любой текст 
между символами // и концом строки рассматривается как комментарий и игно¬ 
рируется ^ѵа8сгірі. Любой текст между символами /* и */ также рассматривает¬ 
ся как комментарий. Эти комментарии могут состоять из нескольких строк, но не 
могут быть вложенными. Следующие строки представляют собой корректные За- 
ѵа8сгірі-комментарии: 

// Это однострочный комментарий. 

/* Это тоже комментарий */ // а это другой комментарий. 

/* 

* Это еще один комментарий. 

* Он располагается в нескольких строках. 

*/ 

2.3. Литералы 

Литерал - это значение, указанное непосредственно в тексте программы. Ниже 
приводятся примеры различных литералов: 

12 // Число двенадцать 

1.2 // Число одна целая две десятых 

"Неііо ѵѵогісі" // Строка текста 

’Ні’ // Другая строка 

Ігие // Логическое значение 

1"а1зе // Другое логическое значение 

^аѵазсгірі/ді // Литерал "регулярного выражения” (для поиска по шаблону) 
пиіі // Пустой объект 

Полное описание числовых и строковых литералов приводится в главе 3. Литера¬ 
лы регулярных выражений рассматриваются в главе 10. Ниже приводятся более 
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сложные выражения (смотрите раздел 4.2), которые могут служить литералами 
массивов и объектов: 

{ х:1. у:2 } // Инициализатор объекта 
[1,2,3,4,5] // Инициализатор массива 

2.4. Идентификаторы 
и зарезервированные слова 

Идентификатор - это просто имя. В ^ѵа8сгірі идентификаторы выступают 
в качестве имен переменных и функций, а также меток некоторых циклов. Иден¬ 
тификаторы в ^ѵа8сгірі должны начинаться с буквы, с символа подчеркивания 
(_) или знака доллара ($). Далее могут следовать любые буквы, цифры, символы 
подчеркивания или знаки доллара. (Цифра не может быть первым символом, так 
как тогда интерпретатору трудно будет отличать идентификаторы от чисел.) При¬ 
меры допустимых идентификаторов: 

і 

ту_ѵагіаЫе_пате 

ѵІЗ 

_с1итту 
$31: г 

Для совместимости и простоты редактирования для составления идентификато¬ 
ров обычно используются только символы А8СІІ и цифры. Однако ^ѵа8сгірі до¬ 
пускает возможность использования в идентификаторах букв и цифр из полного 
набора символов Юникода. (Технически стандарт ЕСМА8сгірі также допускает 
наличие в идентификаторах символов Юникода из категорий Мп, Мс и Рс при ус¬ 
ловии, что они не являются первыми символами идентификаторов.) Это позволя¬ 
ет программистам давать переменным имена на своих родных языках и исполь¬ 
зовать в них математические символы: 

ѵаг зі = Ггие; 
ѵаг л = 3.14; 

Подобно другим языкам программирования, ^ѵа8сгірі резервирует некоторые 
идентификаторы. Эти «зарезервированные слова» не могут использоваться в ка¬ 
честве обычных идентификаторов. Они перечислены ниже. 

2.4.1. Зарезервированные слова 

^ѵа8сгірі резервирует ряд идентификаторов, которые играют роль ключевых 
слов самого языка. Эти ключевые слова не могут служить идентификаторами 
в программах: 


Ьгеак 

сіеіеііе 

ГипсГіоп 

геГигп 

ГуреоГ 

сазе 

СІО 

іГ 

зѵѵіГсИ 

ѵаг 

саГсИ 

еізе 

іп 

ГИІ5 

ѴОІСІ 

сопіііпие 

Гаізе 

іпзГапсеоГ 

ГІігоѵѵ 

ѵѵ/ііііе 

сІеЬиддег 

Гіпаііу 

пе\л/ 

Ггие 

ѵѵіГН 

деГаиИ 

Гог 

пиіі 

Ггу 
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^ѵабсгірі также резервирует некоторые ключевые слова, которые в настоящее 
время не являются частью языка, но которые могут войти в его состав в будущих 
версиях. Стандарт ЕСМА8сгірі 5 резервирует следующие слова: 

сіазз сопзі егшт ехрогі ехіепсіз ітрогі зирег 

Ниже приводится дополнительный список слов, которые допустимы в обычном 
программном коде ^ѵабсгірі и являются зарезервированными в строгом режиме: 

ітріетепіз Іеі ргіѵаіе риЫіс уіеісі 

іпІіегТасе раскаде ргоіесіесі зіаііс 

В строгом режиме также вводится ограничение на использование следующих 
идентификаторов. Они не являются зарезервированными словами в полном по¬ 
нимании, но они не могут использоваться в качестве имен переменных, функций 
или параметров: 

агдитепіз еѵаі 

Стандарт ЕСМА8сгірі 3 резервирует все ключевые слова языка ^ѵа, и, хотя это 
требование было ослаблено в стандарте ЕСМА8сгірі 5, тем не менее следует избе¬ 
гать использования этих идентификаторов, если необходимо обеспечить работо¬ 
способность ^ѵа8сгірі-кода при использовании реализаций ^ѵабсгірі, соответ¬ 
ствующих стандарту ЕСМА8сгірі 3: 


аЬзІгасІ 

сІоиЫе 

доіо 

паііѵе 

зіаііс 

Ьооіеап 

епит 

ітріетепііз 

раскаде 

зирег 

Ьуіе 

ехрогі 

ітрогі 

ргіѵаіе 

зупсіігопііесі 

сИаг 

ехіепсіз 

іпі 

ргоіесіей 

ІІ1Г0ѴѴ5 

сіазз 

Ііпаі 

іпіегіасе 

риЫіс 

Ігапзіепі 

сопзі: 

Ііоаі 

Іопд 

5І10ГІ 

ѵоіаіііе 


В языке ^ѵа8сгірі имеется множество предопределенных глобальных перемен¬ 
ных и функций, имена которых не следует использовать для создания своих соб¬ 
ственных переменных и функций: 


агдитепіз 

епсосІеІЖІ 

Іпііпііу 

І^итЬег 

ВедЕхр 

Аггау 

епсойеІШІСотропепІ 

ізРіпіІе 

0Ь]есі 

Зігіпд 

Вооіеап 

Еггог 

ізNаN 

рагзеРІоаІ 

ЗупІахЕггог 

Оаіе 

еѵаі 

^0І\І 

рагзеіпі 

ТуреЕггог 

сіесосіеиві 

ЕѵаіЕггог 

МаІИ 

ВапдеЕггог 

ипсіеііпесі 

сІесосІеивіСотропепІ 

Рипсііоп 

ІШ 

ВеІегепсеЕггог 

ІШІЕггог 


Имейте в виду, что конкретные реализации ^ѵа8сгір1 могут содержать свои пре¬ 
допределенные глобальные переменные и функции. Кроме того, каждая конкрет¬ 
ная платформа ^ѵа8сгірі (клиентская, серверная и прочие) может иметь свой 
собственный список глобальных свойств. В описании объекта іл/іпсіом в четвертой 
части книги приводится список глобальных переменных и функций, определяе¬ 
мых реализацией клиентского ^ѵа8сгір1. 
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2.5. Необязательные точки с запятой 

Как и в других языках программирования, для отделения инструкций (глава 5) 
друг от друга в языке ^ѵабсгірі используется точка с запятой (;). Использование 
точек с запятой имеет важное значение для ясного выражения намерений про¬ 
граммиста: без этого разделителя по ошибке можно принять конец одной инст¬ 
рукции за начало следующей и наоборот. Обычно в ^ѵа8сгірі точку с запятой 
между инструкциями можно не ставить, если они находятся в разных строках. 
(Точку с запятой можно также опустить в конце программы или если следующей 
лексемой в программе является закрывающая фигурная скобка }.) Многие про¬ 
граммисты на ^ѵабсгірі используют точки с запятой для явного обозначения 
концов инструкций (этот же прием используется в примерах для этой книги), да¬ 
же если в этом нет необходимости. Другие опускают точки с запятой везде, где 
только возможно, используя их лишь в некоторых ситуациях, где они совершен¬ 
но необходимы. Прежде чем выбрать тот или иной стиль, вам необходимо позна¬ 
комиться с некоторыми особенностями использования точек с запятой в ^ѵа- 
8сгірі. 

Взгляните на следующий фрагмент. Поскольку две инструкции находятся в раз¬ 
ных строках, первую точку с запятой можно опустить: 

а = 3; 

Ь = 4; 

Однако если эти инструкции записать, как показано ниже, первая точка с запя¬ 
той становится обязательной: 

а = 3; Ь = 4; 

Обратите внимание, что в ^ѵа8сгірі не все разрывы строк интерпретируются 
как точка с запятой: разрывы строк обычно интерпретируются как точки с запя¬ 
той, только когда интерпретатор оказывается неспособен выполнить синтаксиче¬ 
ский анализ программного кода без точек с запятой. Если говорить более фор¬ 
мально (с двумя исключениями, описываемыми ниже), ^ѵа8сгірі интерпретиру¬ 
ет разрыв строки как точку с запятой, если следующий непробельный символ не 
может быть интерпретирован как продолжение текущей инструкции. Взгляните 
на следующий фрагмент: 

ѵаг а 
а 

3 

сопзоіе.Іод (а) 

^ѵабсгірі интерпретирует этот программный код, как показано ниже: 

ѵаг а; а = 3; сопзоіе.Іод (а); 

Интерпретатор ^ѵабсгірі будет интерпретировать первый разрыв строки как 
точку с запятой, потому что он не сможет проанализировать фрагмент ѵаг а а без 
точки с запятой. Второй идентификатор а можно было бы интерпретировать как 
инструкцию а;, но ^ѵа8сгірі не будет воспринимать второй разрыв строки как 
точку с запятой, потому что он сможет продолжить синтаксический анализ и по¬ 
лучить более длинную инструкцию а = 3;. 
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Эти правила интерпретации разрывов строк могут приводить к странным, на 
первый взгляд, ситуациям. Следующий фрагмент выглядит как две отдельные 
инструкции, отделенные символом перевода строки: 

ѵаг у = х + Т 
(а+Ь). ІіоЗТгіпдС ) 

Однако круглые скобки во второй строке могут быть интерпретированы как вы¬ 
зов функции Т из первой строки, и ^ѵабсгірі будет интерпретировать этот фраг¬ 
мент, как показано ниже: 

ѵаг у = х + ^(а+Ь). ІоЗІгіпдС ); 

Вероятнее всего, программист вкладывал в этот фрагмент совсем иной смысл. 
Чтобы этот фрагмент интерпретировался как две отдельные инструкции, в дан¬ 
ном случае необходимо использовать точку с запятой. 

В целом, если инструкция начинается с символа (,[,/, + или -, есть вероятность, 
что она будет воспринята интерпретатором как продолжение предыдущей инст¬ 
рукции. Инструкции, начинающиеся с символов /, + и -, редко встречаются на 
практике, но инструкции, начинающиеся с символов ( и [, встречаются достаточ¬ 
но часто, по крайней мере, при использовании некоторых стилей программирова¬ 
ния на ^ѵабсгірі. Некоторые программисты любят вставлять защитную точку 
с запятой в начало каждой такой инструкции, чтобы обеспечить корректную ее 
работу, даже если предыдущая инструкция будет изменена и ранее имевшаяся 
завершающая точка с запятой исчезнет: 

ѵаг х = 0 // Здесь точка с запятой опущена 

; [х,х+1,х+2]. ■РогЕасІ'і(сопзоІе.Іод) // Защитная ; обеспечивает обособленность 

// этой инструкции 

Из общего правила, согласно которому интерпретатор ^ѵабсгірі воспринимает 
разрывы строк как точки с запятой, когда он не может интерпретировать вторую 
строку как продолжение инструкции в первой строке, имеется два исключения. 
Первое исключение связано с инструкциями геіигп, Ьгеак и сопііпие (глава 5). Эти 
инструкции часто используются отдельно, но иногда вслед за ними указываются 
идентификаторы или выражения. Если разрыв строки находится сразу за любым 
из этих слов (перед любой другой лексемой), ^ѵаЗсгірІ всегда будет интерпрети¬ 
ровать этот разрыв строки как точку с запятой. Например, если записать: 

геіигп 

Ігие; 

интерпретатор ^ѵабсгірі предположит, что программист имеет в виду следую¬ 
щее: 

геіигп; Ігие; 

Хотя на самом деле программист, видимо, хотел написать: 

геіигп 1гие; 

Это означает, что вы не должны вставлять разрыв строки между ключевым сло¬ 
вом геіигп, Ьгеак или сопііпие и выражением, следующим за ним. Если вставить 
разрыв строки в таком месте, программный код, скорее всего, будет порождать 
ошибку во время выполнения, которую будет сложно отыскать во время отладки. 
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Второе исключение связано с операторами ++ и — (раздел 4.8). Эти операторы мо¬ 
гут быть префиксными, т. е. располагаться перед выражением, и постфиксными, 
т. е. располагаться после выражения. Если вам потребуется использовать любой 
из этих операторов в постфиксной форме записи, он должен находиться в той же 
строке, что и выражение, к которому применяется этот оператор. В противном 
случае разрыв строки будет интерпретироваться как точка с запятой, а оператор 
++ или -- будет интерпретироваться как префиксный оператор, применяемый 
к выражению, следующему далее. Например, взгляните на следующий фрагмент: 

х 

++ 

У 

Он будет интерпретирован как х; ++у;, а не как х++; у. 




Типы данных, значения и переменные 


В процессе работы компьютерные программы манипулируют значениями , таки¬ 
ми как число 3,14 или текст «Неііо АѴогІсІ». Типы значений, которые могут быть 
представлены и обработаны в языке программирования, известны как типы дан¬ 
ных , и одной из наиболее фундаментальных характеристик любого языка про¬ 
граммирования является поддерживаемый им набор типов данных. Когда в про¬ 
грамме необходимо сохранить значение, чтобы использовать его позже, это значе¬ 
ние присваивается (или сохраняется в) переменной . Переменная определяет сим¬ 
волическое имя для значения и обеспечивает возможность получить это значение 
по имени. Принцип действия переменных является еще одной фундаментальной 
характеристикой любого языка программирования. В этой главе рассматривают¬ 
ся типы, значения и переменные в языке ^ѵаВсгірі. В этих вводных абзацах да¬ 
ется только краткий обзор, и в процессе их чтения вам, возможно, окажется по¬ 
лезным возвращаться к разделу 1.1. Более полное обсуждение этих тем вы найде¬ 
те в последующих разделах. 

Типы данных в ^ѵабсгірі можно разделить на две категории: простые типы 
и объекты . К категории простых типов в языке ^ѵабсгірі относятся числа, тек¬ 
стовые строки (которые обычно называют просто строками) и логические (или 
булевы) значения. Значительная часть этой главы посвящена подробному описа¬ 
нию числового (раздел 3.1) и строкового (раздел 3.2) типов данных. Логический 
тип рассматривается в разделе 3.3. 

Специальные значения пиіі и ипсіе^іпесі являются элементарными значениями, но 
они не относятся ни к числам, ни к строкам, ни к логическим значениям. Каждое 
из них определяет только одно значение своего собственного специального типа. 
Подробнее о значениях пиіі и ипсІе'ГіпесІ рассказывается в разделе 3.4. 

Любое значение в языке ^ѵабсгірі, не являющееся числом, строкой, логическим 
значением или специальным значением пиіі или ипсІе'ГіпесІ, является объектом. 
Объект (т. е. член объектного типа данных) представляет собой коллекцию свойств , 
каждое из которых имеет имя и значение (либо простого типа, такое как число 
или строка, либо объектного). В разделе 3.5 мы рассмотрим один специальный 
объект, глобальный объект , но более подробно объекты обсуждаются в главе 6. 
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Обычный объект ^ѵабсгірі представляет собой неупорядоченную коллекцию 
именованных значений. Кроме того, в ^ѵабсгірі имеется объект специального 
типа, известный как массиву представляющий упорядоченную коллекцию про- 
нумерованных значений. Для работы с массивами в языке ^ѵабсгірі имеются 
специальные синтаксические конструкции. Кроме того, массивы ведут себя не¬ 
сколько иначе, чем обычные объекты. Подробнее о массивах будет рассказывать¬ 
ся в главе 7. 

В Лаѵабсгірі определен еще один специальный тип объекта, известный как функ¬ 
ция . Функция - это объект, с которым связан выполняемый код. Функция может 
вызываться для выполнения определенной операции и возвращать вычисленное 
значение. Подобно массивам, функции ведут себя не так, как другие виды объек¬ 
тов, и в ^ѵабсгірі определен специальный синтаксис для работы с ними. Одна из 
важнейших особенностей функций в ^ѵабсгірі состоит в том, что они являются 
самыми настоящими значениями, и программы ^ѵа8сгірі могут манипулиро¬ 
вать ими, как обычными объектами. Подробнее о функциях рассказывается 
в главе 8. 

Функции, которые пишутся для инициализации вновь создаваемых объектов 
(с оператором пеѵѵ), называются конструкторами . Каждый конструктор опреде¬ 
ляет класс объектов - множество объектов, инициализируемых этим конструк¬ 
тором. Классы можно представлять как подтипы объектного типа. В дополнение 
к классам Аггау и Рипсііоп в базовом языке ^ѵа8сгірі определены еще три полез¬ 
ных класса. Класс Оаііе определяет объекты, представляющие даты. Класс ВедЕхр 
определяет объекты, представляющие регулярные выражения (мощный инстру¬ 
мент сопоставления с шаблоном, описываемый в главе 10). А класс Еггог опреде¬ 
ляет объекты, представляющие синтаксические ошибки и ошибки времени вы¬ 
полнения, которые могут возникать в программах на языке ^ѵа8сгірі. Имеется 
возможность определять собственные классы объектов, объявляя соответствую¬ 
щие функции-конструкторы. Подробнее об этом рассказывается в главе 9. 

Интерпретатор ^ѵа8сгірі автоматически выполняет сборку мусора в памяти. 
Это означает, что программа может создавать объекты по мере необходимости, но 
программисту нет необходимости беспокоиться об уничтожении этих объектов 
и освобождении занимаемой ими памяти. Когда объект выходит за пределы об¬ 
ласти видимости (т. е. когда программа утрачивает возможность доступа к этому 
объекту) и интерпретатор обнаруживает, что данный объект никогда больше не 
сможет использоваться, он автоматически освобождает занимаемую им память. 

^ѵа8сгірі - это объектно-ориентированный язык программирования. В общих 
чертах это означает, что вместо глобальных функций для обработки значений раз¬ 
личных типов типы сами могут определять методы для обработки значений. На¬ 
пример, чтобы отсортировать элементы массива а, необязательно передавать мас¬ 
сив а функции зогіО. Вместо этого можно просто вызвать метод зогіО массива а: 

а.зогіО; // Объектно-ориентированная версия вызова зог1:(а). 

Порядок определения методов описывается в главе 9. С технической точки зре¬ 
ния в языке ^ѵа8сгірі только объекты могут иметь методы. Однако числа, стро¬ 
ки и логические значения ведут себя так, как если бы они обладали методами 
(данная особенность описывается в разделе 3.6). Значения пиіі и ипсіе1 = іпес1 явля¬ 
ются единственными в языке ^ѵа8сгір1, которые не имеют методов. 




3.1. Числа 
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Типы данных в языке ^ѵаЗсгірі можно разделить на простые и объектные. Их 
также можно разделить на типы с методами и типы без методов. Кроме того, типы 
можно характеризовать как изменяемые и неизменяемые . Значение изменяемого 
типа можно изменить. Объекты и массивы относятся к изменяемым типам: про¬ 
грамма на языке ^ѵаЗсгірі может изменять значения свойств объектов и элемен¬ 
тов массивов. Числа, логические значения, гшіі и ипс!е1 = іпес1 являются неизменяе¬ 
мыми - не имеет даже смысла говорить об изменчивости, например, значения 
числа. Строки можно представить себе как массивы символов, отчего можно 
счесть, что они являются изменяемыми. Однако строки в ^ѵабсгірі являются не¬ 
изменяемыми: строки предусматривают возможность обращения к символам по 
числовым индексам, но в ^ѵаЗсгірі отсутствует возможность изменить сущест¬ 
вующую текстовую строку. Различия между изменяемыми и неизменяемыми 
значениями будут рассматриваться ниже, в разделе 3.7. 

В языке ^ѵаЗсгірі значения достаточно свободно могут быть преобразованы из 
одного типа в другой. Например, если программа ожидает получить строку, а вы 
передаете ей число, интерпретатор автоматически преобразует число в строку. 
Если вы укажете нелогическое значение там, где ожидается логическое, интер¬ 
претатор автоматически выполнит соответствующее преобразование. Правила 
преобразований описываются в разделе 3.8. Свобода преобразований типов зна¬ 
чений в ^ѵаЗсгірі затрагивает и понятие равенства, и оператор == проверки на 
равенство выполняет преобразование типов, как описывается в разделе 3.8.1. 

Переменные в ^ѵаЗсгірі не имеют типа: переменной может быть присвоено зна¬ 
чение любого типа и позднее этой же переменной может быть присвоено значение 
другого типа. Объявление переменных выполняется с помощью ключевого слова 
ѵаг. В языке ^ѵаЗсгірі используются лексические области видимости. Перемен¬ 
ные, объявленные за пределами функции, являются глобальными переменными 
и доступны из любой точки программы. Переменные, объявленные внутри функ¬ 
ции, находятся в области видимости функции и доступны только внутри этой 
функции. Порядок объявления переменных и их видимость обсуждаются в раз¬ 
делах 3.9 и 3.10. 

3.1. Числа 

В отличие от многих языков программирования, в ^ѵаЗсгірі не делается разли¬ 
чий между целыми и вещественными значениями. Все числа в ^ѵабсгірі пред¬ 
ставляются вещественными значениями (с плавающей точкой). Для представ¬ 
ления чисел в ^ѵаЗсгірі используется 64-битный формат, определяемый стан¬ 
дартом ІЕЕЕ 754. 1 Этот формат способен представлять числа в диапазоне от 
±1,7976931348623157 х ІО 308 до ±5 х ІО' 324 . 

Формат представления вещественных чисел в ^ѵаЗсгірі позволяет точно пред¬ 
ставлять все целые числа от -9007199254740992 (-2 53 ) до 9007199254740992 (2 53 ) 
включительно. Для целых значений вне этого диапазона может теряться точность 
в младших разрядах. Следует отметить, что некоторые операции в ^ѵабсгірі 


1 Этот формат знаком программистам на языке ^ѵа как тип йсшЫе. Этот же формат ис¬ 
пользуется для представления чисел типа сІоиЫе в большинстве современных реализа¬ 
ций языков С и С++. 
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(такие как обращение к элементам массива по индексам и битовые операции, 
описываемые в главе 4) выполняются с 32-разрядными целыми значениями. 

Число, находящееся непосредственно в программе на языке ^ѵаЗсгірі, называ : 
ется числовым литералом . ^ѵаЗсгірі поддерживает числовые литералы не¬ 
скольких форматов, описанных в последующих разделах. Обратите внимание, 
что любому числовому литералу может предшествовать знак «минус» (-), делаю¬ 
щий числа отрицательными. Однако фактически минус представляет собой унар¬ 
ный оператор смены знака (см. главу 4), не являющийся частью синтаксиса чи¬ 
словых литералов. 

3.1.1. Целые литералы 

В ^ѵаЗсгірі целые десятичные числа записываются как последовательность 
цифр. Например: 

О 

3 

10000000 

Помимо десятичных целых литералов ^ѵаЗсгірі распознает шестнадцатерич¬ 
ные значения (по основанию 16). Шестнадцатеричные литералы начинаются 
с последовательности символов «Ох» или «ОХ», за которой следует строка шестна¬ 
дцатеричных цифр. Шестнадцатеричная цифра - это одна из цифр от 0 до 9 или 
букв от а (или А) до і (или Г), представляющих значения от 10 до 15. Ниже приво¬ 
дятся примеры шестнадцатеричных целых литералов: 

ОхГГ // 15*16 + 15 = 255 (по основанию 10) 

ОхСАРЕЭІІ 

Хотя стандарт ЕСМАЗсгірі не поддерживает представление целых литералов 
в восьмеричном формате (по основанию 8), некоторые реализации ^ѵабсгірі до¬ 
пускают подобную возможность. Восьмеричный литерал начинается с цифры О, 
за которой могут следовать цифры от 0 до 7. Например: 

0377 // 3*64 + 7*8 + 7 = 255 (по основанию 10) 

Поскольку некоторые реализации поддерживают восьмеричные литералы, а не¬ 
которые нет, никогда не следует писать целый литерал с ведущим нулем, ибо 
нельзя сказать наверняка, как он будет интерпретирован данной реализацией - 
как восьмеричное число или как десятичное. В строгом (зігісі) режиме, опреде¬ 
ляемом стандартом ЕСМАЗсгірі 5 (раздел 5.7.3), восьмеричные литералы явно 
запрещены. 

3.1.2. Литералы вещественных чисел 

Литералы вещественных чисел должны иметь десятичную точку - при определе¬ 
нии таких литералов используется традиционный синтаксис вещественных чи¬ 
сел. Вещественное значение представляется как целая часть числа, за которой 
следуют десятичная точка и дробная часть числа. 

Литералы вещественных чисел могут также представляться в экспоненциальной 
нотации: вещественное число, за которым следует буква е (или Е), а затем необя¬ 
зательный знак плюс или минус и целая экспонента. Такая форма записи обозна- 




3.1. Числа 


53 


чает вещественное число, умноженное на 10 в степени, определяемой значением 
экспоненты. 

Ниже приводится более лаконичное определение синтаксиса: 

[ цифры ][. цифры ][(Е|е)[(+|-)] цифры] 

Например: 

3.14 

2345.789 

.333333333333333333 

6.02е23 // 6.02 х 10 ?3 

1.4738223Е-32 // 1.4738223 х ІО 3 ' 


3.1.3. Арифметические операции в іаѵаБсгірІ 


Обработка чисел в языке ЛѵаЗсгірі выполняется с помощью арифметических 
операторов. В число таких операторов входят: оператор сложения +, оператор вы¬ 
читания -, оператор умножения *, оператор деления / и оператор деления по моду¬ 
лю % (возвращает остаток от деления). Полное описание этих и других операторов 
можно найти в главе 4. 

Помимо этих простых арифметических операторов ^ѵаЗсгірі поддерживает бо¬ 
лее сложные математические операции, с помощью функций и констант, доступ¬ 
ных в виде свойств объекта Маіііі: 


МаІІі. роѵ/( 2, 53) 

МаІИ . гоііпсК .6) 

Ма1:И. сеіі(. 6) 

МаІН. Иоог(. 6) 

МаІІі. аЬз(-5) 

МаІП. тах(х, у, г) 

МаІН. тіп(х, у, т.) 

МаІН. гапсІот() 

МаІН.РІ 
МаІН. Е 

Ма1:Н. зцПСЗ) 

МаІН. ро\ѵ(3, 1/3) 

МаІИ.зіп(0) 

МаІН.Іод(10) 

МаІИ. 1од(100)/Ма1:И. ЬЫЮ 
МаІН. Іод(512)/Ма1:И. ІН2 
МаІН.ехр(З) 


// => 9007199254740992: 2 в степени 53 
// => 1.0: округление до ближайшего целого 
// => 1.0: округление вверх 
// => 0.0: округление вниз 
// => 5: абсолютное значение 
// Возвращает наибольший аргумент 
// Возвращает наименьший аргумент 
// Псевдослучайное число х, где 0 <= х < 1.0 
// я: длина окружности / диаметр 
// е: Основание натурального логарифма 
// Корень квадратный из 3 
// Корень кубический из 3 

// Тригонометрия: имеются также МаТП.соз, МаТП.аТап и другие. 

// Натуральный логарифм 10 

// Логарифм 100 по основанию 10 (десятичный) 

// Логарифм 512 по основанию 2 
// МаТН.Е в кубе 


Полный перечень всех математических функций, поддерживаемых языком ^ѵа- 
Зсгірі, можно найти в справочном разделе с описанием объекта МаТП. 

Арифметические операции в ^ѵаЗсгірі не возбуждают ошибку в случае перепол¬ 
нения, потери значащих разрядов или деления на ноль. Если результат ариф¬ 
метической операции окажется больше самого большого представимого значе¬ 
ния (переполнение), возвращается специальное значение «бесконечность», кото¬ 
рое в ^ѵаЗсгірі обозначается как ІпТіпіІіу. Аналогично, если абсолютное значе¬ 
ние отрицательного результата окажется больше самого большого представимого 
значения, возвращается значение «отрицательная бесконечность», которое обо¬ 
значается как -ІггГіпіііу. Эти специальные значения, обозначающие бесконеч- 
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ность, ведут себя именно так, как и следовало ожидать: сложение, вычитание, 
умножение или деление бесконечности на любое значение дают в результате бес¬ 
конечность (возможно, с обратным знаком). 

Потеря значащих разрядов происходит, когда результат арифметической опера¬ 
ции оказывается ближе к нулю, чем минимально возможное значение. В этом 
случае возвращается число 0. Если потеря значащих разрядов происходит в от¬ 
рицательном результате, возвращается специальное значение, известное как «от¬ 
рицательный ноль». Это специальное значение практически ничем не отличается 
от обычного нуля, и у программистов на ^ѵаЗсгірі редко возникает необходи¬ 
мость выделять его. 

Деление на ноль не считается ошибкой в ^ѵаЗсгірі: в этом случае просто возвра¬ 
щается бесконечность или отрицательная бесконечность. Однако есть одно ис¬ 
ключение: операция деления нуля на ноль не имеет четко определенного значе¬ 
ния, поэтому в качестве результата такой операции возвращается специальное 
значение «не число» (поі-а-питЪег), которое обозначается как №М. Значение 
возвращается также при попытке разделить бесконечность на бесконечность, из¬ 
влечь квадратный корень из отрицательного числа или выполнить арифметиче¬ 
скую операцию с нечисловыми операндами, которые не могут быть преобразова¬ 
ны в числа. 

В ^ѵабсгірі имеются предопределенные глобальные переменные ІпГіпіІіуи №N1, 
хранящие значения положительной бесконечности и «не число». В стандарте 
ЕСМАЗсгірі 3 эти переменные доступны для чтения/записи и могут изменяться 
в программах. Стандарт ЕСМАЗсгірі 5 исправляет эту оплошность и требует, 
чтобы эти переменные были доступны только для чтения. Объект ИишЬег предос¬ 
тавляет альтернативные представления некоторых значений, доступные только 
для чтения даже в ЕСМАЗсгірі 3. Например: 


ІпРіпіГу 

ЫитЬег. Р05ІТІѴЕ_ІМРІМІТѴ 
1/0 

МитЬег. МАХ_ѴАІ_ІІЕ + 1 

МцтЬег. МЕ6АТІѴЕ_ІМРШТѴ 

-ІпГіпіІу 

- 1/0 

-МитЬег. МАХ_ѴАШЕ - 1 


// Переменная, доступная для чтения/записи, 

// инициализированная значением ІпГіпііу. 

// То же значение, доступное только для чтения. 
// То же самое значение. 

// Это выражение также возвращает ІпГіпіІіу. 

// Возвращают отрицательную бесконечность. 


ИаИ 

МытЬег.ИаИ 
0/0 

МитЬег. МІМ_ѴАЮЕ/2 
-МитЬег. МІМ.ѴАЮЕ/2 
-1/ІпГіпііу 
-0 


// Переменная, доступная для чтения/записи, 

// инициализированная значением №М. 

// Свойство, доступное только для чтения, с тем же значением. 
// Возвращает №М. 

// Потеря значащих разрядов: возвращает 0 
// Отрицательный ноль 
// Также отрицательный ноль 


Значение «не число» в ^ѵаЗсгірі обладает одной необычной особенностью: опера¬ 
ция проверки на равенство всегда возвращает отрицательный результат, даже ес¬ 
ли сравнить его с самим собой. Это означает, что нельзя использовать проверку 
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х == №N1, чтобы определить, является значение переменной х значением №М. Вме¬ 
сто этого следует выполнять проверку х != х. Эта проверка вернет Іігие тогда 
и только тогда, когда х имеет значение №М. Аналогичную проверку можно выпол¬ 
нить с помощью функции і$МаМ(). Она возвращает Іігие, если аргумент имеет зна¬ 
чение или если аргумент является нечисловым значением, таким как строка 
или объект. Родственная функция ізРіпіііеО возвращает Іігие, если аргумент яв¬ 
ляется числом, отличным от №N1, ІгѵГіпіІіу или -ІгѵГіпіІіу. 

Отрицательный ноль также имеет свои характерные особенности. В операциях 
сравнения (даже в операции строгой проверки на равенство) он признается рав¬ 
ным положительному нулю, что делает эти два значения практически неотличи¬ 
мыми, за исключением случаев, когда они выступают в роли делителей: 

ѵаг іего = 0; // Обычный ноль 

ѵаг педі = -0; // Отрицательный ноль 

2 его === педі // => Іігие: ноль и отрицательный ноль равны 
1/іего === 1/пед г // => "Гаізе : ІпРіпіІу и -ІпРіпіІу не равны 


3.1.4. Двоичное представление вещественных чисел 
и ошибки округления 


Вещественных чисел существует бесконечно много, но формат представления ве¬ 
щественных чисел в ^ѵаЗсгірі позволяет точно выразить лишь ограниченное их 
количество (точнее, 18437736874454810627). Это значит, что при работе с веще¬ 
ственными числами в ^ѵаЗсгірі представление числа часто будет являться ок¬ 
руглением фактического числа. 

Стандарт представления вещественных чисел ІЕЕЕ-754, используемый в ^ѵа- 
Зсгірі (и практически во всех других современных языках программирования), оп¬ 
ределяет двоичный формат их представления, который может обеспечить точное 
представление таких дробных значений, как 1/2, 1/8 и 1/1024. К сожалению, чаще 
всего мы пользуемся десятичными дробями (особенно при выполнении финансо¬ 
вых расчетов), такими как 1/10,1/100 и т. д. Двоичное представление вещественных 
чисел неспособно обеспечить точное представление таких простых чисел, как 0.1. 

Точность представления вещественных чисел в ^ѵаЗсгірі достаточно высока и по¬ 
зволяет обеспечить очень близкое представление числа 0.1. Но тот факт, что это 
число не может быть представлено точно, может приводить к проблемам. Взгля¬ 
ните на следующий фрагмент: 


ѵаг х = .3 - .2; 
ѵаг у = .2 - . 1; 
х == У 
х == .1 
У == .1 


// тридцать копеек минус двадцать копеек 
// двадцать копеек минус 10 копеек 
// => 1"а1зе: получились два разных значения! 
// => 1"а1зе: .3-.2 не равно .1 
// => Іігие: .2-. 1 равно . 1 


Из-за ошибок округления разность между аппроксимациями чисел .3 и .2 оказа¬ 
лась не равной разности между аппроксимациями чисел .2 и .1. Важно понимать, 
что эта проблема не является чем-то характерным для ЛѵаЗсгірі: она проявляет¬ 
ся во всех языках программирования, где используется двоичное представление 
вещественных чисел. Кроме того, обратите внимание, что значения х и у в приме¬ 
ре выше очень близки друг к другу и к истинному значению. Точность округления 
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вполне приемлема для большинства применений: проблема возникает лишь при 
попытках проверить значения на равенство. 

В будущих версиях ^ѵабсгірі может появиться поддержка десятичных чисел^ 
лишенная описанных недостатков, связанных с округлением. Но до тех пор для 
важных финансовых расчетов предпочтительнее будет использовать масштаби¬ 
руемые целые числа. Например, финансовые расчеты можно производить в ко¬ 
пейках, а не в долях рублей. 


3.1.5. Дата и время 

В базовом языке ^ѵаЗсгірі имеется конструктор 0а1:е() для создания объектов, 
представляющих дату и время. Эти объекты Эаііе обладают методами для выпол¬ 
нения простых вычислений с участием дат. Объект Эаііе не является фундамен¬ 
тальным типом данных, как числа. Этот раздел представляет собой краткое посо¬ 
бие по работе с датами. Полное описание можно найти в справочном разделе: 


ѵаг іііеп = пем 0а1е( 2010, 0, 1); 

ѵаг Іаіег = пем 0а1:е(2010, 0, 1, 17, 10, 30); 

ѵаг пом = пем 0а1е(); 

ѵаг еіарзесі = пом - ІГіеп; 

1аіег.де1:Ри11Ѵеаг() 

ІаІег.деііМопІіІіО 
ІаІег.деЮаІіеО 
ІаІег.деЮауО 
Іаіег.деІНоіігзО 
Іаіег. деЮТСНои гз() 

Іаіег.ІоЗІгіпд() 

ІаІег.ІоІЯСЗІгіпдС) 

Іаіег. ІоІосаІеОаІіеЗІ: гіпд() 
1аІег.і:оІ_оса1еТіте51:гіпд() 

Іаііег. ІОІ3081: гіпд() 


// Первый день первого месяца 2010 года 
// Та же дата, в 17:10:30 локального времени 
// Текущие дата и время 
// Разность дат: интервал в миллисекундах 

// => 2010 

// => 0: счет месяцев начинается с нуля 
// => 1: счет дней начинается с единицы 
// => 5: день недели. 0 - воскр., 5 - пяти. 
// => 17: 17 часов локального времени 
// часы по ІЯС; зависит от часового пояса 
// => "Ргі Зап 01 2010 17:10:30 6МТ+0300" 

// => "Ргі, 01 Лап 2010 14:10:30 СМТ" 

// => "1 Январь 2010 г." 

// => "17:10:30" 

// => "2010-01-01Т14:10:30.0002" 


3.2. Текст 

Строка - это неизменяемая, упорядоченная последовательность 16-битных зна¬ 
чений, каждое из которых обычно представляет символ Юникода. Строки в ^ѵа- 
Зсгірі являются типом данных, используемым для представления текста. Длина 
строки - это количество 16-битных значений, содержащихся в ней. Нумерация 
символов в строках (и элементов в массивах) в языке ^ѵаЗсгірі начинается с ну¬ 
ля: первое 16-битное значение находится в позиции 0, второе - в позиции 1 и т. д. 
Пустая строка - это строка, длина которой равна 0. В языке ЛѵаЗсгірі нет спе¬ 
циального типа для представления единственного элемента строки. Для пред¬ 
ставления единственного 16-битного значения просто используется строка с дли¬ 
ной, равной 1. 

3.2.1. Строковые литералы 

Чтобы включить литерал строки в ^ѵаЗсгірі-программу, достаточно просто за¬ 
ключить символы строки в парные одинарные или двойные кавычки (' или "). 
Символы двойных кавычек могут содержаться в строках, ограниченных симво- 
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лами одинарных кавычек, а символы одинарных кавычек - в строках, ограни¬ 
ченных символами двойных кавычек. Ниже приводятся несколько примеров 
строковых литералов: 

// Это пустая строка: в ней ноль символов 

' Іезііпд ' 

”3.14” 

, пате="ту1 : огт"' 

"Вы предпочитаете книги издательства О'ВеіПу, не правда ли?" 

"В этом строковом литерале\пдве строки” 

"71 - это отношение длины окружности к ее диаметру" 

В ЕСМАЗсгірі 3 строковые литералы должны записываться в одной строке про¬ 
граммы и не могут разбиваться на две строки. Однако в ЕСМАЗсгірі 5 строковые 
литералы можно разбивать на несколько строк, заканчивая каждую строку, кро¬ 
ме последней, символом обратного слэша (\). Ни один из символов обратного слэ¬ 
ша, как и следующие за ними символы перевода строки, не будут включены 
в строковый литерал. Чтобы включить в строковый литерал символ перевода стро¬ 
ки, следует использовать последовательность символов \п (описывается ниже): 

"две\пстроки" // Строковый литерал, представляющий две строки 
"одна\ // Одна строка, записанная в трех строках. Только в ЕСМАЗсгірІ: 5 

длинная\ 
строка" 


Символы, кодовые пункты и строки .ІаѵаБсгірі 

Для представления символов Юникода в языке ^ѵаЗсгірі используется 
кодировка ЦТЕ-16, а строки ^ѵаЗсгірі являются последовательностями 
16-битных значений без знака. Большинство наиболее часто используемых 
символов Юникода (из «основной многоязыковой матрицы») имеют кодо¬ 
вые пункты, умещающиеся в 16 бит, и могут быть представлены единст¬ 
венным элементом строки. Символы Юникода, кодовые пункты которых 
не умещаются в 16 бит, кодируются в соответствии с правилами кодировки 
ЦТЕ-16 как последовательности (известные как «суррогатные пары») из 
двух 16-битных значений. Это означает, что строка ^ѵаЗсгірі, имеющая 
длину, равную 2 (два 16-битных значения), может представлять единствен¬ 
ный символ Юникода: 

ѵаг Р = "71”: // 7С - это 1 символ с 16-битным кодовым пунктом ОхОЗсО 
ѵаг е = "е”; // е - это 1 символ с 17-битным кодовым пунктом 0x16452 
р.іепдііб // => 1: р содержит единственный 16-битный элемент 
е.іепдіб // => 2: в кодировке ІІТР-16 символ е определяется двумя 
// 16-битными значениями: "\іісІ835\исІс52" 

Различные строковые методы, имеющиеся в языке ЛѵаЗсгірі, манипули¬ 
руют 16-битными значениями, а не символами. Они не предусматривают 
возможность специальной интерпретации суррогатных пар, не выполняют 
нормализацию строк и даже не проверяют, является ли строка последова¬ 
тельностью символов в кодировке ЦТЕ-16. 
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Обратите внимание, что, ограничивая строку одинарными кавычками, необхо¬ 
димо проявлять осторожность в обращении с апострофами, употребляемыми 
в английском языке для обозначения притяжательного падежа и в сокращениях; 
как, например, в словах «сапЧ» и «О’КеіИу’в». Поскольку апостроф и одиночная 
кавычка - это одно и то же, необходимо при помощи символа обратного слэша (\) 
«экранировать» апострофы, расположенные внутри одиночных кавычек (подроб¬ 
нее об этом - в следующем разделе). 

Программы на клиентском ЛѵаЗсгірі часто содержат строки НТМЬ-кода, а НТМЬ- 
код, в свою очередь, часто содержит строки ^ѵа8сгірі-кода. Как и в ^ѵаЗсгірі, 
в языке НТМЬ для ограничения строк применяются либо одинарные, либо двой¬ 
ные кавычки. Поэтому при объединении ^ѵаЗсгірі- и НТМЬ-кода есть смысл 
придерживаться одного «стиля» кавычек для ^ѵаЗсгірі, а другого - для НТМЬ. 
В следующем примере строка «Спасибо» в ^ѵаЗсгірі-выражении заключена 
в одинарные кавычки, а само выражение, в свою очередь, заключено в двойные 
кавычки как значение НТМЬ-атрибута обработчика событий: 

<Ьи11:оп опс1іск=’*а1егі ('Спасибо' )">Щелкни на мне</Ьи11:оп> 

3.2.2. Управляющие последовательности 
в строковых литералах 

Символ обратного слэша (\) имеет специальное назначение в ^ѵаЗсгірі-строках. 
Вместе с символами, следующими за ним, он обозначает символ, не представи¬ 
мый внутри строки другими способами. Например, \п - это управляющая после¬ 
довательность (еесаре еедиепсе), обозначающая символ перевода строки. 

Другой пример, упомянутый выше, - это последовательность V, обозначающая 
символ одинарной кавычки. Эта управляющая последовательность необходима 
для включения символа одинарной кавычки в строковый литерал, заключенный 
в одинарные кавычки. Теперь становится понятно, почему мы называем эти после¬ 
довательности управляющими - здесь символ обратного слэша позволяет управ¬ 
лять интерпретацией символа одинарной кавычки. Вместо того чтобы отмечать 
ею конец строки, мы используем ее как апостроф: 

'ѴоіЛ'ге гідЫ:, іі сап\'1: Ье а дііоіе' 

В табл. 3.1 перечислены управляющие последовательности ^ѵаЗсгірі и обозна¬ 
чаемые ими символы. Две управляющие последовательности являются обобщен¬ 
ными; они могут применяться для представления любого символа путем указа¬ 
ния кода символа из набора ЬаІіп-1 или ЬГпісосіе в виде шестнадцатеричного чис¬ 
ла. Например, последовательность \хА9 обозначает символ копирайта, который 
в кодировке Ьаііп-1 имеет шестнадцатеричный код А9. Аналогично управляющая 
последовательность, начинающаяся с символов \и, обозначает произвольный 
символ Юникода, заданный четырьмя шестнадцатеричными цифрами. Напри¬ 
мер, \іЮЗсО обозначает символ п. 

Если символ «\» предшествует любому символу, отличному от приведенных 
в табл. 3.1, обратный слэш просто игнорируется (хотя будущие версии могут, ко¬ 
нечно, определять новые управляющие последовательности). Например, \# - это 
то же самое, что и #. Наконец, как отмечалось выше, стандарт ЕСМАЗсгірі 5 по¬ 
зволяет добавлять в многострочные строковые литералы символ обратного слэша 
перед разрывом строки. 
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Таблица 3.1. Управляющие последовательности За ѵаЗсгірі 


Последовательность 

Представляемый символ 

\о 

Символ ЬГОЬ (\и0000) 

\ь 

«Забой» (\ц0008) 

V 

Горизонтальная табуляция (\ы0009) 

\п 

Перевод строки (\и000А) 

\ѵ 

Вертикальная табуляция (\ц000В) 

V 

Перевод страницы (\и000С) 

V 

Возврат каретки (\и000й) 

V 

Двойная кавычка (\ы0022) 

V 

Одинарная кавычка (\и0027) 

\\ 

Обратный слэш (\и005С) 

\хХХ 

Символ Ьаііп-1, заданный двумя шестнадцатеричными цифрами XX 

\ихХХХХ 

Символ ТЛпсосІе, заданный четырьмя шестнадцатеричными цифра¬ 
ми хххх 


3.2.3. Работа со строками 

Одной из встроенных возможностей ^ѵаЗсгірі является способность конкатени¬ 
ровать строки. Если оператор + применяется к числам, они складываются, а если 
к строкам - они объединяются, при этом вторая строка добавляется в конец пер¬ 
вой. Например: 

тзд = "Неііо, " + "ѵгагісі"; // Получается строка "Неііо, ѵѵогІсГ 
дгееііпд = "Добро пожаловать на мою домашнюю страницу," + " " + пате; 

Для определения длины строки - количества содержащихся в ней 16-битных 
значений - используется свойство строки ІепдЮ. Например, длину строки з мож¬ 
но получить следующим образом: 

з. ІепдІН 


Кроме того, в дополнение к свойству ІепдЮ строки имеют множество методов (как 
обычно, более полную информацию ищите в справочном разделе): 


ѵаг з = "Неііо, могісі" 
з. сПагАІі(О) 
з. сіта гАІ (з. ІепдІН-1) 
з. зііЬзІгіпдО, 4) 
з.з1ісе(1.4) 
з.зІісе(-З) 
з. іпсІехОІТ'І") 
з. ІазІІпсІехОІ'С'І”) 
з. іпсІехО^С" 1", 3) 

з.зрИК". ") 
з. гер1асе("Н", "Н") 
з. 1оІІррегСазе() 


// Начнем с того же текста. 

// => "Н": первый символ. 

// => "(Г: последний символ. 

// => "еіі": 2-й, 3-й и 4-й символы. 

// => "еіі": то же самое 

// => "гісі": последние 3 символа 

// => 2: позиция первого символа 1. 

// => 10: позиция последнего символа 1. 

// => 3: позиция первого символа ”1", следующего 

// за 3 символом в строке 

// => ["Неііо", "могісі"] разбивает на подстроки 

// => "Неііо, ѵіо гісі : замещает все вхождения подстроки 

// => ”НЕІ_1_0, МОРЮ" 
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Не забывайте, что строки в ^ѵаЗсгірі являются неизменяемыми. Такие методы, 
как гер1асе() и 1:оІІррегСазе() возвращают новые строки: они не изменяют строку, 
относительно которой былй вызваны. 

В стандарте ЕСМАЗсгірі 5 строки могут интерпретироваться как массивы, дос¬ 
тупные только для чтения, и вместо использования метода сИагА1:( ) к отдельным 
символам (16-битным значениям) строки можно обращаться с помощью индексов 
в квадратных скобках: 

5 = "беііо, ѵгогІсГ; 
з[0] // => ■'И" 

з[з. Іепді; И— 1 ] // => "сі" 

Веб-броузеры, основанные на движке МогШа, такие как Еігеіох, уже давно пре¬ 
доставляют такую возможность. Большинство современных броузеров (замет¬ 
ным исключением из которых является ІЕ) последовали за Могіііа еще до того, 
как эта особенность была утверждена в стандарте ЕСМАЗсгірі 5. 

3.2.4. Сопоставление с шаблонами 

В языке ^ѵаВсгірі определен конструктор НедЕхрО, предназначенный для созда¬ 
ния объектов, представляющих текстовые шаблоны. Эти шаблоны описываются 
с помощью регулярных выражений , синтаксис которых был заимствован языком 
^ѵаВсгірі из языка Регі. И строки, и объекты ВедЕхр имеют методы, позволяю¬ 
щие выполнять операции сопоставления с шаблоном и поиска с заменой при по¬ 
мощи регулярных выражений. 

НедЕхр не относится к числу фундаментальных типов данных языка ^ѵаВсгірі. 
Подобно объектам Эаііе, они просто являются специализированной разновидно¬ 
стью объектов с удобным прикладным интерфейсом. Грамматика регулярных 
выражений и прикладной интерфейс отличаются повышенной сложностью. Они 
подробно описываются в главе 10. Однако поскольку объекты ВедЕхр обладают 
широкими возможностями и часто используются на практике, мы коротко по¬ 
знакомимся с ними в этом разделе. 

Несмотря на то что объекты ВедЕхр не относятся к фундаментальным типам дан¬ 
ных языка, они имеют синтаксис литералов и могут вставляться непосредствен¬ 
но в текст программы на языке ^ѵаЗсгірі. Текст, заключенный в пару символов 
слэша, интерпретируется как литерал регулярного выражения. За вторым сим¬ 
волом слэша из этой пары может следовать один или более символов, которые 
модифицируют поведение шаблона. Например: 

/~НТМ1_/ // Соответствует символам Н Т М 1_ в начале строки 

/[ 1-9][0-9]*/ // Соответствует цифре, кроме нуля, за которой следует любое число цифр 

/\ЬЗ аѵазсгір1\Ь/і // Соответствует подстроке "^ аѵавсгірі:” 

// как отдельному слову, учитывает регистр символов 

Объекты ВедЕхр обладают множеством полезных методов. Кроме того, строки так¬ 
же обладают методами, которые принимают объекты НедЕхр в виде аргументов. 
Например: 

ѵаг іехі = "ІезИгід : 1, 2, 3”; // Образец текста 

ѵаг раИегп = ДсІ+/9 // Соответствует всем вхождениям одной или более цифр 

раііегп. іезКіехі:) // => Ігие: имеется совпадение 

Іехі. зеагсбСраИегп) // => 9: позиция первого совпадения 
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Ііехі: . таіісіі ( раі:1:е гп) // => ["1", "2", "3"]: массив всех совпадений 

Ііехі: . гер1асе( раііііегп. // => "Ііезіііпд: 

Ііехі: . зрііі: (ДЭ+/); // => "1", "2", "3"]: разбить по нецифровым символам * 

3.3. Логические значения 

Логическое значение говорит об истинности или ложности чего-то. Логический 
тип данных имеет только два допустимых логических значения. Эти два значе¬ 
ния представлены литералами Ігие и І'аізе. 

Логические значения обычно представляют собой результат операций сравне¬ 
ния, выполняемых в ^ѵаЗсгірі-программах. Например: 

а == 4 

Это выражение проверяет, равно ли значение переменной а числу 4. Если да, ре¬ 
зультатом этого сравнения будет логическое значение Іігие. Если значение пере¬ 
менной а не равно 4, результатом сравнения будет І'аізе. 

Логические значения обычно используются в управляющих конструкциях ^ѵа- 
Зсгірі. Например, инструкция іѴеІзе в ^ѵаЗсгірі выполняет одно действие, если 
логическое значение равно Ігие, и другое действие, если 1"а1зе. Обычно сравнение, 
создающее логическое значение, непосредственно объединяется с инструкцией, 
в которой оно используется. Результат выглядит так: 

ІГ (а == 4) 

Ь = Ь + 1; 

еізе 

а = а + 1; 

Здесь выполняется проверка равенства значения переменной а числу 4. Если рав¬ 
но, к значению переменной Ь добавляется 1; в противном случае число 1 добавля¬ 
ется к значению переменной а. 

Как будет говориться в разделе 3.8, любое значение в языке ^ѵаЗсгірі может 
быть преобразовано в логическое значение. Следующие значения в результате та¬ 
кого преобразования дают логическое значение (и затем работают как) І'аізе: 

ішсІеГіпесІ 

пііП 

О 

-О 

// пустая строка 

Все остальные значения, включая все объекты (и массивы), при преобразовании 
дают в результате значение (и работают как) Ігие. Значение І'аізе и шесть значе¬ 
ний, которые при преобразовании приводятся к этому значению, иногда называ¬ 
ют ложными , а все остальные - истинными . В любом контексте, когда интерпре¬ 
татор ^ѵаЗсгірі ожидает получить логическое значение, ложные значения ин¬ 
терпретируются как 1"аІ5е, а истинные значения - как Іігие. 

В качестве примера предположим, что переменная о может хранить объект или 
значение пиіі. В этом случае можно явно проверить значение переменной о на не¬ 
равенство значению пиіі, как показано ниже: 
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ІГ (о !== піііі) 


Оператор «не равно» !== сравнит переменную о со значением піііі и вернет в ре¬ 
зультате Ігие или Гаізе. Однако вы можете опустить оператор сравнения и поло¬ 
житься на тот факт, что піііі является ложным значением, а объект - истинным: 

ІГ (о) ... 

В первом случае тело инструкции ІГ будет выполнено, только если значение пере¬ 
менной о не равно піііі. Во втором - ставится менее жесткое условие: тело инст¬ 
рукции ІГ будет выполнено, только если о не содержит Гаізе или другое ложное 
значение (такое как піііі или ипсІеГіпесІ). Какая инструкция ІГ больше подходит 
для вашей программы, зависит от того, какие значения могут присваиваться пе¬ 
ременной о. Если в программе необходимо отличать значение піііі от 0 и то сле¬ 
дует использовать явную операцию сравнения. 

Логические значения имеют метод ГоЗГгіпдО, который можно использовать для 
преобразования этих значений в строки «ігие» или «Іаізе», но они не имеют дру¬ 
гих полезных методов. Несмотря на простоту прикладного интерфейса, в языке 
имеется три важных логических оператора. 

Оператор && выполняет логическую операцию И. Он возвращает истинное значе¬ 
ние, только если оба операнда истинны - в противном случае он возвращает лож¬ 
ное значение. Оператор 11 выполняет логическую операцию ИЛИ: он возвращает 
истинное значение, если хотя бы один (или оба) из операндов является истинным, 
и ложное значение - если оба операнда являются ложными. Наконец, унарный 
оператор ! выполняет логическую операцию НЕ: он возвращает значение ігие для 
ложного операнда и Гаізе - для истинного. Например: 

ІГ ((х == 0 && у == 0) И !(2 == 0)) { 

// х и у содержат значение 0 или г не равна нулю 

} 

Полное описание этих операторов приводится в разделе 4.10. 

3.4. Значения пиІІ и ипсІеГіпесІ 

Ключевое слово піііі в языке ^ѵаЗсгірі имеет специальное назначение и обычно 
используется для обозначения отсутствия значения. Оператор ГуреоГ для значе¬ 
ния піііі возвращает строку «оЪ^есі», что говорит о том, что значение піііі являет¬ 
ся специальным «пустым» объектом. Однако на практике значение піііі обычно 
считается единственным членом собственного типа и может использоваться как 
признак отсутствия значения, такого как число, строка или объект. В большин¬ 
стве других языков программирования имеются значения, аналогичные значе¬ 
нию піііі в ^ѵаЗсгірі: вам они могут быть известны как піііі или піі. 

В языке ^ѵаЗсгірі имеется еще одно значение, свидетельствующее об отсутствии 
значения. Значение ипсІеГіпесІ, указывающее на полное отсутствие какого-либо 
значения. Оно возвращается при обращении к переменной, которой никогда не 
присваивалось значение, а также к несуществующему свойству объекта или 
элементу массива. Кроме того, значение ипсІеГіпесІ возвращается функциями, не 
имеющими возвращаемого значения, и присваивается параметрам функций для 
аргументов, которые не были переданы при вызове. Идентификатор ипсІеГіпесІ 
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является именем предопределенной глобальной переменной (а не ключевым сло¬ 
вом, как пиіі), которая инициализирована значением ипсІеГіпесІ. В ЕСМАЗсгірі 3 
ипсІеГіпесІ является переменной, доступной для чтения/записи, которой можно 
присвоить любое другое значение. Эта проблема была исправлена в ЕСМАЗсгірі 5, 
и в реализациях ^ѵаЗсгірі, соответствующих этому стандарту, переменная 
ипсІеГіпесІ доступна только для чтения. Оператор ГуреоГ для значения ипсІеГіпесІ 
возвращает строку «ипбеііпесі», показывающую, что данное значение является 
единственным членом специального типа. 

Несмотря на эти отличия, оба значения, пиіі и ипсІеГіпесІ, являются признаком от¬ 
сутствия значения и часто являются взаимозаменяемыми. Оператор равенства == 
считает их равными. (Чтобы отличать их в программе, можно использовать опера¬ 
тор идентичности ===.) Оба они являются ложными значениями - в логическом 
контексте они интерпретируются как значение Гаізе. Ни пиіі, ни ипсІеГіпесІ не име¬ 
ют каких-либо свойств или методов. На практике попытка использовать . или [], 
чтобы обратиться к свойству или методу этих значений, вызывает ошибку ТуреЕггог. 

Значение ипсІеГіпесІ можно рассматривать как признак неожиданного или ошибоч¬ 
ного отсутствия какого-либо значения, а пиіі - как признак обычного или вполне 
ожидаемого отсутствия значения. Если в программе потребуется присвоить одно 
из этих значений переменной или свойству или передать одно из этих значений 
функции, практически всегда предпочтительнее использовать значение пиіі. 

3.5. Глобальный объект 

В разделах выше описывались простые типы данных и значения языка ^ѵа- 
Зсгірі. Объектные типы - объекты, массивы и функции - описываются в отдель¬ 
ных главах, далее в книге. Но существует один важный объект, с которым необ¬ 
ходимо познакомиться сейчас. Глобальный объект - это обычный объект ^ѵа- 
Зсгірі, который играет очень важную роль: свойства этого объекта являются гло¬ 
бальными идентификаторами, доступными из любого места в программах на 
^ѵаЗсгірі. Когда выполняется запуск интерпретатора ^ѵаЗсгірі (или когда веб¬ 
броузер загружает новую страницу), создается новый глобальный объект, в кото¬ 
ром инициализируется начальный набор свойств, определяющих: 

• глобальные свойства, такие как ипсІеГіпесІ, ІпГіпіГу и №N1; 

• глобальные функции, такие как ізМаМО, рагзеІпГО (раздел 3.8.2) и еѵа1() (раз¬ 
дел 4.12); 

• функции-конструкторы, такие как ОаГе(), ВедЕхрО, ЗГгіпдО, 0Ь]есГ() и АггауО 
(раздел 3.8.2); 

• глобальные объекты, такие как Магіи и (раздел 6.9). 

Имена первоначально устанавливаемых свойств глобального объекта не являют¬ 
ся зарезервированными словами, но вы вполне можете считать их таковыми. Все 
эти свойства перечислены в разделе 2.4.1. Некоторые из глобальных свойств уже 
описывались в этой главе. Большинство других будут рассматриваться в разных 
разделах книги. Кроме того, их все можно отыскать по именам в справочном раз¬ 
деле по базовому ЛѵаЗсгірі или в описании самого глобального объекта, под име¬ 
нем «ОІоЬаІ». В клиентском ЛѵаЗсгірі имеется объект Іл/іпсісм, определяющий дру¬ 
гие глобальные свойства, описание которых можно найти в справочном разделе 
по клиентскому ЛѵаЗсгірі. 
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В программном коде верхнего уровня, т. е. в ^ѵа8сгірі-коде, который не являет¬ 
ся частью функции, сослаться на глобальный объект можно посредством ключе¬ 
вого слова ІМз: 

ѵаг дІоЬаІ = ІіИіз ; // Определить глобальную переменную для ссылки на глобальный объект 

В клиентском ^ѵаЗсгірі роль глобального объекта для всего ^аѵа8сгірі-кода, со¬ 
держащегося в соответствующем ему окне броузера, играет объект Іл/іпсісм. Этот гло¬ 
бальный объект имеет свойство міпсісж, ссылающееся на сам объект, которое мож¬ 
но использовать вместо ключевого слова ІіГііз для ссылки на глобальный объект. 
Объект Міпсіом определяет базовые глобальные свойства, а также дополнительные 
глобальные свойства, характерные для веб-броузеров и клиентского ^ѵаВсгірі. 

При создании в глобальном объекте определяются все предопределенные гло¬ 
бальные значения ^ѵаЗсгірі. Однако этот специальный объект может также хра¬ 
нить глобальные переменные программы. Если программа объявляет глобаль¬ 
ную переменную, она становится свойством глобального объекта. Подробнее этот 
механизм описывается в разделе 3.10.2. 

3.6. Объекты-обертки 

Объекты в языке ЛѵаЗсгірі являются составными значениями: они представля¬ 
ют собой коллекции свойств, или именованных значений. Обращение к свойст¬ 
вам мы будем выполнять с использованием точечной нотации. Свойства, значе¬ 
ниями которых являются функции, мы будем называть методами. Чтобы вы¬ 
звать метод т объекта о, следует использовать инструкцию о.т(). 

Мы уже видели, что строки обладают свойствами и методами: 

ѵаг 5 = " Иеііо ѵ/огісі!"; // Строка 

ѵаг ѵѵогсі = 5. зііЬзІ гіпд (з. іпсІехО'Г(’’ ")+1, з. ІепдііМ); // Использование свойств строки 

Однако строки не являются объектами, так почему же они обладают свойствами? 
Всякий раз когда в программе предпринимается попытка обратиться к свойству 
строки 5, интерпретатор ^ѵаЗсгірі преобразует строковое значение в объект, как 
если бы был выполнен вызов пем Зі:гіпд(5). Этот объект наследует (раздел 6.2.2) 
строковые методы и используется интерпретатором для доступа к свойствам. По¬ 
сле обращения к свойству вновь созданный объект уничтожается. (От реализа¬ 
ций не требуется фактически создавать и уничтожать этот промежуточный объ¬ 
ект, но они должны вести себя так, как если бы объект действительно создавался 
и уничтожался.) 

Наличие методов у числовых и логических значений объясняется теми же при¬ 
чинами: при обращении к какому-либо методу создается временный объект вызо¬ 
вом конструктора МитЬег() или Воо1еап(), после чего производится вызов метода 
этого объекта. Значения піііі и ипс!е1 = іпесІ не имеют объектов-оберток: любые по¬ 
пытки обратиться к свойствам этих значений будет вызывать ошибку Ту ре Е г го г. 

Рассмотрим следующий фрагмент и подумаем, что происходит при его выполне¬ 
нии: 

ѵаг з = "Ііезі: ”; // Начальное строковое значение. 

з.іеп = 4; // Установить его свойство. 

ѵаг 1: = з.іеп; // Теперь запросить значение свойства. 
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В начале этого фрагмента переменная 1: имеет значение ипсіеііпесі. Вторая строка 
создает временный объект Зігіпд, устанавливает его свойство Іеп равным 4 и за¬ 
тем уничтожает этот объект. Третья строка создает из оригинальной (неизменен¬ 
ной) строки новый объект Зіігіпд и пытается прочитать значение свойства Іеп. 
Строки не имеют данного свойства, поэтому выражение возвращает значение 
ипсІе'ГіпесІ. Данный фрагмент показывает, что при попытке прочитать значение 
какого-либо свойства (или вызвать метод) строки числа и логические значения 
ведут себя подобно объектам. Но если попытаться установить значение свойства, 
эта попытка будет просто проигнорирована: изменение затронет только времен¬ 
ный объект и не будет сохранено. 

Временные объекты, которые создаются при обращении к свойству строки, числа 
или логического значения, называются объектами-обертками , и иногда может 
потребоваться отличать строки от объектов Зіігіпд или числа и логические значе¬ 
ния от объектов МитЬегиВооІеап. Однако обычно объекты-обертки можно рассмат¬ 
ривать просто как особенность реализации и вообще не думать о них. Вам доста¬ 
точно будет знать, что строки, числа и логические значения отличаются от объек¬ 
тов тем, что их свойства доступны только для чтения и что вы не можете опреде¬ 
лять для них новые свойства. 

Обратите внимание, что существует возможность (но в этом почти никогда нет не¬ 
обходимости или смысла) явно создавать объекты-обертки вызовом конструктора 

ЗігіпдО, МитЬегО или Воо1еап(): 

ѵаг $ = "іезі:", п = 1. Ь = ігие; // Строка, чело и логическое значение, 

ѵаг 3 = пем ЗігіпдСз); // Объект Зігіпд 

ѵаг N = пем МіітЬег(п); // Объект І\ІитЬег 

ѵаг В = пем ВооІеап(Ь); // Объект Вооіеап 

При необходимости интерпретатор ^ѵаЗсгірі обычно автоматически преобразу¬ 
ет объекты-обертки, т. е. объекты 3, N и В в примере выше, в обертываемые ими 
простые значения, но они не всегда ведут себя точно так же, как значения 5, п и Ь. 
Оператор равенства == считает равными значения и соответствующие им объек¬ 
ты-обертки, но оператор идентичности === отличает их. Оператор Ііурео'Г также 
обнаруживает отличия между простыми значениями и их объектами-обертками. 

3.7. Неизменяемые простые значения 
и ссылки на изменяемые объекты 

Между простыми значениями (ипсІе'ГіпесІ, пиіі, логическими значениями, числами 
и строками) и объектами (включая массивы и функции) в языке ^ѵаЗсгірі име¬ 
ются фундаментальные отличия. Простые значения являются неизменяемыми: 
простое значение невозможно изменить (или «трансформировать»). Это очевидно 
для чисел и логических значений - нет никакого смысла изменять значение чис¬ 
ла. Однако для строк это менее очевидно. Поскольку строки являются массивами 
символов, вполне естественно было бы ожидать наличие возможности изменять 
символы в той или иной позиции в строке. В действительности ЛѵаВсгірі не по¬ 
зволяет сделать это, и все строковые методы, которые, на первый взгляд, возвра¬ 
щают измененную строку, на самом деле возвращают новое строковое значение. 
Например: 
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ѵаг $ = *’Ізеііо"; // Изначально имеется некоторый текст из строчных символов 
з. ГоИррегСазеС); // Вернет "НЕШГ, но значение з при этом не изменится 
з // =>» "Неііо" : оригинальная строка не изменилась 

Кроме того, величины простых типов сравниваются по значению : две величины 
считаются одинаковыми, если они имеют одно и то же значение. Для чисел, логи¬ 
ческих значений, пиіі и ипсІеТіпесІ это выглядит очевидным: нет никакого другого 
способа сравнить их. Однако для строк это утверждение не выглядит таким оче¬ 
видным. При сравнении двух строковых значений ЛѵаЗсгірі считает их одина¬ 
ковыми тогда и только тогда, когда они имеют одинаковую длину и содержат оди¬ 
наковые символы в соответствующих позициях. 

Объекты отличаются от простых типов. Во-первых, они являются изменяемы¬ 
ми — их значения можно изменять: 


ѵаг о = { х:1 }; 
о.х = 2; 
о.у = 3; 

ѵаг а = [1,2,3] 
а[0] = 0; 
а[3] = 4; 


// Начальное значение объекта 
// Изменить, изменив значение свойства 
// Изменить, добавив новое свойство 

// Массивы также являются изменяемыми объектами 
// Изменить значение элемента массив 
// Добавить новый элемент 


Объекты не сравниваются по значению: два объекта не считаются равными, даже 
если они будут иметь одинаковые наборы свойств с одинаковыми значениями. 
И два массива не считаются равными, даже если они имеют один и тот же набор 
элементов, следующих в том же порядке: 


ѵаг о = {х:1}, р = {х:1}; 
о === р 

ѵаг а = [], Ь = []; 
а === Ь 


// Два объекта с одинаковыми свойствами 

// => Гаізе: разные объекты не являются равными 

// Два различных пустых массива 

// => Гаізе: различные массивы не являются равными 


Чтобы подчеркнуть отличие от простых типов ^ѵаЗсгірі, объекты иногда назы¬ 
вают ссылочными типами. Если следовать этой терминологии, значениями объ¬ 
ектов являются ссылки , и можно сказать, что объекты сравниваются по ссылке: 
значения двух объектов считаются равными тогда и только тогда, когда они ссы¬ 
лаются на один и тот же объект в памяти. 


ѵаг а = []; 
ѵаг Ь = а; 
Ь[0] = 1; 
а[0] 
а === Ь 


// Переменная а ссылается на пустой массив. 

// Теперь Ь ссылается на тот же массив. 

// Изменение массива с помощью ссылки в переменной Ь. 

// => 1: изменение можно наблюдать в переменной а. 

// => Ггие: а и Ь ссылаются на один и тот же объект, поэтому они равны. 


Как следует из примера выше, операция присваивания объекта (или массива) пе¬ 
ременной фактически присваивает ссылку: она не создает новую копию объекта. 
Если в программе потребуется создать новую копию объекта или массива, необхо¬ 
димо будет явно скопировать свойства объекта или элементы массива. Следующий 
пример демонстрирует такое копирование с помощью цикла Гог (раздел 5.5.3): 

ѵага=['а , ,'Ь , ,'с’]; // Копируемый массив 

ѵаг Ь = []; // Массив, куда выполняется копирование 

Гог(ѵаг і = 0; і < а.ІепдГН; і++) { // Для каждого элемента в массиве а[] 

Ь[і] = а[і]; // Скопировать элемент а[] в Ь[] 


} 
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Точно так же, если потребуется сравнить два отдельных объекта или массива, не¬ 
обходимо будет сравнить значения их свойств или элементов. Ниже приводится 
определение функции, сравнивающей два массива: 

^ипсіііоп едиа1Аггауз(а. Ь) { 

іТ (а. ІепдТИ != Ь. ІепдііМ ) геііигп Гаізе; // Массивы разной длины не равны 
Гог(ѵаг і = 0; і < а.ІепдііМ; і++) // Цикл по всем элементам 

іТ (а[і] !== Ь[і]) геііигп ^аізе; // Если хоть один элемент 

// отличается, массивы не равны 
геііигп 1і гие ; // Иначе они равны 

} 

3.8. Преобразование типов 

^ѵаЗсгірі может гибко преобразовывать один тип в другой. Мы уже могли убе¬ 
диться в этом на примере логических значений: везде, где интерпретатор ^ѵа- 
8сгірі ожидает получить логическое значение, можно указать значение любого 
типа и ЛѵаЗсгірі автоматически выполнит необходимое преобразование. Одни 
значения («истинные» значения) преобразуются в значение Іігие, а другие («лож¬ 
ные») - в 1"аІ5е. То же относится и к другим типам: если интерпретатор ожидает 
получить строку, он автоматически преобразует любое другое значение в строку. 
Если интерпретатор ожидает получить число, он попробует преобразовать имею¬ 
щееся значение в число (в случае невозможности такого преобразования будет 
получено значение №М). Например: 

10 + " оЬіесііз" // => "10 оЬіесІіз". Число 10 преобразуется в строку 
"7" * "4" // => 28: обе строки преобразуются в числа 

ѵаг п = 1 - "х"; // => №І\І: строка "х" не может быть преобразована в число 
п + " оЬіесІіз" // => оЬіесІіз" : ИаИ преобразуется в строку "МаМ" 

В табл. 3.2 описывается, как в ^ѵаВсгірі выполняется преобразование значений из 
одного типа в другой. Жирным шрифтом в таблице выделены значения, соответст¬ 
вующие преобразованиям, которые могут преподносить сюрпризы. Пустые ячейки 
соответствуют ситуациям, когда преобразование не требуется и не выполняется. 

Преобразования одного простого типа в другой, показанные в табл. 3.2, выполня¬ 
ются относительно просто. Преобразование в логический тип уже обсуждалось 
в разделе 3.3. Преобразование всех простых типов в строку четко определено. Пре¬ 
образование в число выполняется немного сложнее. Строки, которые могут быть 
преобразованы в числа, преобразуются в числа. В строке допускается наличие 
пробельных символов в начале и в конце, но присутствие других непробельных 
символов, которые не могут быть частью числа, при преобразовании строки в чис¬ 
ло приводят к возврату значения №М. Некоторые особенности преобразования 
значений в числа могут показаться странными: значение Іігие преобразуется 
в число 1, а значение ^аізе и пустая строка "" преобразуются в 0. 

Преобразование простых типов в объекты также выполняется достаточно просто: 
значения простых типов преобразуются в соответствующие объекты-обертки 
(раздел 3.6), как если бы вызывался конструктор 31:гіпд(), МитЬег() или Воо1еап(). 

Исключение составляют значения пиіі и ипсІе'ГіпесІ: любая попытка использовать 
их в контексте, где требуется объект, вместо преобразования будет приводить 
к возбуждению исключения ТуреЕггог. 
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Преобразование объектов в простые типы выполняется значительно сложнее 
и является темой обсуждения раздела 3.8.3. 


Таблица 3.2. Преобразование типов в Ла ѵаЗсгірі 

I Преобразование в: 


Значение 

Строку 

Число 

Логическое 

значение 

Объект 

ипсІеГіпесІ 

"ипсІеГіпесІ" 

ИаИ 

Гаізе 

возбуждается ошиб¬ 
ка ТуреЕггог 

пиіі 

"пиіі" 

0 

Гаізе 

возбуждается ошиб¬ 
ка ТуреЕггог 

Ггие 

"Ггие" 

1 


пем ВооІеап(Ггие) 

Гаізе 

"Гаізе" 

0 


пем ВооІеап(ГаІзе) 

(пустая строка) 


0 

Гаізе 

пе\л/ ЗГгіпдС") 

"1.2" (непустая строка, число) 


1.2 

Ггие 

пе\л/ ЗГгіпдС’1.2") 

"опе" (не пустая строка, 
не число) 


ИаИ 

Ггие 

пе\л/ ЗГгіпдС'опе") 

0 

" 0 " 


Гаізе 

пе\л/ МитЬег(О) 

-0 

" 0 " 


Гаізе 

пе\л/ МитЬег(-О) 

МаМ 

"МаГ 


Гаізе 

пе\л/ МитЬег(№М) 

ІпГіпіГу 

"ІпГіпіГу" 


Ггие 

пе\л/ МитЬег(ІпГіпіГу) 

-ІпГіпіГу 

"-ІпГіпіГу" 


Ггие 

пе\л/ МитЬег(-ІпГіпіГу) 

1 (конечное, ненулевое) 

" 1 " 


Ггие 

пе\л/ ЫитЬе г(1 ) 

{} (любой объект) 

см.разд. 3.8.3 

см. раз¬ 
дел 3.8.3 

Ггие 


[] (пустой массив) 

.... 

0 

Ггие 


[9] (1 числовой элемент) 

"9" 

9 

Ггие 


[ а ] (любой другой массив) 

используется 
метод ;іоіп() 

ИаИ 

Ггие 


ГипсГіоп(){} (любая функция) 

см.разд. 3.8.3 

ИаИ 

Ггие 



3.8.1. Преобразования и равенство 

Благодаря гибкости преобразований типов в ^ѵаЗсгірі оператор равенства == 
также гибко определяет равенство значений. Например, все следующие сравне¬ 
ния возвращают Ггие: 

пиіі == ипсІеТіпесІ // Эти два значения считаются равными. 

"О" == 0 // Перед сравнением строка преобразуется в число. 

О == Гаізе // Перед сравнением логич. значение преобразуется в число. 

"О" == Гаізе // Перед сравнением оба операнда преобразуются в числа. 

В разделе 4.9.1 четко описывается, какие преобразования выполняет оператор ==, 
чтобы определить, являются ли два значения равными, и в этом же разделе опи¬ 
сывается оператор идентичности ===, который не выполняет никаких преобразо¬ 
ваний перед сравнением. 
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Имейте в виду, что возможность преобразования одного значения в другое не 
означает равенства этих двух значений. Если, например, в логическом контексте 
используется значение ипс!е1 = іпесІ, оно будет преобразовано в значение І'аізе. Но это 
не означает, что ипсіеі'іпесі == І'аізе. Операторы и инструкции ЛѵаВсгірі ожидают 
получить значения определенных типов и выполняют преобразования в эти ти¬ 
пы. Инструкция іТ преобразует значение ипсіеі'іпесі в І'аізе, но оператор == никогда 
не пытается преобразовать свои операнды в логические значения. 


3.8.2. Явные преобразования 

Несмотря на то что многие преобразования типов ЛѵаЗсгірі выполняет автома¬ 
тически, иногда может оказаться необходимым выполнить преобразование явно 
или окажется предпочтительным выполнить явное преобразование, чтобы обес¬ 
печить ясность программного кода. 

Простейший способ выполнить преобразование типа явно заключается в исполь¬ 
зовании функций Воо1еап(), МитЬег(), ЗТгіпдО и 0Ь]ес1:(). Мы уже видели, как эти 
функции используются в роли конструкторов объектов-оберток (раздел 3.6). При 
вызове без оператора п еѵі они действуют как функции преобразования и выполня¬ 
ют преобразования, перечисленные в табл. 3.2: 


МитЬегС'З") 
ЗіігіпдСШзе) 
Воо1еап([ ]) 
0Ь]ес1:(3) 


// => 3 

// => "Шзе" или можно использовать І^аізе. 1:о8і:гіпд( ) 

// => Іігііе 

// => пе\л/ МитЬег(З) 


Обратите внимание, что все значения, кроме піііі или ипсІе'ГіпесІ, имеют метод 
ІоЗіігіпдО, результатом которого обычно является то же значение, которое воз¬ 
вращается функцией ЗігіпдО. Кроме того, обратите внимание, что в табл. 3.2 от¬ 
мечается, что при попытке преобразовать значение піііі или ипсІе'ГіпесІ в объект 
возбуждается ошибка ТуреЕггог. Функция ОЬ^ есі( ) в этом случае не возбуждает 
исключение, вместо этого она просто возвращает новый пустой объект. 

Определенные операторы в языке ЛѵаЗсгірі неявно выполняют преобразования 
и иногда могут использоваться для преобразования типов. Если один из операн¬ 
дов оператора + является строкой, то другой операнд также преобразуется в стро¬ 
ку. Унарный оператор + преобразует свой операнд в число. А унарный оператор ! 
преобразует операнд в логическое значение и инвертирует его. Все это стало при¬ 
чиной появления следующих своеобразных способов преобразования типов, ко¬ 
торые можно встретить на практике: 

х + "" // То же, что и Зіігіпд(х) 

+х // То же, что и І\ІитЬег(х). Можно также встретить х-0 

!!х //То же, что и Вооіеап(х). Обратите внимание на два знака ! 


Форматирование и парсинг чисел являются наиболее типичными задачами, ре¬ 
шаемыми компьютерными программами, и потому в ЛѵаЗсгірі имеются специа¬ 
лизированные функции и методы, обеспечивающие более полный контроль над 
преобразованиями чисел в строки и строк в числа. 

Метод ЩЗІгіпдО класса МитЬег принимает необязательный аргумент, определяю¬ 
щий основание системы счисления для преобразования. Если этот аргумент не 
определен, преобразование выполняется в десятичной системе счисления. Но вы 
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можете производить преобразование в любой системе счисления (с основанием от 
2 до 36). Например: 

ѵаг п = 17; 

Ьіпагу_5І:гіпд = п. ІіоЗі:гіпд (2); // Вернет "10001" 

ос1:а1_з1:гіпд = "О" + п.Ю81гіпд(8); // Вернет "021" 

Мех_з1: гіпд = "Ох" + п. І031:гіпд (16); // Вернет "0x11" 


При выполнении финансовых или научных расчетов может потребоваться обеспе¬ 
чить преобразование чисел в строки с точностью до определенного числа десятич¬ 
ных знаков или до определенного количества значащих разрядов или получать 
представление чисел в экспоненциальной форме. Для подобных преобразований 
чисел в строки класс МитЬег определяет три метода. Метод ІоРіхесК) преобразует 
число в строку, позволяя указывать количество десятичных цифр после запятой. 
Он никогда не возвращает строки с экспоненциальным представлением чисел. 
Метод 1:оЕхропеп1:іа1( ) преобразует число в строку в экспоненциальном представле¬ 
нии, когда перед запятой находится единственный знак, а после запятой следует 
указанное количество цифр (т. е. количество значащих цифр в строке получается 
на одну больше, чем было указано при вызове метода). Метод 1юРгесізіоп() преоб¬ 
разует число в строку, учитывая количество заданных значащих разрядов. Если 
заданное количество значащих разрядов оказывается недостаточным для отобра¬ 
жения всей целой части числа, преобразование выполняется в экспоненциальной 
форме. Обратите внимание, что все три метода округляют последние цифры или 
добавляют нули, если это необходимо. Взгляните на следующие примеры: 


ѵаг п = 123456.789; 
п. ІіоРіхесІ (0); 
п. ІіоРіхесІ (2); 
п. 1:оРіхес1(5); 
п. ІіоЕхропепіііаІ (1); 
п. ІіоЕхропепіііаІ (3); 
п. 1:оРгесі5іоп(4); 
п. 1:оРгесі5іоп(7); 
п. ІіоРгесізіоп (10); 


// ”123457" 

// "123456.79" 

// "123456.78900" 
Ц "1.2е+5" 

// "1.235е+5" 

// "1.235е+5" 

// "123456.8" 

// "123456.7890" 


Если передать строку функции преобразования МитЬег(), она попытается разобрать 
эту строку как литерал целого или вещественного числа. Эта функция работает 
только с десятичными целыми числами и не допускает наличие в строке завер¬ 
шающих символов, не являющихся частью литерала числа. Функции рагзеІп1:() 
и рагзеР1оа1:() (это глобальные функции, а не методы какого-либо класса) являются 
более гибкими. Функция рагзеІп1:() анализирует только целые числа, тогда как 
функция рагзеР1оа1:() позволяет анализировать строки, представляющие и це¬ 
лые, и вещественные числа. Если строка начинается с последовательности «Ох» 
или «ОХ», функция рагзеІп1:() интерпретирует ее как представление шестнадца¬ 
теричного числа. 1 Обе функции, рагзеІп1:() и рагзеР1оа1:(), пропускают начальные 


1 Согласно стандарту ЕСМАЗсгірі 3 функция рагзеІп1;( ) может выполнять преобразова¬ 
ние строки, начинающейся с символа «О» (но не «Ох» или «ОХ»), в восьмеричное или 
десятичное число. Поскольку поведение функции четко не определено, следует избе¬ 
гать использования функции рагзеІпі:( ) для интерпретации строк, начинающихся с «О», 
или явно указывать основание системы счисления! В ЕСМАЗсгірі 5 функция рагзеІпІіО 
будет интерпретировать строки как восьмеричные числа, только если ей во втором ар¬ 
гументе явно указать основание 8 системы счисления. 
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пробельные символы, пытаются разобрать максимально возможное количество 
символов числа и игнорируют все, что следует за ними. Если первый непробель¬ 
ный символ строки не является частью допустимого числового литерала, эти 
функции возвращают значение №N1: 


рагзеІгѵЬ("3 ЬІіпсІ тісе”) 

// => 3 

рагзеР1оа1:(" 3.14 теііегз") //■=> 3.14 

рагзеІгѵЬ("-12.34") 

// => -12 

рагзеІгѵЬ("ОхРР") 

// => 255 

рагзеІШіС'ОхРР") 

// => 255 

ра гзеіпі: ("-0ХРР") 

// => -255 

рагзеР1оа*(".1") 

// => 0.1 

рагзеІггЬ("0. V) 

// => 0 

рагзеіпі: (". 1") 

// => N811: 

рагзеР1оа*("$72.47"); 

// => МаМ: 


целые числа не могут начинаться с 
числа не могут начинаться с "$" 


Функция рагзеІпіО принимает второй необязательный аргумент, определяющий 
основание системы счисления для разбираемого числа. Допустимыми являются 
значения от 2 до 36. Например: 


рагзеІгѵЬС’ІІ", 2); 
рагзеІпі:("1Т', 16); 
рагзеІпІіС'гг" , 36); 
ра гзеіпі: ("077”. 8); 
рагзеІгѵЬ("077", 10); 


// => 3 ( 1*2 + 1 ) 

// => 255 (15*16 + 15) 
// => 1295 (35*36 + 35) 
// => 63 (7*8 + 7) 

// => 77 (7*10 + 7) 


3.8.3. Преобразование объектов в простые значения 

Преобразование объектов в логические значения выполняется очень просто: все 
объекты (включая массивы и функции) преобразуются в значение ігие. Это спра¬ 
ведливо и для объектов-оберток: результатом вызова пем Вооіеап(^аізе) является 
объект, а не простое значение, поэтому он также преобразуется в значение ігие. 

Преобразование объекта в строку и преобразование объекта в число выполняется 
вызовом соответствующего метода объекта. Все осложняется тем, что объекты 
в языке ^ѵаВсгірІ имеют два разных метода для выполнения преобразований, 
а также наличием нескольких специальных случаев, описываемых ниже. Обра¬ 
тите внимание, что правила преобразования объектов в строки и числа, описы¬ 
ваемые здесь, применяются только к объектам самого языка Лѵабсгірі. Объекты 
среды выполнения (например, определяемые веб-броузерами) могут предусмат¬ 
ривать собственные алгоритмы преобразования в числа и строки. 

Все объекты наследуют два метода преобразования. Первый из них называется 
1:о5і:гіпд( ), он возвращает строковое представление объекта. По умолчанию метод 
ІіоЗі:гіпд( ) не возвращает ничего особенно интересного (хотя эта информация ино¬ 
гда может оказаться полезной, как будет показано в примере 6.4): 

({х:1, у:2}). Іо31:гіпд( ) // => "[оЬіесЬ ОЬіесЬ]" 

Многие классы определяют более специализированные версии метода ІоЗігіпдО. 
Например, метод 1:о5і:гіпд( ) класса Аггау преобразует все элементы массива в стро¬ 
ки и объединяет результаты в одну строку, вставляя запятые между ними. Метод 
ІоЗігіпдО класса Рипсііоп возвращает строковое представление функции, завися¬ 
щее от реализации. На практике обычно реализации преобразуют пользователь¬ 
ские функции в строки с исходным программным кодом на языке ^ѵаВсгірі. 
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Класс Эаііе определяет метод і:о51:гіпд( ), возвращающий строку с датой и временем 
в удобочитаемом формате (который может быть разобран средствами Лѵа8сгірі). 
Класс ВедЕхр определяет метод і:о51:гіпд( ), преобразующий объект ВедЕхр в строку? 
которая выглядит как литерал регулярного выражения: 


[1,2,3]. 1:о31:гіпд() 

( Типсіііоп(х) { Т(х); }). ГоЗі:гіпд( ) 

/\сі+/д . И 08 И гіпд( ) 

пем 0 а 1 :е( 2010 , 0 , 1 ). ІюЗІ: гіпд () 


// => "1.2,3" 

// => "ГітсЬіоп(х) {\п Т(х);\п}" 

// => "А\сі+/д" 

// => "Ргі Лап 01 2010 00:00:00 0МТ+0300" 


Другая функция преобразования объектов называется ѵа1ие0Г(). Задача этого ме¬ 
тода определена не так четко: предполагается, что он должен преобразовать объ¬ 
ект в представляющее его простое значение, если такое значение существует. Объ¬ 
екты по своей природе являются составными значениями, и большинство объек¬ 
тов не могут быть представлены в виде единственного простого значения, поэтому 
по умолчанию метод ѵа1ие0Г() возвращает не простое значение, а сам объект. Клас¬ 
сы-обертки определяют методы ѵаІиеОГО, возвращающие обернутые простые зна¬ 
чения. Массивы, функции и регулярные выражения наследуют метод по умолча¬ 
нию. Вызов метода ѵаІиеОГО экземпляров этих типов возвращает сам объект. 
Класс Эаііе определяет метод ѵаІиеОГО, возвращающий дату во внутреннем пред¬ 
ставлении: количество миллисекунд, прошедших с 1 января 1970 года: 

ѵаг сі = пем 0а1:е(2010, 0, 1): //1 января 2010 года, (время Московское) 

Р. ѵаІиеОГО // => 1262293200000 


Теперь, разобравшись с методами ІоЗігіпдО и ѵаІиеОГО, можно перейти к обсуж¬ 
дению особенностей преобразования объектов в строки и в числа. Учтите, что су¬ 
ществует несколько специальных случаев, когда ^ѵабсгірі выполняет преобра¬ 
зование объектов в простые значения несколько иначе. Эти особые случаи рас¬ 
сматриваются в конце данного раздела. 

Преобразование объектов в строку интерпретатор ^ѵабсгірі выполняет в два 
этапа: 

• Если объект имеет метод 1:о5і:гіпд( ), интерпретатор вызывает его. Если он воз¬ 
вращает простое значение, интерпретатор преобразует значение в строку (если 
оно не является строкой) и возвращает результат преобразования. Обратите 
внимание, что правила преобразований простых значений в строку четко оп¬ 
ределены для всех типов и перечислены в табл. 3.2. 

• Если объект не имеет метода 1оЗігіпд( ) или этот метод не возвращает простое 
значение, то интерпретатор проверяет наличие метода ѵа1ие0Г( ). Если этот ме¬ 
тод определен, интерпретатор вызывает его. Если он возвращает простое зна¬ 
чение, интерпретатор преобразует это значение в строку (если оно не является 
строкой) и возвращает результат преобразования. 

• В противном случае интерпретатор делает вывод, что ни 1:о5і:гіпд( ), ни ѵа1ие0Г( ) 
не позволяют получить простое значение и возбуждает исключение Туре Е г го г. 

При преобразовании объекта в число интерпретатор выполняет те же действия, 
но первым пытается применить метод ѵа1ие0Г( ): 

• Если объект имеет метод ѵаІиеОГО, возвращающий простое значение, интер¬ 
претатор преобразует (при необходимости) это значение в число и возвращает 
результат. 
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• Иначе, если объект имеет метод Іо81гіпд( ), возвращающий простое значение, 
интерпретатор выполняет преобразование и возвращает полученное значение. 

• В противном случае возбуждается исключение Туре Е г го г. 

Описанный алгоритм преобразования объекта в число объясняет, почему пустой 
массив преобразуется в число 0, а массив с единственным элементом может быть 
преобразован в обычное число. Массивы наследуют по умолчанию метод ѵаІиеОіЧ ), 
который возвращает сам объект, а не простое значение, поэтому при преобразова¬ 
нии массива в число интерпретатор опирается на метод ІоЗігіпдО. Пустые масси¬ 
вы преобразуются в пустую строку. А пустая строка преобразуется в число 0. 
Массив с единственным элементом преобразуется в ту же строку, что и единст¬ 
венный элемент массива. Если массив содержит единственное число, это число 
преобразуется в строку, а затем опять в число. 

Оператор + в языке ЛѵаВсгірі выполняет сложение чисел и конкатенацию строк. 
Если какой-либо из его операндов является объектом, ^ѵабсгірі преобразует 
объект, используя специальное преобразование объекта в простое значение вме¬ 
сто преобразования объекта в число, используемого другими арифметическими 
операторами. То же относится и к оператору равенства ==. Если выполняется 
сравнение объекта с простым значением, оператор выполнит преобразование объ¬ 
екта с использованием правил преобразования в простое значение. 

Преобразование объектов в простые значения, используемое операторами + и ==, 
предусматривает особый подход для объектов Оаііе. Класс Оаііе является единст¬ 
венным типом данных в базовом Лѵабсгірі, который определяет осмысленные 
преобразования и в строку, и в число. Преобразование любого объекта, не являю¬ 
щегося датой, в простое значение основано на преобразовании в число (когда пер¬ 
вым применяется метод ѵаІиеОІЧ )), тогда как для объектов типа Оаііе используется 
преобразование в строку (первым применяется метод 1іоЗіігіпд( )). Однако преобра¬ 
зование выполняется не совсем так, как было описано выше: простое значение, 
возвращаемое методом ѵаІиеОШ или ІоЗігіпдО, используется непосредственно, 
без дополнительного преобразования в число или в строку. 

Оператор < и другие операторы отношений выполняют преобразование объектов 
в простые значения подобно оператору ==, но не выделяя объекты Оаііе: для любого 
объекта сначала предпринимается попытка применить метод ѵаІиеОШ» а затем 
метод 1іоЗіігіпд( ). Любое простое значение, полученное таким способом, использу¬ 
ется непосредственно, без дальнейшего преобразования в число или в строку. 

+, ==, ! = и операторы отношений являются единственными, выполняющими спе¬ 
циальное преобразование строки в простое значение. Другие операторы выпол¬ 
няют более явные преобразования в заданный тип и не предусматривают специ¬ 
альной обработки объектов Оаііе. Оператор -, например, преобразует свои операн¬ 
ды в числа. Следующий фрагмент демонстрирует поведение операторов +, -, == 
и > при работе с объектами Оаііе: 


ѵаг пом = пем Оаііе(); 
Ііуреоі" (по м + 1) 
Ііуреоі" ( пом - 1) 
пом == пом. Щ3ігіпд() 
пом > (пом -1) 


// Создать объект Оаііе 

// => "строка": + преобразует дату в строку 
// => "число": - выполнит преобразование объекта в число 
// => Іігііе: неявное и явное преобразование в строку 
// => 1: гие : > преобразует объект Оаііе в число 
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3.9. Объявление переменных 

Прежде чем использовать переменную в ^ѵабсгірі, ее необходимо объявить. Пе¬ 
ременные объявляются с помощью ключевого слова ѵаг следующим образом: 

ѵаг і; 
ѵаг зііт; 

Один раз использовав ключевое слово ѵаг, можно объявить несколько перемен¬ 
ных: 

ѵаг і, зііт; 

Объявление переменных можно совмещать с их инициализацией: 

ѵаг теззаде = "Ііеііо"; 
ѵагі = 0, і=0, к = 0; 

Если начальное значение в инструкции ѵаг не задано, то переменная объявляет¬ 
ся, но ее начальное значение остается неопределенным (ипсІе'ГіпесІ), пока не будет 
изменено программой. 

Обратите внимание, что инструкция ѵаг также может включаться в циклы "Гог 
и ^ог/іп (о которых рассказывается в главе 5), что позволяет объявлять перемен¬ 
ную цикла непосредственно в самом цикле. Например: 

1"ог(ѵаг і = 0; і < 10; і++) сопзоіе. 1од(і); 

1"ог(ѵаг і = 0, з=10; і < 10; і++,і--) сопзоіе. 1од(і*і); 

1"ог(ѵаг р іп о) сопзоіе. Іод(р); 

Если вы имеете опыт использования языков программирования со статическими 
типами данных, таких как С или ^ѵа, то можете заметить, что в объявлениях 
переменных в языке ^ѵабсгірі отсутствует объявление типа. Переменные в язы¬ 
ке ^ѵабсгірі могут хранить значения любых типов. Например, в ^ѵаЗсгірі до¬ 
пускается присвоить некоторой переменной число, а затем этой же переменной 
присвоить строку: 

ѵаг і = 10; 
і = "Іеп"; 

3.9.1 Повторные и опущенные объявления 

С помощью инструкции ѵаг можно объявить одну и ту же переменную несколько 
раз. Если повторное объявление содержит инициализатор, то оно действует как 
обычная инструкция присваивания. 

Если попытаться прочитать значение необъявленной переменной, ^ѵабсгірі сге¬ 
нерирует ошибку. В строгом режиме, предусмотренном стандартом ЕСМАЗсгірі 5 
(раздел 5.7.3), ошибка также возбуждается при попытке присвоить значение не¬ 
объявленной переменной. Однако исторически и при выполнении не в строгом ре¬ 
жиме, если присвоить значение переменной, не объявленной с помощью инструк¬ 
ции ѵаг, то ЛѵаЗсгірі создаст эту переменную как свойство глобального объекта, 
и она будет действовать практически так же (но с некоторыми отличиями, описы¬ 
ваемыми в разделе 3.10.2), как корректно объявленная переменная. Это означает, 
что глобальные переменные можно не объявлять. Однако это считается дурной 
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привычкой и может явиться источником ошибок, поэтому всегда старайтесь объ¬ 
являть свои переменные с помощью ѵаг. 


3.10. Область видимости переменной 

Область видимости (зсоре) переменной - это та часть программы, для которой 
эта переменная определена. Глобальная переменная имеет глобальную область 
видимости - она определена для всей ^ѵабсгірі-программы. В то же время пере¬ 
менные, объявленные внутри функции, определены только в ее теле. Они назы¬ 
ваются локальными и имеют локальную область видимости. Параметры функ¬ 
ций также считаются локальными переменными, определенными только в теле 
этой функции. 

Внутри тела функции локальная переменная имеет преимущество перед гло¬ 
бальной переменной с тем же именем. Если объявить локальную переменную или 
параметр функции с тем же именем, что у глобальной переменной, то фактически 
глобальная переменная будет скрыта: 


ѵаг зсоре = "дІоЬаІ"; 
Гііпсіііоп сбескзсоре() { 
ѵаг зсоре = "Іосаі"; 
геііігп зсоре; 

} 

сбескзсоре() 


// Объявление глобальной переменной 

// Объявление локальной переменной с тем же именем 
// Вернет локальное значение, а не глобальное 

// => "Іосаі" 


Объявляя переменные с глобальной областью видимости, инструкцию ѵаг можно 
опустить, но при объявлении локальных переменных всегда следует использо¬ 
вать инструкцию ѵаг. Посмотрите, что получается, если этого не сделать: 


зсоре = "дІоЬаІ"; 


// Объявление глобальной переменной, даже без ѵаг. 


Гііпсііоп сбескзсоре2() { 

зсоре = "Іосаі"; // Ой! Мы изменили глобальную переменную, 

тузсоре = "Іосаі"; // Неявно объявляется новая глоб. переменная, 

геііігп [зсоре, тузсоре]; // Вернуть два значения. 

} 

сбескзсоре2() // => ["Іосаі", "Іосаі"]: имеется побочный эффект! 

зсоре // => "Іосаі": глобальная переменная изменилась. 

тузсоре // => "Іосаі": нарушен порядок в глобальном пространстве имен. 


Определения функций могут быть вложенными. Каждая функция имеет собст¬ 
венную локальную область видимости, поэтому может быть несколько вложен¬ 
ных уровней локальных областей видимости. Например: 

ѵаг зсоре = "дІоЬаІ зсоре"; // Глобальная переменная 

Гііпсііоп сбескзсоре() { 

ѵаг зсоре = "Іосаі зсоре”; // Локальная переменная 
Гііпсііоп пезІесК) { 

ѵаг зсоре = "пезіесі зсоре"; // Вложенная область видимости локальных переменных 
геііігп зсоре; // Вернет значение этой переменной зсоре 

} 

геііігп пезІесК); 

} 

сбескзсоре() 


// => "пезіесі зсоре" 
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3.10.1. Область видимости функции и подъем 

В некоторых Оподобных языках программирования каждый блок программно¬ 
го кода внутри фигурных скобок имеет свою собственную область видимости, 
а переменные, объявленные внутри этих блоков, невидимы за их пределами. Эта 
особенность называется областью видимости блока , но она не поддерживается 
в языке Лѵабсгірі. Вместо этого в ЛѵаВсгірі используется такое понятие, как 
область видимости функции : переменные, объявленные внутри функции, дос¬ 
тупны внутри функции, где они объявлены, а также внутри всех функций, вло¬ 
женных в эту функцию. 

В следующем фрагменте переменные і, і и к объявляются в разных местах, но все 
они имеют одну и ту же область видимости - все три переменные доступны из лю¬ 
бого места в теле функции: 

^ііпсіііоп ІезКо) { 
ѵаг і = 0; 

іТ (Іуреоі 1 о == "оЬіесІ:") { 

ѵаг і = 0; 

1"ог(ѵаг к=0; к < 10; к++) 
сопзоіе.Іод( к) ; 

} 

сопзоіе.Іод( к) ; 

} 

сопзоіе.1од(і); 

} 

Область видимости функции в языке ^ѵабсгірі подразумевает, что все перемен¬ 
ные, объявленные внутри функции, видимы везде в теле функции. Самое инте¬ 
ресное, что переменные оказываются видимыми еще до того, как будут объявле¬ 
ны. Эта особенность ^ѵаЗсгірі неофициально называется подъемом: программ¬ 
ный код ЛѵаЗсгірі ведет себя так, как если бы все объявления переменных внут¬ 
ри функции (без присваивания инициализирующих значений) «поднимались» 
в начало функции. Рассмотрим следующий фрагмент: 

ѵаг зсоре = "дІоЬаІ"; 

^ііпсіііоп 14 ) { 

сопзоіе.Іод(зсоре); // Выведет "ипсіеі'іпес!". а не "дІоЬаІ" 

ѵаг зсоре = "Іосаі"; // Инициализируется здесь, а определена везде 

сопзоіе.Іод(зсоре); // Выведет "Іосаі" 

} 

Можно было бы подумать, что первая инструкция внутри функции должна вы¬ 
вести слово «ДІоЬаІ», потому что инструкция ѵаг с объявлением локальной пере¬ 
менной еще не была выполнена. Однако вследствие действия правил области ви¬ 
димости функции выводится совсем другое значение. Локальная переменная оп¬ 
ределена во всем теле функции, а это означает, что глобальная переменная с тем 
же именем оказывается скрытой для всей функции. Хотя локальная переменная 
определена во всем теле функции, она остается неинициализированной до вы¬ 
полнения инструкции ѵаг. То есть функция выше эквивалентна реализации, при¬ 
веденной ниже, в которой объявление переменной «поднято» в начало функции, 
а инициализация переменной выполняется там же, где и раньше: 


// і определена в теле всей функции 

// ] определена везде, не только в блоке 
{ // к определена везде, не только в цикле 
// выведет числа от 0 до 9 

// к по-прежнему определена: выведет 10 

// ] определена, но может быть неинициализирована 
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Ішсіііоп Т() { 
ѵаг зсоре; 
сопзоіе.Іод(зсоре); 
зсоре = "Іосаі"; 
сопзоіе.Іод(зсоре); 


// Объявление локальной переменной в начале функции 
// Здесь она доступна, но имеет значение "ііпсІеІ'іпесГ 
// Здесь она инициализируется и получает свое значение 
// А здесь она имеет ожидаемое значение 


В языках программирования, где поддерживаются области видимости блоков, 
рекомендуется объявлять переменные как можно ближе к тому месту, где они ис¬ 
пользуются, а область видимости делать как можно более узкой. Поскольку в Зг.- 
ѵабсгірі не поддерживаются области видимости блоков, некоторые программи¬ 
сты стремятся объявлять все переменные в начале функции, а не рядом с местом, 
где они используются. Такой подход позволяет более точно отражать истинную 
область видимости переменных в программном коде. 


3.10.2. Переменные как свойства 


При объявлении глобальной переменной в ^ѵабсгірі в действительности созда¬ 
ется свойство глобального объекта (раздел 3.5). Если глобальная переменная объ¬ 
является с помощью инструкции ѵаг, создается ненастраиваемое свойство (раз¬ 
дел 6.7), т. е. свойство, которое невозможно удалить с помощью оператора сіеіеііе. 
Как уже отмечалось выше, если не используется строгий режим и необъявленной 
переменной присваивается некоторое значение, интерпретатор ЛѵаВсгірі авто¬ 
матически создает глобальную переменную. Переменные, созданные таким спо¬ 
собом, становятся обычными, настраиваемыми свойствами глобального объекта 
и могут быть удалены: 


ѵаг ігцеѵаг = 1; 
^акеѵаг = 2; 

ІІііз. 1"акеѵаг2 = 3; 
сіеіеііе Ігцеѵаг 
сіеіеііе ^акеѵаг 
сіеіеііе ІІііз. 1"акеѵаг2 


// Правильно объявленная глобальная переменная, неудаляемая. 
// Создается удаляемое свойство глобального объекта. 

// То же самое. 

// => Шзе: переменная не была удалена 
// => Ігце: переменная удалена 
// => Ігце: переменная удалена 


Глобальные переменные в языке Лѵа8сгірі являются свойствами глобального 
объекта, и такое положение вещей закреплено в спецификации ЕСМАВсгірі. Это 
не относится к локальным переменным, однако локальные переменные можно 
представить как свойства объекта, ассоциированного с каждым вызовом функ¬ 
ции. В спецификации ЕСМА8сгірі 3 этот объект называется «объектом вызова» 
(саіі оЬіесі), а в спецификации ЕСМА8сгірі 5 он называется «записью с описани¬ 
ем окружения» (сіесіагаііѵе епѵігоптепі гесогсі). Интерпретатор Лѵа8сгірі позво¬ 
ляет ссылаться на глобальный объект с помощью ключевого слова Іііііз, но он не 
дает никакой возможности сослаться на объект, в котором хранятся локальные 
переменные. Истинная природа объектов, в которых хранятся локальные пере¬ 
менные, зависит от конкретной реализации и не должна заботить нас. Однако 
сам факт наличия объектов с локальными переменными имеет большое значе¬ 
ние, и эта тема будет рассматриваться в следующем разделе. 
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3.10.3 Цепочки областей видимости 

^ѵабсгірі - э'го язык программирования с лексической областью видимости : об¬ 
ласть видимости переменной распространяется на строки с исходным программ¬ 
ным кодом, для которых определена переменная. Глобальные переменные опре¬ 
делены для всей программы в целом. Локальные переменные определены для 
всей функции, в которой они объявлены, а также для любых функций, вложен¬ 
ных в эту функцию. 

Если считать локальные переменные свойствами некоторого объекта, зависящего 
от реализации, то появляется возможность взглянуть на области видимости пере¬ 
менных с другой стороны. Каждый фрагмент программного кода на Лѵа8сгірі 
(глобальный программный код или тело функции) имеет цепочку областей види¬ 
мости , ассоциированную с ним. Эта цепочка областей видимости представляет 
собой список, или цепочку объектов, определяющих переменные, которые нахо¬ 
дятся «в области видимости» данного фрагмента программного кода. Когда ин¬ 
терпретатору требуется отыскать значение переменной х (этот процесс называет¬ 
ся разрешением переменной ), он начинает поиск с первого объекта в цепочке. Ес¬ 
ли этот объект имеет свойство с именем х, используется значение этого свойства. 
Если первый объект не имеет свойства с именем х, интерпретатор ^ѵаЗсгірі про¬ 
должает поиск в следующем объекте в цепочке. Если второй объект не имеет 
свойства с именем х, интерпретатор переходит к следующему объекту и т. д. Если 
ни один из объектов в цепочке областей видимости не имеет свойства с именем х, 
то интерпретатор считает, что переменная х находится вне области видимости 
данного программного кода и возбуждает ошибку РеІ'егепсеЕггог. 

Для программного кода верхнего уровня (т. е. для программного кода за предела¬ 
ми каких-либо функций) цепочка областей видимости состоит из единственного, 
глобального объекта. Для невложенных функций цепочка областей видимости 
состоит из двух объектов. Первым является объект, определяющий параметры 
и локальные переменные функции, а вторым - глобальный объект. Для вложен¬ 
ных функций цепочка областей видимости может содержать три и более объек¬ 
тов. Важно понимать, как создаются цепочки этих объектов. Определение функ¬ 
ции фактически сохраняет ее область видимости в цепочке. Когда эта функция 
вызывается, интерпретатор создает новый объект, хранящий локальные пере¬ 
менные, и добавляет его к имеющейся цепочке, образуя новую, более длинную 
цепочку, представляющую область видимости вызываемой функции. Ситуация 
становится еще более интересной для вложенных функций, потому что каждый 
раз, когда вызывается внешняя функция, внутренняя функция объявляется за¬ 
ново. Поскольку для каждого вызова внешней функции создается новая цепочка, 
вложенные функции будут немного отличаться при каждом определении - при 
каждом вызове внешней функции программный код вложенной функции будет 
одним и тем же, но цепочка областей видимости, ассоциированная с этим про¬ 
граммным кодом, будет отличаться. 

Такой взгляд на цепочку областей видимости будет полезен для понимания инст¬ 
рукции \л/і1:И (раздел 5.7.1) и чрезвычайно важен для понимания замыканий (раз¬ 
дел 8.6). 




4 

Выражения и операторы 


Выражение - это фраза языка ^ѵабсгірі, которая может быть вычислена интер¬ 
претатором для получения значения. Константа, встроенная в программу, явля¬ 
ется простейшей разновидностью выражений. Имя переменной также является 
простейшим выражением, в результате вычисления которого получается значе¬ 
ние, присвоенное переменной. Более сложные выражения состоят из простых вы¬ 
ражений. Выражение обращения к элементу массива, например, состоит из выра¬ 
жения, которое возвращает массив, за которым следуют открывающая квадрат¬ 
ная скобка, выражение, возвращающее целое число, и закрывающая квадратная 
скобка. В результате вычисления этого более сложного выражения получается 
значение, хранящееся в элементе указанного массива с указанным индексом. 
Аналогично выражение вызова функции состоит из выражения, возвращающего 
объект функции и ноль или более дополнительных выражений, используемых 
в качестве аргументов функции. 

Наиболее типичный способ конструирования сложных выражений из более про¬ 
стых выражений заключается в использовании операторов . Операторы объеди¬ 
няют значения своих операндов (обычно двух) некоторым способом и вычисляют 
новое значение. Простейшим примером может служить оператор умножения *. 
Выражение х * у вычисляется как произведение значений выражений х и у. Ино¬ 
гда для простоты мы говорим, что оператор возвращает значение вместо «вычис¬ 
ляет» значение. 

Эта глава описывает все операторы ЛѵаВсгірі, а также выражения (такие как ин¬ 
дексирование массивов и вызов функций), в которых не используются операторы. 
Те, кто знаком с другими языками программирования, использующими С-подоб- 
ный синтаксис, заметят, что в ^ѵабсгірі выражения и операторы имеют похо¬ 
жий синтаксис. 

4.1. Первичные выражения 

Простейшие выражения, известные как первичные выражения , являются са¬ 
мостоятельными выражениями - они не включают более простых выражений. 
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Первичными выражениями в языке ^ѵабсгірі являются константы, или лите¬ 
ралы , некоторые ключевые слова и ссылки на переменные. 

Литералы и константы встраиваются непосредственно в программный код. Онй 
выглядят, как показано ниже: 

1.23 // Числовой литерал 

"беііо" // Строковый литерал 

/раТТегп/ // Литерал регулярного выражения 

Синтаксис числовых литералов в ЛѵаВсгірі был описан в разделе 3.1.0 строковых 
литералах рассказывалось в разделе 3.2. Синтаксис литералов регулярных выра¬ 
жений был представлен в разделе 3.2.4 и подробно будет описываться в главе 10. 

Ниже приводятся некоторые из зарезервированных слов ^ѵаВсгірі, являющих¬ 
ся первичными выражениями: 

1: гие // Возвращает логическое значение 1: гие 

1"аІ5е // Возвращает логическое значение ^аізе 

гшіі // Возвращает значение піііі 

ІіГііз // Возвращает "текущий" объект 

Мы познакомились со значениями Іігие, Гаізе и пиіі в разделах 3.3 и 3.4. В отли¬ 
чие от других ключевых слов, ІіГііз не является константой - в разных местах про¬ 
граммы оно может возвращать разные значения. Ключевое слово ІіГііз использу¬ 
ется в объектно-ориентированном программировании. Внутри метода Шз воз¬ 
вращает объект, относительно которого был вызван метод. Дополнительные 
сведения о ключевом слове ГИіз можно найти в разделе 4.5, в главе 8 (особенно 
в разделе 8.2.2) и в главе 9. 

Наконец, третьим типом первичных выражений являются ссылки на переменные: 

і // Возвращает значение переменной і 

5шп // Возвращает значение переменной зііт 

ипс!еГіпес! // ипсіеГіпес! - глобальная переменная, а не ключевое слово, как пиіі 

Когда в программе встречается идентификатор, интерпретатор ^ѵабсгірі предпо¬ 
лагает, что это имя переменной и пытается отыскать ее значение. Если переменной 
с таким именем не существует, возвращается значение ипсІеГіпесІ. Однако в строгом 
режиме, определяемом стандартом ЕСМАЗсгірі 5, попытка получить значение 
несуществующей переменной оканчивается исключением РеГегепсеЕггог. 

4.2. Инициализаторы объектов и массивов 

Инициализаторы объектов и массивов - это выражения, значениями которых 
являются вновь созданные объекты и массивы. Эти выражения-инициализаторы 
иногда называют «литералами объектов» и «литералами массивов». Однако, в от¬ 
личие от истинных литералов, они не являются первичными выражениями, по¬ 
тому что включают множество подвыражений, определяющих значения свойств 
и элементов. Инициализаторы массивов имеют более простой синтаксис, поэтому 
мы рассмотрим их в первую очередь. 

Инициализатор массива - это список выражений, разделенных запятыми, за¬ 
ключенный в квадратные скобки. Значением инициализатора массива является 
вновь созданный массив. Элементы этого нового массива инициализируются зна¬ 
чениями выражений из списка: 
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[] // Пустой массив: отсутствие выражений в квадратных скобках 

// означает отсутствие элементов 

[1+2,3+4] // Массив из 2 элементов. Первый элемент - 3, второй - 7 

Выражения в инициализаторе массива, определяющие значения его элементов, 
сами могут быть инициализаторами массивов, благодаря чему имеется возмож¬ 
ность создавать вложенные массивы: 

ѵаг таіігіх = [[1,2,3], [4,5,6], [7,8,9]]; 

Выражения в инициализаторе массива, определяющие значения его элементов, 
вычисляются всякий раз, когда вычисляется значение инициализатора. Это оз¬ 
начает, что значение выражения инициализатора массива может отличаться при 
каждом последующем его вычислении. 

В литерал массива допускается включать неопределенные элементы, для чего дос¬ 
таточно опустить значение между запятыми. Например, следующий массив со¬ 
держит пять элементов, включая три элемента с неопределенными значениями: 

ѵаг эрагэеАггау = [1,,,,5]; 

После последнего выражения в инициализаторах массивов допускается указы¬ 
вать завершающую запятую, при этом последний элемент с неопределенным зна¬ 
чением создаваться не будет. 

Выражения-инициализаторы объектов похожи на выражения-инициализаторы 
массивов, но вместо квадратных скобок в них используются фигурные скобки, 
а каждое подвыражение предваряется именем свойства и двоеточием: 

ѵаг р = { х:2.3, у:-1.2 }; // Объект с 2 свойствами 

ѵаг ц = {}; // Пустой объект без свойств 

ц.х = 2.3; ц.у = -1.2; // Теперь ц имеет те же свойства, что и р 

Литералы объектов могут быть вложенными. Например: 

ѵаг гесііапдіе = { иррегІ_еМі: { х: 2, у: 2 }, 

1о\л/е гРідМ: : { х: 4, у: 5 } }; 

Выражения внутри инициализаторов объектов вычисляются всякий раз, когда 
вычисляется значение самого инициализатора, и не обязательно должны быть 
константами: они могут быть произвольными выражениями ^ѵабсгірі. Кроме 
того, имена свойств в литералах объектов могут быть строками, а не идентифика¬ 
торами (это удобно, когда возникает желание дать свойствам имена, совпадаю¬ 
щие с зарезервированными словами, которые иначе не могут использоваться в ка¬ 
честве идентификаторов): 

ѵаг зісіе = 1; 

ѵаг эриаге = { "иррегІеІЧ" : { х: р.х, у: р.у }, 

’ 1о\л/е гРідМ: ’: { х: р.х + зісіе , у: р.у + зісіе} }; 

Мы еще вернемся к инициализаторам объектов и массивов в главах 6 и 7. 

4.3. Выражения определений функций 

Выражение определения функции определяет функцию, а значением такого вы¬ 
ражения является вновь созданная функция. В некотором смысле выражение 
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определения функции является «литералом функции» подобно тому, как ини¬ 
циализаторы объектов являются «литералами объектов». Выражение определе¬ 
ния функции обычно состоит из ключевого слова Гипс1:іоп, за которым следует 
список из нуля или более идентификаторов (имен параметров), разделенных за¬ 
пятыми, в круглых скобках и блок программного кода на языке ^ѵа8сгірі (тело 
функции) в фигурных скобках. Например: 

// Эта функция возвращает квадрат переданного ей значения 

ѵаг зциаге = ^ипс1:іоп(х) { геТигп х * х; } 

Выражение определения функции также может включать имя функции. Кроме 
того, функции можно определять с помощью инструкции Гипс1:іоп, вместо выра¬ 
жения определения функции. Подробное описание особенностей определения 
функций приводится в главе 8. 


4.4. Выражения обращения к свойствам 

Выражение обращения к свойству вычисляет значение свойства объекта или эле¬ 
мента массива. В языке ^ѵаЗсгірі имеется два способа обращения к свойствам: 

выражение . идентификатор 
выражение [ выражение ] 


Первый способ обращения к свойствам заключается в использовании выраже¬ 
ния, за которым следуют точка и идентификатор. Выражение определяет объект, 
а идентификатор - имя требуемого свойства. Первый способ заключается в ис¬ 
пользовании выражения (объект или массив), за которым следует другое выра¬ 
жение, заключенное в квадратные скобки. Второе выражение определяет имя 
требуемого свойства или индекс элемента массива. Ниже приводится несколько 
конкретных примеров: 


ѵаг о = {х:1,у:{г:3}}; 

ѵаг а = [о,4,[5,6]]; 

о. х 

о. у. 2 

оГѴ] 

а[1] 

а[2]["1" ] 
а[0]. х 


// Пример объекта 

// Пример массива, содержащего объект 

// => 1: свойство х выражения о 

// => 3: свойство г выражения о.у 

// => 1: свойство х объекта о 

// => 4: элемент с индексом 1 выражения а 

// => 6: элемент с индексом 1 выражения а[2] 

// => 1: свойство х выражения а[0] 


Независимо от способа обращения к свойству первым вычисляется выражение, 
стоящее перед . или [. Если значением этого выражения является пиіі или ипсІеГі- 
песі, возбуждается исключение ТуреЕггог, потому что эти два значения в ^ѵа8сгірі 
не имеют свойств. Если значение выражения не является объектом (или массивом), 
оно будет преобразовано в объект (раздел 3.6). Если за первым выражением следует 
точка и идентификатор, интерпретатор попытается отыскать значение свойства 
с именем, совпадающим с идентификатором, которое и станет значением всего вы¬ 
ражения. Если за первым выражением следует другое выражение в квадратных 
скобках, интерпретатор вычислит второе выражение и преобразует его в строку. 
В этом случае значением всего выражения станет значение свойства, имя которого 
совпадает со строкой. В любом случае, если свойство с указанным именем не суще¬ 
ствует, значением выражения обращения к свойству станет значение ипсІеГіпесІ. 
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Из двух способов обращения к свойству синтаксис . идентификатор выглядит проще, 
но обратите внимание, что этот способ может использоваться, только если именем 
свойства, к которому выполняется обращение, является допустимый идентифи¬ 
катор, и это имя известно на этапе создания программы. Если имя свойства сов¬ 
падает с зарезервированным словом, включает пробелы или знаки пунктуации, 
или когда оно является числом (в случае массивов), необходимо использовать 
синтаксис с квадратными скобками. Кроме того, квадратные скобки можно ис¬ 
пользовать, когда имя свойства является не статическим, а результатом некото¬ 
рых вычислений (пример можно найти в разделе 6.2.1). 

Подробнее об объектах и их свойствах рассказывается в главе 6, а массивы и их 
элементы обсуждаются в главе 7. 

4.5. Выражения вызова 

Выражение вызова в языке ^ѵабсгірі служит для вызова (или выполнения) функ¬ 
ции или метода. Оно начинается с выражения, возвращающего функцию, иденти¬ 
фицирующего вызываемую функцию. Вслед за выражением получения функции 
следуют открывающая круглая скобка, список из нуля или более выражений ар¬ 
гументов, разделенных запятыми, и закрывающая круглая скобка. Например: 

НО) // Т - выражение функции; 0 - выражение аргумента. 

МаІІі. тах(х, у, т.) // МаІМ.тах - функция; х, у и г - аргументы. 

а.зогіО // а.зогі - функция; здесь нет аргументов. 

При вычислении выражения вызова первым вычисляется выражение, возвра¬ 
щающее функцию, а затем вычисляются выражения аргументов и создается спи¬ 
сок значений аргументов. Если значением выражения, возвращающего функцию, 
не является вызываемый объект, возбуждается исключение ТуреЕггог. (Все функ¬ 
ции являются вызываемыми объектами. Объекты среды выполнения также мо¬ 
гут быть вызываемыми, даже если они не являются функциями. Это отличие рас¬ 
сматривается в разделе 8.7.7.) Далее значения аргументов присваиваются в по¬ 
рядке их следования именам параметров, которые указаны в определении функ¬ 
ции, после чего выполняется тело функции. Если внутри функции используется 
инструкция геіигп, возвращающая некоторое значение, это значение становится 
значением выражения вызова. В противном случае выражение вызова возвраща¬ 
ет значение ипсІе'ГіпесІ. Полное описание механизма вызова функций, включая 
описание того, что происходит, когда количество выражений аргументов не сов¬ 
падает с количеством параметров в определении функции, вы найдете в главе 8. 

Все выражения вызова включают пару круглых скобок и выражение перед от¬ 
крывающей круглой скобкой. Если это выражение является выражением обра¬ 
щения к свойству, такой вызов называется вызовом метода. При вызове метода 
объект или массив, к свойству которого производится обращение, становится 
значением параметра {Ійз, доступного в теле функции во время его выполнения. 
Это обеспечивает поддержку парадигмы объектно-ориентированного програм¬ 
мирования, согласно которой функции (в ООП обычно называются «методами») 
получают возможность манипулировать объектом, частью которого они являют¬ 
ся. Подробности приводятся в главе 9. 

В выражениях вызова, которые не являются вызовами методов, значением клю¬ 
чевого слова Шб обычно является глобальный объект. Однако согласно стандарту 
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ЕСМАЗсгірі 5, если функция определяется в строгом режиме, при вызове она по¬ 
лучает в ключевом слове ІМіз не глобальный объект, а значение ипсІеГіпесі. Подроб¬ 
нее о строгом режиме рассказывается в разделе 5.7.3. 

4.6. Выражения создания объектов 

Выражение создания объекта создает новый объект и вызывает функцию (назы¬ 
ваемую конструктором) для инициализации свойств этого объекта. Выражения 
создания объектов похожи на выражения вызова, за исключением того, что им 
предшествует ключевое слово пеѵѵ: 

пем О^есТО 
пем Роіпі: (2.3) 

Если в выражении создания объекта функции-конструктору не передается ни од¬ 
ного аргумента, пустую пару круглых скобок можно опустить: 

пеѵ/ О^есі 
пем Оаііе 

При вычислении выражения создания объекта интерпретатор ^ѵабсгірі снача¬ 
ла создает новый пустой объект, как если бы для создания использовался пустой 
инициализатор объекта {}, а затем вызывает указанную функцию с указанными 
аргументами, передавая ей новый объект в качестве значения ключевого слова 
■Шз. Функция может использовать его для инициализации свойств только что 
созданного объекта. Функции, которые создаются специально, чтобы играть роль 
конструктора, не должны возвращать значение, а значением выражения созда¬ 
ния объекта становится созданный и инициализированный объект. Если конст¬ 
руктор возвращает какой-либо объект, этот объект становится значением всего 
выражения создания объекта, а вновь созданный объект уничтожается. 

Более подробно конструкторы описываются в главе 9. 

4.7. Обзор операторов 

В языке Лѵа8сгірі операторы используются в арифметических выражениях, вы¬ 
ражениях сравнения, логических выражениях, выражениях присваивания и т. д. 
Перечень операторов приводится в табл. 4.1, которую можно использовать как 
справочник. 

Таблица 4.1. Операторы ^ ѵаЗсгірі 


Оператор 

Операция 

А 

N 

Типы значений 

++ 

Префиксный и постфиксный инкремент 

К 

1 

левостороннее выражение 

—> число 

— 

Префиксный и постфиксный декремент 

К 

1 

левостороннее выражение 

—> число 

- 

Унарный минус 

К 

1 

число —> число 

+ 

Преобразование в число 

к 

1 

число —> число 

~ 

Поразрядная инверсия 

к 

1 

целое —»целое 
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Оператор 

Операция 

А 

N 

Типы значений 

! 

Логическая инверсия 

К 

в 

логическое —»логическое 

♦ 

сіеіеііе 

Удаление свойства 

К 

1 

левостороннее выражение 

—> логическое 

Ііурео^ 

Определение типа операнда 

К 

В 

любое —> строка 

ѴОІСІ 

Возврат неопределенного значения 

к 

в 

любое —> ыпсіеі'іпесі 

*,/,% 

Умножение, деление, деление по модулю 

а 

2 

число, число —> число 

+, - 

Сложение, вычитание 

в 

2 

число, число —> число 

+ 

Конкатенация строк 

В 

2 

строка, строка —> строка 

« 

Сдвиг влево 

в 

2 

целое, целое —> целое 

» 

Сдвиг вправо с сохранением знака 

В 

2 

целое, целое —> целое 

»> 

Сдвиг вправо с заполнением нулями 

в 

2 

целое, целое —> целое 

А 

ч* 

А 

II 

* 

V 

* 

V 

II 

Сравнение числовых значений 

ь 

2 

число, число —»логическое 

II 

А 

* 

А 

* 

II 

V 

* 

V 

Сравнение строк 

ь 

2 

строка, строка —> логическое 

іпзіапсеоі 1 

Проверка на принадлежность классу 

ь 

2 

объект, функция —> логиче¬ 
ское 

іп 

Проверка наличия свойства 

ь 

2 

строка, объект —> логическое 

== 

Проверка равенства 

ь 

2 

любое, любое —»логическое 

! = 

Проверка неравенства 

ь 

2 

любое, любое —> логическое 

--- 

Проверка идентичности 

ь 

2 

любое, любое —» логическое 

!== 

Проверка неидентичности 

ь 

2 

любое, любое —» логическое 

& 

Поразрядное И 

в 

2 

целое, целое —» целое 

л 

Поразрядное ИСКЛЮЧАЮЩЕЕ ИЛИ 

а 

2 

целое, целое —» целое 

1 

Поразрядное ИЛИ 

в 

2 

целое, целое —» целое 

&& 

Логическое И 

в 

2 

любое, любое —> любое 

и 

Логическое ИЛИ 

в 

2 

любое, любое —> любое 


Выбор второго или третьего операнда 

к 

3 

логическое, любое, любое —> 
любое 

- 

Присваивание переменной или свойству 

к 

2 

левостороннее выражение, 
любое —> любое 

*=, /=, %=, 

+=, -=, &=, 

~ = 1= «= 

» 1 » » 

»=, »>= 

Операция с присваиванием 

к 

2 

левостороннее выражение, 
любое —> любое 

1 

Отбросить первый операнд, вернуть второй 

в 

2 

любое, любое —> любое 


Обратите внимание, что большинство операторов обозначаются символами пунк¬ 
туации, такими как + и =, а некоторые - ключевыми словами, например сіеіеіе 
и іпбіапсеоі". И ключевые слова, и знаки пунктуации обозначают обычные опера¬ 
торы, просто первые имеют менее лаконичный синтаксис. 

Операторы в табл. 4.1 перечислены в порядке их приоритетов. Операторы, пере¬ 
численные первыми, имеют более высокий приоритет. Операторы, отделенные 
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горизонтальной линией, имеют разные приоритеты. Столбец «А» в этой таблице 
содержит ассоциативность оператора (либо Ь - слева направо, либо К - справа на¬ 
лево), а столбец «Ы» определяет количество операндов. В столбце «Типы значе¬ 
ний» указаны ожидаемые типы операндов и (после символа —») тип результата, 
возвращаемого оператором. В подразделах, следующих за таблицей, описывают¬ 
ся концепции приоритетов, ассоциативности и типов операндов. Вслед за этим 
приводится обсуждение самих операторов. 

4.7.1. Количество операндов 

Операторы могут быть разбиты на категории по количеству требуемых им опе¬ 
рандов. Большинство ^ѵаЗсгірі-операторов, таких как оператор умножения *, 
являются двухместными . Такие операторы объединяют два выражения в одно, 
более сложное. То есть эти операторы работают с двумя операндами. ^ѵабсгірі 
поддерживает также несколько унарных операторов , которые преобразуют одно 
выражение в другое, более сложное. Оператор - в выражении -х является унар¬ 
ным оператором, выполняющим смену знака операнда х. И, наконец, ^ѵа8сгірі 
поддерживает один тернарный условный оператор ?:, который объединяет три 
выражения в одно. 

4.7.2. Типы данных операндов и результата 

Некоторые операторы могут работать со значениями любых типов, но большинст¬ 
во из них требуют, чтобы операнды имели значения определенного типа, и боль¬ 
шинство операторов возвращают значение определенного типа. Колонка «Типы 
значений» в табл. 4.1 определяет типы операндов (перед стрелкой) и тип результа¬ 
та (после стрелки) для операторов. 

Операторы в языке ^ѵа8сгірі обычно преобразуют типы своих операндов (как 
описывается в разделе 3.8) по мере необходимости. Оператор умножения * ожида¬ 
ет получить числовые операнды, однако выражение "3" * "5" считается вполне 
допустимым благодаря тому, что интерпретатор выполнит преобразование стро¬ 
ковых операндов в числа. Значением этого выражения будет число 15, а не строка 
"15". Не забывайте также, что любое значение в ^ѵа8сгірі может быть «истин¬ 
ным» или «ложным», поэтому операторы, ожидающие получить логические опе¬ 
ранды, будут работать с операндами любого типа. 

Некоторые операторы ведут себя по-разному в зависимости от типа операндов. 
Самый яркий пример - оператор +, который складывает числовые операнды и вы¬ 
полняет конкатенацию строк. Аналогично операторы сравнения, такие как <, 
сравнивают значения как числа или как строки, в зависимости от типов операн¬ 
дов. О зависимостях от типов операндов и о выполняемых преобразованиях будет 
рассказываться в описаниях отдельных операторов. 

4.7.3. Левосторонние выражения 

Обратите внимание, что операторы присваивания, как и некоторые другие, пере¬ 
численные в табл. 4.1, ожидают получить в качестве операндов левосторонние 
выражения ( Іѵаіие ). Левостороннее выражение - это исторический термин, обо¬ 
значающий «выражение, которое может присутствовать слева от оператора при¬ 
сваивания». В ^ѵа8сгірі левосторонними выражениями являются переменные, 




47. Обзор операторов 


87 


свойства объектов и элементы массивов. Спецификация ЕСМА8сгірі разрешает 
встроенным функциям возвращать левосторонние выражения, но не определяет 
никаких встроенных функций, ведущих себя подобным образом. 

4.7.4. Побочные эффекты операторов 

Вычисление простого выражения, такого как 2*3, никак не отразится на со¬ 
стоянии программы и никак не затронет последующие вычисления, выполняе¬ 
мые программой. Однако некоторые выражения могут иметь побочные эффек¬ 
ты , и их вычисление может оказывать влияние на результаты последующих вы¬ 
числений. Наиболее очевидным примером являются операторы присваивания: 
если переменной или свойству присвоить некоторое значение, это повлияет на ре¬ 
зультат любого выражения, в котором используется эта переменная или свойст¬ 
во. Аналогичный побочный эффект имеют операторы инкремента ++ и декремен¬ 
та поскольку они неявно выполняют присваивание. Оператор сіеіеіе также 
имеет побочный эффект: операция удаления свойства напоминает (хотя и недос¬ 
таточно близко) присваивание свойству значения ипсіе^іпесі. 

Никакие другие операторы в языке ^ѵа8сгірі не имеют побочных эффектов, но 
выражения вызова функции и создания объекта обязательно будут иметь побоч¬ 
ные эффекты, если в теле функции или конструктора будут использованы опера¬ 
торы, имеющие побочные эффекты. 

4.7.5. Приоритет операторов 

Операторы перечислены в табл. 4.1 в порядке уменьшения приоритета, и гори¬ 
зонтальные линии отделяют группы операторов с разным уровнем приоритета. 
Приоритет оператора управляет порядком, в котором выполняются операции. 
Операторы с более высоким приоритетом (ближе к началу таблицы) выполняют¬ 
ся раньше операторов с более низким приоритетом (ближе к концу таблицы). 

Рассмотрим следующее выражение: 

V! = X + у * 2; 

Оператор умножения * имеет более высокий приоритет по сравнению с операто¬ 
ром сложения +, поэтому умножение выполняется раньше сложения. Оператор 
присваивания = имеет наименьший приоритет, поэтому присваивание выполня¬ 
ется после завершения всех операций в правой части. 

Приоритет операторов может быть переопределен с помощью скобок. Чтобы сло¬ 
жение в предыдущем примере выполнялось раньше, надо написать: 

V/ = (х + у)* ъ\ 

Следует учитывать, что выражения вызова и обращения к свойству имеют более 
высокий приоритет, чем любой из операторов, перечисленных в табл. 4.1. Взгля¬ 
ните на следующее выражение: 

Іуреоі 1 ту. ■РітсІіопзОКу) 

Несмотря на то что Ііурео'Г является одним из самых высокоприоритетных опера¬ 
торов, операция Ііурео'Г будет выполняться над результатом операций обращения 
к свойству и вызова функции. 
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На практике, если вы не уверены в приоритетах применения операторов, проще 
всего явно задать порядок вычислений с помощью скобок. Важно четко знать сле¬ 
дующие правила: умножение и деление выполняются раньше сложения и вычи¬ 
тания, а присваивание имеет очень низкий приоритет и почти всегда выполняет¬ 
ся последним. 

4.7.6. Ассоциативность операторов 

В табл. 4.1 в столбце «А» указана ассоциативность операторов. Значение Ь ука¬ 
зывает на ассоциативность слева направо, а значение К - на ассоциативность 
справа налево. Ассоциативность оператора определяет порядок выполнения опе¬ 
раций с одинаковым приоритетом. Ассоциативность слева направо означает, что 
операции выполняются слева направо. Например, оператор вычитания имеет ас¬ 
социативность слева направо, поэтому следующие два выражения эквивалентны: 

ѴѴ = X - у - 2; 

N = ((х - у) - 2 ); 

С другой стороны, выражения 

X = “-у; 

ѵ/ = х = у = 2 ; 

д = а?Ь:с?сІ:е?Г:д; 

эквивалентны следующим выражениям: 

X = “(-у); 

ѴѴ = (х = (у = 2)): 
д = а?Ь: (с?с1: (е?Г:д)); 

Причина в том, что унарные операторы, операторы присваивания и условные тер¬ 
нарные операторы имеют ассоциативность справа налево. 

4.7.7. Порядок вычисления 

Приоритет и ассоциативность операторов определяют порядок их выполнения 
в комплексных выражениях, но они не оказывают влияния на порядок вычисле¬ 
ний в подвыражениях. Выражения в языке ЛѵаЗсгірі всегда вычисляются слева 
направо. Например, в выражении ѵѵ=х+у*2 первым будет вычислено подвыраже¬ 
ние ѵѵ, затем х, у и 2. После этого будет выполнено умножение значений у и 2, затем 
сложение со значением х и результат будет присвоен переменной или свойству, 
определяемому выражением ѵі. Добавляя в выражения круглые скобки, можно 
изменить относительный порядок выполнения операций умножения, сложения 
и присваивания, но нельзя изменить общий порядок вычислений слева направо. 

Порядок вычисления имеет значение, только когда выражение имеет побочные 
эффекты, оказывающие влияние на значения других выражений. Если выраже¬ 
ние х увеличивает значение переменной, используемой в выражении 2, тогда тот 
факт, что х вычисляется раньше, чем 2, имеет большое значение. 

4.8. Арифметические выражения 

В этом разделе описываются операторы, выполняющие арифметические и другие 
операции с числами. Наиболее простыми из них являются операторы умножения, 
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деления и вычитания, поэтому они будут рассмотрены первыми. Оператор сложе¬ 
ния будет описан в собственном подразделе, потому что он также выполняет опе¬ 
рацию конкатенации строк и использует некоторые необычные правила преобра¬ 
зования типов. Унарные и поразрядные операторы также будут рассматриваться 
в отдельных подразделах. 

Основными арифметическими операторами являются * (умножение), / (деление), 
% (деление по модулю: остаток от деления), + (сложение) и - (вычитание). Как уже 
отмечалось, оператор + будет рассматриваться в отдельном разделе. Другие основ¬ 
ные четыре оператора просто определяют значения своих операндов, преобразу¬ 
ют их значения в числа, если это необходимо, и вычисляют произведение, част¬ 
ное, остаток или разность значений. Нечисловые операнды, которые не могут 
быть преобразованы в числа, преобразуются в значение №М. Если какой-либо из 
операндов имеет (или преобразуется в) значение №М, результатом операции так¬ 
же будет значение №І\І. 

Оператор / делит первый операнд на второй. Если вам приходилось работать с язы¬ 
ками программирования, в которых целые и вещественные числа относятся 
к разным типам, вы могли бы ожидать получить целый результат от деления од¬ 
ного целого числа на другое целое число. Однако в языке ^ѵа 8 сгірі все числа яв¬ 
ляются вещественными, поэтому все операции деления возвращают веществен¬ 
ный результат: выражение 5/2 вернет 2 .5, а не 2 . Деление на ноль возвращает поло¬ 
жительную или отрицательную бесконечность, тогда как выражение 0/0 возвра¬ 
щает №N 5 ни в одном из этих случаев не возбуждается исключение. 

Оператор % производит деление по модулю первого операнда на второй. Иными 
словами, он возвращает остаток от целочисленного деления первого операнда на 
второй. Знак результата определяется знаком первого операнда. Например, вы¬ 
ражение 5 % 2 вернет 1, а выражение -5 % 2 вернет -1. 

Несмотря на то что оператор по модулю обычно применяется к целым числам, он 
также может оперировать вещественными значениями. Например, выражение 
6.5 % 2.1 вернет 0,2. 

4.8.1. Оператор + 

Двухместный оператор + складывает числовые операнды или выполняет конка¬ 
тенацию строковых операндов: 

1+2 // => 3 

"Меііо" + " " + "ііМеге" // => "Ііеііо ІіМеге” 

" 1 " + " 2 " // => " 12 ” 

Когда значениями обоих операндов являются числа или строки, результат дейст¬ 
вия оператора + очевиден. Однако в других случаях возникает необходимость 
преобразования типов, а выполняемая операция зависит от результатов преобра¬ 
зований. В соответствии с правилами преобразований оператор + отдает предпоч¬ 
тение операции конкатенации строк: если один из операндов является строкой 
или объектом, который может быть преобразован в строку, другой операнд также 
преобразуется в строку, после чего выполняется операция конкатенации строк. 
Операция сложения выполняется, только если ни один из операндов не является 
строкой. 

Формально оператор + использует следующий алгоритм работы: 
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• Если значением любого из операндов является объект, он преобразуется в про¬ 
стое значение с использованием алгоритма преобразования объекта в простое 
значение, описанного в разделе 3.8.3: объекты Оаіе преобразуются с помощью 
их метода 1 :о 31 :гіпд( ), а все остальные объекты преобразуются с помощью мето¬ 
да ѵа 1 иеОГ(), если он возвращает простое значение. Однако большинство объ¬ 
ектов не имеют метода ѵаІиеОГО, поэтому они также преобразуются с помо¬ 
щью метода ІоЗігіпдО. 

• Если после преобразования объекта в простое значение любой из операндов 
оказывается строкой, другой операнд также преобразуется в строку и выпол¬ 
няется операция конкатенации. 

• В противном случае оба операнда преобразуются в числа (или в №N1) и выпол¬ 
няется операция сложения. 

Например: 


1 + 2 

•• -| •• ^ ** 2 " 

" 1 " + 2 
1 + {} 

Ігііе + ігие 
2 + пиіі 
2 + ипсіеііпесі 


// => 3: сложение 

// => "12": конкатенация 

// => "12": конкатенация после преобразования числа в строку 
// => "1[оЬ]ес1: О^есі:]": конкатенация после 

// преобразования объекта в строку 

// => 2: сложение после преобразования логического значения в число 

// => 2: сложение после преобразования пиіі в О 

// => №М: сложение после преобразования ипсіе^іпесі в 


Наконец, важно отметить, что, когда оператор + применяется к строкам и чис¬ 
лам, он может нарушать ассоциативность. То есть результат может зависеть от 
порядка, в каком выполняются операции. Например: 

1 + 2 + Ыіпсі тісе"; // => "3 Ыіпсі тісе" 

1 + (2 + Ыіпсі тісе"); // => ”12 Ыіпсі тісе" 


В первом выражении отсутствуют скобки и оператор + имеет ассоциативность 
слева направо, благодаря чему сначала выполняется сложение двух чисел, а их 
сумма объединяется со строкой. Во втором выражении порядок выполнения опе¬ 
раций изменен с помощью скобок: число 2 объединяется со строкой, давая в ре¬ 
зультате новую строку. А затем число 1 объединяется с новой строкой, что дает 
окончательный результат. 


4.8.2. Унарные арифметические операторы 

Унарные операторы изменяют значение единственного операнда и создают новое 
значение. Все унарные операторы в ^ѵа8сгірі имеют наивысший приоритет, 
и все они являются правоассоциативными. Все унарные арифметические опера¬ 
торы, описываемые в этом разделе (+, -, ++ и --), при необходимости преобразуют 
свой единственный операнд в число. Обратите внимание, что знаки пунктуации + 
и - используются как унарные и как двухместные операторы. 

Ниже перечислены унарные арифметические операторы: 

Унарный плюс (+) 

Оператор унарного плюса преобразует свой операнд в число (или в №М) и воз¬ 
вращает преобразованное значение. При использовании с числовым операн¬ 
дом он не выполняет никаких действий. 
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Унарный минус (-) 

Когда - используется как унарный оператор, он преобразует свой операнд 
в число, если это необходимо, и затем изменяет знак результата. 

Инкремент (++) 

Оператор ++ инкрементирует (т. е. увеличивает на единицу) свой единствен¬ 
ный операнд, который должен быть левосторонним выражением (переменной, 
элементом массива или свойством объекта). Оператор преобразует свой опе¬ 
ранд в число, добавляет к этому числу 1 и присваивает результат сложения об¬ 
ратно переменной, элементу массива или свойству. 

Значение, возвращаемое оператором ++, зависит от его положения по отноше¬ 
нию к операнду. Если поставить его перед операндом (префиксный оператор 
инкремента), то к операнду прибавляется 1, а результатом является увеличен¬ 
ное значение операнда. Если же он размещается после операнда (постфиксный 
оператор инкремента), то к операнду прибавляется 1, однако результатом яв¬ 
ляется первоначальное, неувеличенное значение операнда. Взгляните на раз¬ 
личия в следующих двух выражениях: 

ѵаг і = 1, і = ++і; //іи] содержат значение 2 

ѵаг і = 1, ] = і++; // і содержит значение 2, ] содержит значение 1 

Обратите внимание, что выражение ++х не всегда возвращает тот же результат, 
что и выражение х=х+1. Оператор ++ никогда не выполняет операцию конкате¬ 
нации строк: он всегда преобразует свой операнд в число и увеличивает его. 
Если х является строкой «1», выражение ++х вернет число 2, тогда как выраже¬ 
ние х+1 вернет строку «11». 

Отметьте также, что из-за автоматического добавления точки с запятой в язы¬ 
ке ЛѵаЗсгірі нельзя вставлять перевод строки между постфиксным операто¬ 
ром инкремента и его операндом. Если это сделать, интерпретатор ЛѵаЗсгірі 
будет рассматривать операнд как полноценную инструкцию и вставит после 
него точку с запятой. 

Данный оператор в обеих своих формах (префиксной и постфиксной) чаще все¬ 
го применяется для увеличения счетчика, управляющего циклом -Гог (раз¬ 
дел 5.5.3). 

Декремент (--) 

Оператор -- ожидает получить в качестве операнда левостороннее выражение. 
Он преобразует значение операнда в число, вычитает 1 и присваивает умень¬ 
шенное значение обратно операнду. Подобно оператору ++, точное поведение 
оператора -- зависит от его положения относительно операнда. Если он стоит 
перед операндом, то уменьшает операнд и возвращает уменьшенное значение; 
если оператор стоит после операнда, он уменьшает операнд, но возвращает 
первоначальное, неуменьшенное значение. При использовании постфиксной 
формы операнда не допускается вставлять перевод строки между оператором 
и операндом. 


4.8.3. Поразрядные операторы 

Поразрядные операторы выполняют низкоуровневые манипуляции с битами 
в двоичных представлениях чисел. Несмотря на то что они не выполняют ариф- 
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метические операции в традиционном понимании, тем не менее они относятся 
к категории арифметических операторов, потому что оперируют числовыми опе¬ 
рандами и возвращают числовое значение. Эти операторы редко исгіользуются 
в программировании на языке ^ѵаЗсгірі, и если вы не знакомы с двоичным 
представлением целых чисел, то можете пропустить этот раздел. Четыре из этих 
операторов выполняют поразрядные операции булевой алгебры над отдельными 
битами операндов и действуют так, как если бы каждый бит каждого операнда 
был представлен логическим значением (1= Іігие, 0=Га1зе). Три других поразряд¬ 
ных оператора применяются для сдвига битов влево и вправо. 

Поразрядные операторы работают с целочисленными операндами и действуют 
так, как если бы эти значения были представлены 32-битными целыми, а не 
64-битными вещественными значениями. При необходимости эти операторы пре¬ 
образуют свои операнды в числа и затем приводят числовые значения к 32-битным 
целым, отбрасывая дробные части и любые биты старше 32-го. Операторы сдвига 
требуют, чтобы значение правого операнда было целым числом от 0 до 31. После 
преобразования этого операнда в 32-битное беззнаковое целое они отбрасывают 
любые биты старше 5-го, получая число в соответствующем диапазоне. Самое ин¬ 
тересное, что эти операторы преобразуют значения №М, ІпГіпіІіу и -ІпГіпіІіу в 0. 

Поразрядное И (&) 

Оператор & выполняет операцию «логическое И» над каждым битом своих це¬ 
лочисленных аргументов. Бит результата устанавливается, если соответст¬ 
вующий бит установлен в обоих операндах. Например, выражение 0x1234 & 
ОхООРР даст в результате число 0x0034. 

Поразрядное ИЛИ (|) 

Оператор | выполняет операцию «логическое ИЛИ» над каждым битом своих 
целочисленных аргументов. Бит результата устанавливается, если соответст¬ 
вующий бит установлен хотя бы в одном операнде. Например, выражение 
0x1234 | ОхООРР даст в результате 0x12РР. 

Поразрядное исключающее ИЛИ (") 

Оператор ~ выполняет логическую операцию «исключающее ИЛИ» над каж¬ 
дым битом своих целочисленных аргументов. Исключающее ИЛИ означает, 
что должен быть истинен либо первый операнд, либо второй, но не оба сразу. 
Бит результата устанавливается, если соответствующий бит установлен в од¬ 
ном (но не в обоих) из двух операндов. Например, выражение ОхРРОО ~ ОхРОРО 
даст в результате 0x0РРО. 

Поразрядное НЕ (~) 

Оператор ~ представляет собой унарный оператор, указываемый перед своим 
единственным целым операндом. Он выполняет инверсию всех битов операн¬ 
да. Из-за способа представления целых со знаком в ЛѵаЗсгірі применение 
оператора ~ к значению эквивалентно изменению его знака и вычитанию 1. 
Например, выражение “ОхОГ даст в результате ОхРРРРРРРО, или -16. 

Сдвиг влево («) 

Оператор « сдвигает все биты в первом операнде влево на количество позиций, 
указанное во втором операнде, который должен быть целым числом в диапа¬ 
зоне от 0 до 31. Например, в операции а « 1 первый бит в а становится вторым 
битом, второй бит становится третьим и т. д. Новым первым битом становит- 
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ся ноль, значение 32-го бита теряется. Сдвиг значения влево на одну позицию 
эквивалентен умножению на 2, на две позиции - умножению на 4 и т. д. На¬ 
пример, выражение 7 « 2 даст в результате 28. 

Сдвиг вправо с сохранением знака (») 

Оператор » сдвигает все биты своего первого операнда вправо на количество 
позиций, указанное во втором операнде (целое между 0 и 31). Биты, сдвинутые 
за правый край, теряются. Самый старший бит не изменяется, чтобы сохра¬ 
нить знак результата. Если первый операнд положителен, старшие биты ре¬ 
зультата заполняются нулями; если первый операнд отрицателен, старшие 
биты результата заполняются единицами. Сдвиг значения вправо на одну по¬ 
зицию эквивалентен делению на 2 (с отбрасыванием остатка), сдвиг вправо на 
две позиции эквивалентен делению на 4 и т. д. Например, выражение 7 » 1 
даст в результате 3, а выражение -7 » 1 даст в результате -4. 

Сдвиг вправо с заполнением нулями (»>) 

Оператор »> аналогичен оператору », за исключением того, что при сдвиге 
старшие разряды заполняются нулями, независимо от знака первого операн¬ 
да. Например, выражение -1 » 4 даст в результате -1, а выражение -1 »> 4 
даст в результате ОХОРРРРРРР. 

4.9. Выражения отношений 

В этом разделе описаны операторы отношения в языке ЛѵаВсгірі. Это операторы 
проверяют отношение между двумя значениями (такое как «равно», «меньше» 
или «является ли свойством») и возвращают Ігие или ^аізе в зависимости от того, 
как соотносятся операнды. Выражения отношений всегда возвращают логиче¬ 
ские значения, и эти значения чаще всего применяются в инструкциях іТ, ѵѵШе 
и Рог для управления ходом исполнения программы (глава 5). В следующих под¬ 
разделах описываются операторы равенства и неравенства, операторы сравнения 
и два других оператора отношений, іп и іпзІапсеоР. 

4.9.1. Операторы равенства и неравенства 

Операторы == и === проверяют два значения на совпадение, используя два разных 
определения совпадения. Оба оператора принимают операнды любого типа и воз¬ 
вращают Ігие, если их операнды совпадают, и ^аізе, если они различны. Оператор 
===, известный как оператор идентичности, проверяет два операнда на «идентич¬ 
ность», руководствуясь строгим определением совпадения. Оператор ==, оператор 
равенства, проверяет, равны ли два его операнда в соответствии с менее строгим 
определением совпадения, допускающим преобразования типов. 

В языке ^ѵаВсгірі поддерживаются операторы =, == и ===. Убедитесь, что вы по¬ 
нимаете разницу между операторами присваивания, равенства и идентичности. 
Будьте внимательны и применяйте правильные операторы при разработке своих 
программ! Очень заманчиво назвать все три оператора «равно», но во избежание 
путаницы лучше читать оператор = как «получается», или «присваивается», опе¬ 
ратор == читать как «равно», а словом «идентично» обозначать оператор ===. 

Операторы ! = и ! == выполняют проверки, в точности противоположные операто¬ 
рам == и ===. Оператор неравенства != возвращает Раізе, если два значения равны 
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друг другу в том смысле, в каком они считаются равными оператором ==, и Ігие 
в противном случае. Как будет рассказываться в разделе 4.10, оператор ! выпол¬ 
няет логическую операцию НЕ. Отсюда легко будет запомнить, что операторы !- 
и ! == означают «не равно» и «не идентично». 

Как отмечалось в разделе 3.7, объекты в языке ^ѵаВсгірі сравниваются по ссыл¬ 
ке, а не по значению. Это значит, что объект равен только сам себе и не равен ни¬ 
какому другому объекту. Даже если два различных объекта обладают одним 
и тем же набором свойств, с теми же именами и значениями, они все равно будут 
считаться неравными. Два массива никогда не могут быть равными, даже если 
они содержат одинаковые элементы, следующие в одном порядке. 

Оператор идентичности === вычисляет значения своих операндов, а затем сравни¬ 
вает два значения, без преобразования типов, руководствуется следующими пра¬ 
вилами: 

• Если два значения имеют различные типы, они не идентичны. 

• Если оба операнда являются значением пиіі или ипсІеГіпесІ, они идентичны. 

• Если оба операнда являются логическим значением Ігие или оба являются ло¬ 
гическим значением Гаізе, они идентичны. 

• Если одно или оба значения являются значением №М, они не идентичны. Зна¬ 
чение никогда не бывает идентичным никакому значению, даже самому 
себе! Чтобы проверить, является ли значение х значением №М, следует исполь¬ 
зовать выражение х !== х. Значение - единственное, для которого такая 
проверка вернет Ігие. 

• Если оба значения являются числами с одним и тем же значением, они иден¬ 
тичны. Если один операнд имеет значение 0, а другой -0, они также идентичны. 

• Если оба значения являются строками и содержат одни и те же 16-битные зна¬ 
чения (подробности во врезке в разделе 3.2) в одинаковых позициях, они иден¬ 
тичны. Если строки отличаются длиной или содержимым, они не идентичны. 
Две строки могут иметь один и тот же смысл и одинаково выглядеть на экра¬ 
не, но содержать отличающиеся последовательности 16-битных значений. Ин¬ 
терпретатор ^ѵаЗсгірі не выполняет нормализацию символов Юникода, по¬ 
этому подобные пары строк не считаются операторами === и == ни равными, ни 
идентичными. Другой способ сравнения строк обсуждается в части III книги, 
в описании метода 51гіпд.1оса1еСотраге(). 

• Если оба значения ссылаются на один и тот же объект, массив или функцию, то 
они идентичны. Если они ссылаются на различные объекты (массивы или функ¬ 
ции), они не идентичны, даже если оба объекта имеют идентичные свойства. 

Оператор равенства == похож на оператор идентичности, но он использует менее 
строгие правила. Если значения операндов имеют разные типы, он выполняет 
преобразование типов и пытается выполнить сравнение: 

• Если два значения имеют одинаковый тип, они проверяются на идентичность, 
как было описано выше. Если значения идентичны, они равны; если они не 
идентичны, они не равны. 

• Если два значения не относятся к одному и тому же типу, оператор == все же 
может счесть их равными. При этом используются следующие правила и пре¬ 
образования типов: 
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• Если одно значение пиіі, а другое - ипсІе'РіпесІ, то они равны. 

• Если одно значение является числом, а другое - строкой, то строка преоб¬ 
разуется в число и выполняется сравнение с преобразованным значением! 

• Если какое-либо значение равно Ігие, оно преобразуется в 1 и сравнение 
выполняется снова. Если какое-либо значение равно ^аізе, оно преобразу¬ 
ется в 0 и сравнение выполняется снова. 

• Если одно из значений является объектом, а другое - числом или строкой, 
объект преобразуется в простой тип (как описывалось в разделе 3.8.3) и срав¬ 
нение выполняется снова. Объект преобразуется в значение простого типа 
либо с помощью своего метода ІюЗІгіпдО, либо с помощью своего метода 
ѵаІиеОІЧ ). Встроенные классы базового языка ЛѵаЗсгірі сначала пытаются 
выполнить преобразование ѵаІиеОШ, а затем ІюЗігіпдО, кроме класса йаііе, 
который всегда выполняет преобразование ІоЗІгіпдО. Объекты, не являю¬ 
щиеся частью базового ^ѵаЗсгірі, могут преобразовывать себя в значения 
простых типов способом, определенным их реализацией. 

• Любые другие комбинации значений не являются равными. 

В качестве примера проверки на равенство рассмотрим сравнение: 

"1" == 1: гие 

Результат этого выражения равен Ігие, т. е. эти по-разному выглядящие значения 
фактически равны. Логическое значение Ігие преобразуется в число 1, и сравне¬ 
ние выполняется снова. Затем строка "1" преобразуется в число 1. Поскольку оба 
числа теперь совпадают, оператор сравнения возвращает Ігие. 

4.9.2. Операторы сравнения 

Операторы сравнения определяют относительный порядок двух величин (число¬ 
вых или строковых): 

Меньше (<) 

Оператор < возвращает Ігие, если первый операнд меньше, чем второй операнд; 
в противном случае он возвращает ^аізе. 

Больше (>) 

Оператор > возвращает 1:гие, если его первый операнд больше, чем второй опе¬ 
ранд; в противном случае он возвращает ^аізе. 

Меньше или равно (<=) 

Оператор <= возвращает Ігие, если первый операнд меньше или равен второму 
операнду; в противном случае он возвращает ^аізе. 

Больше или равно (>=) 

Оператор >= возвращает Ігие, если его первый операнд больше второго или ра¬ 
вен ему; в противном случае он возвращает ^аізе. 

Эти операторы позволяют сравнивать операнды любого типа. Однако сравнение 
может выполняться только для чисел и строк, поэтому операнды, не являющие¬ 
ся числами или строками, преобразуются. Сравнение и преобразование выпол¬ 
няются следующим образом: 




96 


Глава 4. Выражения и операторы 


• Если какой-либо операнд является объектом, этот объект преобразуется в про¬ 
стое значение, как было описано в конце раздела 3.8.3: если метод ѵаІиеОГО 

# объекта возвращает простое значение, используется это значение. В против¬ 
ном случае используется значение, возвращаемое методом ІоЗігіпдО. 

• Если после преобразований объектов в простые значения оба операнда оказы¬ 
ваются строками, они сравниваются как строки в соответствии с алфавитным 
порядком, где под «алфавитным порядком» понимается числовой порядок 
16-битных значений кодовых пунктов Юникода, составляющих строки. 

• Если после преобразований объектов в простые значения хотя бы один опе¬ 
ранд не является строкой, оба операнда преобразуются в числа и сравнивают¬ 
ся как числа. Значения 0 и -0 считаются равными. Значение ІпГіпіІу считает¬ 
ся больше любого другого числа, а значение -ІпГіпіІу - меньше любого другого 
числа. Если какой-либо из операндов преобразуется в значение №М, то опера¬ 
тор сравнения всегда возвращает Гаізе. 

Не забывайте, что строки в ^ѵаВсгірі являются последовательностями 16-бит- 
ных целочисленных значений, и сравнение строк фактически сводится к число¬ 
вому сравнению этих значений в строках. Порядок кодирования символов, опре¬ 
деляемый стандартом Юникода, может не совпадать с традиционным алфавит¬ 
ным порядком, используемым в конкретных языках или регионах. Обратите 
внимание, что сравнение строк производится с учетом регистра символов и все 
прописные буквы в кодировке А8СІІ «меньше» соответствующих им строчных 
букв А8СІІ. Это правило может приводить к непонятным результатам. Напри¬ 
мер, согласно оператору < строка '7оо'' меньше строки "аагс^агк”. 

При сравнении строк более надежные результаты позволяет получить метод 
31гіпд.1оса1еСотраге(), который учитывает национальные определения «алфавит¬ 
ного порядка». Для сравнения без учета регистра необходимо сначала преобразо¬ 
вать строки в нижний или верхний регистр с помощью метода ЗІгіпд.ІоІ_о\л/егСазе( ) 
или ЗІгіпд.ііоиррегСазеО. 

Оператор + и операторы сравнения по-разному обрабатывают числовые и строко¬ 
вые операнды. Оператор + отдает предпочтение строкам: если хотя бы один из опе¬ 
рандов является строкой, он выполняет конкатенацию строк. Операторы сравне¬ 
ния отдают предпочтение числам и выполняют строковое сравнение, только ко¬ 
гда оба операнда являются строками: 

I + 2 // Сложение. Результат: 3. 

"1" + "2" // Конкатенация. Результат: "12". 

"1" +2 // Конкатенация. 2 преобразуется в "2". Результат: "12". 

II < 3 // Числовое сравнение. Результат: Гаізе. 

"11" < "3" // Строковое сравнение. Результат: Іігце. 

”11" < 3 // Числовое сравнение. "11" преобразуется в 11. Результат: Гаізе 

"опе" < 3 // Числовое сравнение, "опе" преобразуется в Результат: Гаізе. 

Наконец, обратите внимание, что операторы <= (меньше или равно) и >= (больше 
или равно) для определения «равенства» двух значений не используют операторы 
равенства или идентичности. Оператор «меньше или равно» определяется просто 
как «не больше», а оператор «больше или равно» - как «не меньше». Единствен¬ 
ное исключение имеет место, когда один из операндов представляет собой значе¬ 
ние (или преобразуется в него). В этом случае все четыре оператора сравнения 
возвращают Гаізе. 
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4.9.3. Оператор іп 

Оператор іп требует, чтобы левый операнд был строкой или мог быть преобразо¬ 
ван в строку. Правым операндом должен быть объект. Результатом оператора бу¬ 
дет значение ігие, если левое значение представляет собой имя свойства объекта, 
указанного справа. Например: 


ѵаг роіпі = { х:1, у: 1 }; // Определить объект 

"х" іп роіпі: // => 1:гие: объект имеет свойство с именем "х" 
" 2 " іп роіпі: // => іаізе: объект не имеет свойства с именем 
"іоЗігіпд" іп роіпі // => ігие: объект наследует метод іоЗігіпд 


ѵаг Раіа = [7,8,9]; 
"О" іп сіаіа 
1 іп сіаіа 
3 іп сіаіа 


// Массив с элементами 0, 1 и 2 
// => ігие: массив содержит элемент "О" 
// => ігие: числа преобразуются в строки 
// => іаізе: нет элемента 3 


4.9.4. Оператор іпзіапсеоі 

Оператор іпзіапсеоі требует, чтобы левым операндом был объект, а правым - имя 
класса объектов. Результатом оператора будет значение ігие, если объект, указан¬ 
ный слева, является экземпляром класса, указанного справа. В противном слу¬ 
чае результатом будет іаізе. В главе 9 рассказывается, что классы объектов в язы¬ 
ке ^ѵаВсгірі определяются инициализировавшей их функцией-конструктором. 
Следовательно, правый операнд оператора іпзіапсеоі должен быть именем функ¬ 
ции-конструктора. Например: 


ѵаг сі = пем Раіе(); 
сі іпзіапсеоі Раіе; 
сі іпзіапсеоі 0Ь]есі; 
сі іпзіапсеоі МілпЬег; 
ѵаг а = [1. 2, 3]; 
а іпзіапсеоі Аггау; 
а іпзіапсеоі ОЬіесі; 
а іпзіапсеоі ВедЕхр; 


// Создать новый объект с помощью конструктора Раіе() 

// Вернет ігие; объект сі был создан с функцией Раіе() 

// Вернет ігье; все объекты являются экземплярами ОЬ^есі 

// Вернет іаізе; сі не является объектом МитЬег 

// Создать массив с помощью литерала массива 

// Вернет ігье; а - это массив 

// Вернет ігие; все массивы являются объектами 

// Вернет іаізе; массивы не являются регулярными выражениями 


Обратите внимание, что все объекты являются экземплярами класса (ЭДесі. Оп¬ 
ределяя, является ли объект экземпляром класса, оператор іпзіапсеоі принимает 
во внимание и «суперклассы». Если левый операнд іпзіапсеоі не является объек¬ 
том, іпзіапсеоі возвращает іаізе. Если правый операнд не является функцией, 
возбуждается исключение ТуреЕггог. 

Чтобы понять, как действует оператор іпзіапсеоі, необходимо познакомиться с та¬ 
ким понятием, как «цепочка прототипов». Это - механизм наследования в Лѵа- 
Всгірі; он описывается в разделе 6.2.2. Чтобы вычислить значение выражения 
о іпзіапсеоі і, интерпретатор ^ѵаВсгірі определяет значение і.ргоіоіуре и затем 
пытается отыскать это значение в цепочке прототипов объекта о. В случае успеха 
объект о считается экземпляром класса і (или суперкласса класса і), и оператор 
возвращает ігие. Если значение і. ргоіоіуре отсутствует в цепочке прототипов объ¬ 
екта о, то объект о не является экземпляром класса і и оператор іпзіапсеоі возвра¬ 
щает іаізе. 
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4.10. Логические выражения 

Логические операторы &&, 11 и ! используются для выполнения операций булевой 
алгебры и часто применяются в сочетании с операторами отношений для объеди¬ 
нения двух выражений отношений в одно более сложное выражение. Эти опера¬ 
торы описываются в подразделах, следующих ниже. Чтобы понять, как они дей¬ 
ствуют, вам может потребоваться еще раз прочитать о концепции «истинности» 
и «ложности» значений в разделе 3.3. 

4.10.1. Логическое И (&&) 

Условно говоря, оператор && действует на трех уровнях. На самом простом уровне, 
когда в операции участвуют логические операнды, оператор && выполняет опера¬ 
цию «логическое И» над двумя значениями: он возвращает Ігие тогда и только 
тогда, когда оба операнда имеют значение Ігие. Если один или оба операнда име¬ 
ют значение ^аізе, оператор возвращает 1"а1зе. 

Оператор && часто используется для объединения двух выражений отношений: 

х == 0 && у == 0 // 1:гие тогда и только тогда, когда х и у равны О 

Выражения отношений всегда возвращают значение Іігие или ^аізе, поэтому в по¬ 
добных ситуациях сам оператор && всегда возвращает Іігие или ^аізе. Операторы 
отношений имеют более высокий приоритет, чем оператор && (и 11), поэтому такие 
выражения можно записывать без использования скобок. 

Но оператор && не требует, чтобы его операнды были логическими значениями. 
Напомню, что все значения в языке ^ѵаВсгірі являются либо «истинными», либо 
«ложными». (Подробности в разделе 3.3. Ложными значениями являются ^аізе, 
пиіі, ипсІе'ГіпесІ, О, -О, и Все другие значения, включая все объекты, являют¬ 
ся истинными.) На втором уровне оператор && действует как логическое И для ис¬ 
тинных и ложных значений. Если оба операнда являются истинными, оператор 
возвращает истинное значение. В противном случае, когда один или оба операнда 
являются ложными, возвращается ложное значение. В языке ^ѵаВсгірі все вы¬ 
ражения и инструкции, использующие логические значения, будут также рабо¬ 
тать с истинными или ложными значениями, поэтому тот факт, что оператор && 
не всегда возвращает Ігие или ^аізе, на практике не вызывает никаких проблем. 

Обратите внимание, что в предыдущем абзаце говорилось, что оператор возвра¬ 
щает «истинное значение» или «ложное значение», но при этом не уточнялось, 
какое именно значение возвращается. Для этого нам необходимо перейти на тре¬ 
тий, заключительный уровень оператора &&. Свою работу оператор начинает с вы¬ 
числения первого операнда - выражения слева. Если выражение слева возвраща¬ 
ет ложное значение, значением всего выражения также должно быть ложное зна¬ 
чение, поэтому оператор && просто возвращает значение слева и не вычисляет вы¬ 
ражение справа. 

В противном случае, если значение слева является истинным, тогда результат 
всего выражения определяется значением справа. Если значение справа является 
истинным, значением всего выражения также должно быть истинное значение, 
а если значение справа является ложным, значением всего выражения должно 
быть ложное значение. Поэтому, когда значение слева является истинным, опера¬ 
тор && вычисляет и возвращает значение справа: 
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ѵа г о = { х : 1 }; 
ѵаг р = пьП; 

о && о.х // => 1: о - истинное значение, поэтому возвращается о.х 

р && р.х // => пиіі: р - ложное значение, поэтому возвращается р, 

// а выражение р.х не вычисляется 

Важно понимать, что оператор && может не вычислять выражение правого опе¬ 
ранда. В примере выше переменная р имеет значение пиіі, поэтому попытка вы¬ 
числить выражение р.х привела бы к ошибке ТуреЕггог. Но здесь задействован опе¬ 
ратор &&, благодаря чему выражение р.х вычисляется, только если р будет содер¬ 
жать истинное значение - не пиіі или ипсІе'РіпесІ. 

Такое поведение оператора && иногда называют «короткой схемой вычислений», 
и иногда можно встретить программный код, в котором такое поведение операто¬ 
ра && используется специально для выполнения инструкций по условию. Напри¬ 
мер, следующие две строки дают одинаковый результат: 

ІГ (а == Ь) зІорО; // Функция зіорО вызывается, только если а == Ь 
(а == Ь) && з1іор(): // То же самое 

В целом следует с осторожностью использовать выражения с побочными эффек¬ 
тами (присваивания, инкременты, декременты или вызовы функций) справа от 
оператора &&, потому что эти побочные эффекты будут проявляться в зависимо¬ 
сти от значения слева. 

Несмотря на довольно запутанный алгоритм работы этого оператора, проще все¬ 
го и абсолютно безопасно рассматривать его как оператор булевой алгебры, кото¬ 
рый манипулирует истинными и ложными значениями. 

4.10.2. Логическое ИЛИ (||) 

Оператор || выполняет операцию «логическое ИЛИ» над двумя операндами. Если 
один или оба операнда имеют истинное значение, он возвращает истинное значе¬ 
ние. Если оба операнда имеют ложные значения, он возвращает ложное значение. 

Хотя оператор 11 чаще всего применяется просто как оператор «логическое ИЛИ», 
он, как и оператор &&, ведет себя более сложным образом. Его работа начинается 
с вычисления первого операнда, выражения слева. Если значение этого операнда 
является истинным, возвращается истинное значение. В противном случае опе¬ 
ратор вычисляет второй операнд, выражение справа, и возвращает значение это¬ 
го выражения. 

Как и при использовании оператора &&, следует избегать правых операндов, 
имеющих побочные эффекты, если только вы умышленно не хотите воспользо¬ 
ваться тем обстоятельством, что выражение справа может не вычисляться. 

Характерное использование этого оператора заключается в том, что он выбирает 
первое истинное значение из предложенного множества альтернатив: 

// Если переменная тах_\л/іс!1:И определена, используется ее значение. В противном случае 
// значение извлекается из объекта рге^егепсез. Если объект (или его свойство тах_\л/і1И) 
// не определен, используется значение константы, жестко определенной в тексте программы, 
ѵаг шах = тах_\ѵіс11:И || ргеГегепсез. тах_\ѵісІ1:И || 500: 

Этот прием часто используется в функциях для определения значений по умолча¬ 
нию параметров: 
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// Скопировать свойства объекта о в объект р и вернуть р 
ГипсГіоп сору(о, р) { 

р = р || {}; // Если объект р не был передан, создать новый объект. 

// реализация тела функции 

} 

4.10.3. Логическое НЕ (!) 

Оператор ! является унарным оператором, помещаемым перед одиночным опе¬ 
рандом. Он используется для инверсии логического значения своего операнда. 
Например, если переменная х имеет истинное значение, то выражение ! х возвра¬ 
щает значение Гаізе. Если х имеет ложное значение, то выражение !х возвращает 
значение Гаізе. 

В отличие от операторов && и 11, оператор ! преобразует свой операнд в логическое 
значение (используя правила, описанные в главе 3) перед тем, как инвертировать 
его. Это означает, что оператор ! всегда возвращает Ггие или Гаізе что всегда мож¬ 
но преобразовать любое значение х в его логический эквивалент, дважды приме¬ 
нив этот оператор: !! х (раздел 3.8.2). 

Будучи унарным, оператор ! имеет высокий приоритет и тесно связан с операн¬ 
дом. Если вам потребуется инвертировать значение выражения, такого как р && 
необходимо будет использовать круглые скобки: ! (р && ц). В булевой алгебре есть 
две теоремы, которые можно выразить на языке ^ѵаВсгірі: 

// Следующие две проверки на идентичность дают положительный результат 
// при любых значениях р и д 
!(р && д) === !р || !д 
!(Р II Р) === !р && !Ц 

4.11. Выражения присваивания 

Для присваивания значения переменной или свойству в языке ^ѵаВсгірі исполь¬ 
зуется оператор =. Например: 

і = 0 // Присвоит переменной і значение 0. 

о.х = 1 // Присвоит свойству х объекта о значение 1. 

Левым операндом оператора = должно быть левостороннее выражение: перемен¬ 
ная, элемент массива или свойство объекта. Правым операндом может быть любое 
значение любого типа. Значением оператора присваивания является значение пра¬ 
вого операнда. Побочный эффект оператора = заключается в присваивании значе¬ 
ния правого операнда переменной или свойству, указанному слева, так что при по¬ 
следующих обращениях к переменной или свойству будет получено это значение. 

Чаще всего выражения присваивания используются как самостоятельные ин¬ 
струкции; тем не менее иногда можно увидеть, как выражение присваивания 
включается в более сложные выражения. Например, в одном выражении можно 
совместить операции присваивания и проверки значения: 

(а = Ь) == О 

При этом следует отчетливо понимать, что между операторами = и == есть разни¬ 
ца! Обратите внимание, что оператор = имеет самый низкий приоритет, поэтому 
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обычно бывает необходимо использовать круглые скобки, если выражение при¬ 
сваивания используется в составе более сложного выражения. 

Оператор присваивания имеет ассоциативность справа налево, поэтому при на¬ 
личии в выражении нескольких операторов присваивания они вычисляются 
справа налево. Благодаря этому можно написать код, присваивающий одно зна¬ 
чение нескольким переменным, например: 

і = і = к = 0; // Инициализировать 3 переменные значением О 

4.11.1. Присваивание с операцией 

Помимо обычного оператора присваивания = в языке ^ѵаЗсгірі поддерживается 
несколько других операторов, объединяющих присваивание с некоторой другой 
операцией. Например, оператор += выполняет сложение и присваивание. Следую¬ 
щее выражение: 

Ііоііаі += 5а1ез_1:ах 

эквивалентно выражению: 

Іоііаі = Іоііаі + 5а1ез_1:ах 

Как можно было ожидать, оператор += работает и с числами, и со строками. Для 
числовых операндов он выполняет сложение и присваивание, а для строковых - 
конкатенацию и присваивание. 

Из подобных ему операторов можно назвать -=,*=,&= и др. Все операторы присваи¬ 
вания с операцией перечислены в табл. 4.2. 

Таблица 4.2. Операторы присваивания 


Оператор 

Пример 

Эквивалент 

+= 

а += Ь 

а = а + Ь 

-= 

II 

сг 

а = а - Ь 

* = 

а *= Ь 

а = а * Ь 

/= 

а /- Ь 

а = а / Ь 

%= 

а %= Ь 

а = а % Ь 

«= 

а «= Ь 

а = а « Ь 

»= 

а »= Ь 

а = а » Ь 

»>= 

а »>= Ь 

а = а »> Ь 

&= 

а &= Ь 

а = а & Ь 

1 = 

а |= Ь 

а = а | Ь 


а Ь 

а = а ~ Ь 


В большинстве случаев выражение: 

а ор- Ь 

где ор означает оператор, эквивалентно выражению: 

а = а ор Ь 
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В первой строке выражение а вычисляется только один раз. Во второй - дважды. 
Эти выражения отличаются, только если подвыражение а содержит операции, 
имеющие побочные эффекты, такие как вызов функции или оператор инкремен* 
та. Например, следующие два выражения присваивания неэквивалентны: 

сіа1:а[і++] *= 2; 
с!а1:а[і++] = с!а1:а[і++] * 2; 

4.12. Вычисление выражений 

Подобно многим интерпретирующим языкам, ^ѵаЗсгірі поддерживает возмож¬ 
ность интерпретации строк с программным кодом на языке ^ѵаЗсгірі, выпол¬ 
няя их, чтобы получить некоторое значение. В ^ѵаЗсгірі эта операция выполня¬ 
ется с помощью глобальной функции еѵа1( ): 

еѵа1( "3+2") // => 5 

Динамическое выполнение строк с программным кодом является мощной осо¬ 
бенностью языка, которая практически никогда не требуется на практике. Если 
у вас появится желание использовать функцию еѵа1(), задумайтесь - действи¬ 
тельно ли это необходимо. 

В подразделах ниже описываются основы использования функции еѵа1() и затем 
рассказывается о двух ее ограниченных версиях, которые оказывают меньше 
влияния на оптимизатор. 


еѵаІ() - функция или оператор? 

еѵа1() является функцией, но знакомство с ней включено в главу, описы¬ 
вающую операторы, потому что в действительности она должна была бы 
быть оператором. В самых ранних версиях языка еѵа1() определялась как 
функция, но с тех пор проектировщики языка и разработчики интерпрета¬ 
торов наложили на нее столько ограничений, что она стала больше похожа 
на оператор. Современные интерпретаторы ^ѵаЗсгірі детально анализиру¬ 
ют программный код и выполняют множество оптимизаций. Проблема 
функции еѵа1( ) заключается в том, что программный код, который она вы¬ 
полняет, в целом не доступен для анализа. Вообще говоря, если функция 
вызывает еѵа1(), интерпретатор не может оптимизировать эту функцию. 
Проблема с определением еѵа1() как функции заключается в том, что ей 
можно присвоить другие имена: 

ѵаг Г = еѵаі; 

ѵаг д = Г; 

Если допустить такую возможность, интерпретатор не сможет обеспечить 
безопасность оптимизации любых функций, вызывающих д(). Данной про¬ 
блемы можно было бы избежать, если бы еѵаі была оператором (и зарезер¬ 
вированным словом). С ограничениями, накладываемыми на функцию 
еѵа1(), которые делают ее более похожей на оператор, мы познакомимся 
в разделах ниже (разделы 4.12.2 и 4.12.3). 
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4.12.1. еѵаІ() 

Функция еѵа1() принимает единственный аргумент. Если передать ей значение, 
отличное от строки, она просто вернет это значение. Если передать ей строку, она 
попытается выполнить синтаксический анализ этой строки как программного 
кода на языке ^ѵаВсгірі и возбудит исключение ЗупІіахЕггог в случае неудачи. 
В случае успеха она выполнит этот программный код и вернет значение последне¬ 
го выражения или инструкции в строке либо значение ипсіе^іпесі, если последнее 
выражение или инструкция не имеют значения. Если программный код в строке 
возбудит исключение, функция еѵа1() передаст это исключение дальше. 

Ключевой особенностью функции еѵа1() (когда она вызывается таким способом) 
является то обстоятельство, что она использует окружение программного кода, 
вызвавшего ее. То есть она будет отыскивать значения переменных и определять 
новые переменные и функции, как это делает локальный программный код. Ес¬ 
ли функция определит локальную переменную х и затем вызовет еѵа1("х ”), она 
получит значение локальной переменной. Вызов еѵа1( "х=Т ) изменит значение ло¬ 
кальной переменной. А если выполнить вызов еѵа1("ѵа г у = 3; ”), будет объявлена 
новая локальная переменная у. Точно так же можно определять новые локальные 
функции: 

еѵа1("■рііпсіііоп ^() { геііигп х+1; }"); 

Если вызвать функцию еѵа1( ) из программного кода верхнего уровня, она, разуме¬ 
ется, будет оперировать глобальными переменными и глобальными функциями. 

Обратите внимание, что программный код в строке, передаваемой функции еѵа1( ), 
должен быть синтаксически осмысленным - эту функцию нельзя использовать, 
чтобы вставить фрагмент программного кода в вызывающую функцию. Напри¬ 
мер, бессмысленно писать вызов еѵа1(”ге1іигп;"), потому что инструкция геііигп до¬ 
пустима только внутри функций, а тот факт, что программный код в строке ис¬ 
пользует то же самое окружение, что и вызывающая функция, не делает его ча¬ 
стью этой функции. Если программный код в строке может расцениваться как 
самостоятельный сценарий (пусть и очень короткий, такой как х=0), его уже мож¬ 
но будет передавать функции еѵа1(). В противном случае еѵа1() возбудит исклю¬ 
чение ЗупІіахЕггог. 

4.12.2. Использование еѵаІ() в глобальном контексте 

Способность функции еѵа1() изменять локальные переменные представляет зна¬ 
чительную проблему для оптимизаторов Лѵабсгірі. Для ее решения некоторые 
интерпретаторы просто уменьшают степень оптимизации всех функций, вызы¬ 
вающих еѵа1( ). Однако как быть интерпретатору ^ѵабсгірі, когда в сценарии оп¬ 
ределяется псевдоним функции еѵа1( ) и выполняется ее вызов по другому имени? 
Чтобы облегчить жизнь разработчикам интерпретаторов ^ѵабсгірі, стандарт 
ЕСМАЗсгірІ 3 требует, чтобы такая возможность в интерпретаторах была запре¬ 
щена. Если функция еѵа1() вызывается под любым другим именем, отличным от 
«еѵаі», она должна возбуждать исключение ЕѵаІЕггог. 

Однако большинство разработчиков используют иные решения. При вызове под 
любым другим именем функция еѵа1() должна выполнять программный код 
в глобальном контексте. Выполняемый ею программный код может определять 
новые глобальные переменные или глобальные функции и изменять значения 
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глобальных переменных, но не может использоваться для модификации локаль¬ 
ных переменных в вызывающих функциях, благодаря чему устраняются пре¬ 
пятствия для локальной оптимизации. 

Стандарт ЕСМАЗсгірі 5 отменяет возбуждение исключения ЕѵаІЕггог и стандарти¬ 
зует поведение еѵа1(), сложившееся де-факто. «Прямой вызов» - это вызов функ¬ 
ции еѵа1( ) по ее непосредственному имени «еѵаі» (которое все больше начинает по¬ 
ходить на зарезервированное слово). Прямые вызовы еѵа1() используют окруже¬ 
ние вызывающего контекста. Любые другие вызовы - косвенные вызовы - в каче¬ 
стве окружения используют глобальный объект и не могут получать, изменять 
или определять локальные переменные или функции. Это поведение демонстри¬ 
руется в следующем фрагменте: 


ѵаг деѵаі = еѵаі; // 

ѵаг х = "дІоЬаІ", у = "дІоЬаІ"; // 

Гипсііоп Г() { // 

ѵаг х = "Іосаі"; // 

еѵа1("х += 'сИапдес! ';"); // 

геііігп х; // 

} 

Гітсііоп д() { // 

ѵаг у = "Іосаі"; // 

деѵа1("у += 'сИапдесГ ;"); // 

геіигп у; // 

} 


сопзоіе.1од(Г(), х); //Изменилась 
сопзоіе.Іод(д(), у); // Изменилась 


Другое имя еѵаі для вызова в глобальном контексте 
Две глобальные переменные 

Вызывает еѵаі в локальном контексте 
Определение локальной переменной 
Прямой вызов еѵаі изменит локальную переменную 
Вернет измененную локальную переменную 

Вызывает еѵаі в глобальном контексте 
Локальная переменная 

Косвенный вызов еѵаі изменит глоб. переменную 
Вернет неизмененную локальную переменную 

локальная переменная: выведет "ІосаІсПапдесІ дІоЬаІ": 
глобальная переменная: выведет "Іосаі дІоЬаІсПапдесГ : 


Обратите внимание, что обеспечение возможности вызывать функцию еѵа1() 
в глобальном контексте - это не просто попытка удовлетворить потребности оп¬ 
тимизатора. Фактически это чрезвычайно полезная особенность: она позволяет 
выполнять строки с программным кодом, как если бы они были независимыми 
сценариями. Как уже отмечалось в начале этого раздела, действительная необхо¬ 
димость выполнять строки программного кода на практике возникает очень ред¬ 
ко. Но если вы сочтете это необходимым, вам, скорее всего, потребуется вызывать 
функцию еѵа1( ) именно в глобальном контексте, а не в локальном. 

До появления версии ІЕ9 Іпіегпеі Ехріогег отличался от других броузеров: функ¬ 
ция еѵа1(), вызванная под другим именем, выполняла переданный ей программ¬ 
ный код не в глобальном контексте. (Однако она не возбуждала исключение 
ЕѵаІЕггог: программный код просто выполнялся ею в локальном контексте.) Но ІЕ 
определяет глобальную функцию ехесЗсгір1:(), которая выполняет строку с про¬ 
граммным кодом, переданную в виде аргумента, как если бы она была сценарием 
верхнего уровня. (Однако, в отличие от еѵа1(), функция ехесЗсгір1:() всегда воз¬ 
вращает пиіі.) 


4.12.3. Использование еѵаІ() в строгом режиме 

Строгий режим (раздел 5.7.3), определяемый стандартом ЕСМАЗсгірі 5, вводит до¬ 
полнительные ограничения на поведение функции еѵа1( ) и даже на использование 
идентификатора «еѵаі». Когда функция еѵа1() вызывается из программного кода, 
выполняемого в строгом режиме, или когда строка, которая передается функции. 
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начинается с директивы «изе зігісі», то еѵа1() выполняет программный код в ча¬ 
стном окружении. Это означает, что в строгом режиме выполняемый программ¬ 
ный код может обращаться к локальным переменным и изменять их, но он не мо¬ 
жет определять новые переменные или функции в локальной области видимости. 

Кроме того, строгий режим делает функцию еѵа1( ) еще более похожей на оператор, 
фактически превращая «еѵаі» в зарезервированное слово. В этом режиме нельзя 
переопределить функцию еѵа1( ) новым значением. А также нельзя объявить пере¬ 
менную, функцию, параметр функции или параметр блока саісН с именем «еѵаі». 

4.13. Прочие операторы 

^ѵаВсгірі поддерживает еще несколько операторов, которые описываются в сле¬ 
дующих разделах. 

4.13.1. Условный оператор (?:) 

Условный оператор - это единственный тернарный (с тремя операндами) опера¬ 
тор в ^ѵаЗсгірі, и иногда он так и называется - «тернарный оператор». Этот опе¬ 
ратор обычно записывается как ?:, хотя в программах он выглядит по-другому. 
Он имеет три операнда, первый предшествует символу ?, второй - между ? и :, 
третий - после :. Используется он следующим образом: 

х > 0 ? х : -х // Абсолютное значение х 

Операнды условного оператора могут быть любого типа. Первый операнд вычис¬ 
ляется и используется как логическое значение. Если первый операнд имеет ис¬ 
тинное значение, то вычисляется и возвращается значение выражения во втором 
операнде. Если первый операнд имеет ложное значение, то вычисляется и возвра¬ 
щается значение выражения в третьем операнде. Вычисляется всегда только ка¬ 
кой-то один операнд, второй или третий, и никогда оба. 

Тот же результат можно получить с помощью инструкции 1Т 9 но оператор ?: часто 
оказывается удобным сокращением. Ниже приводится типичный пример, в ко¬ 
тором проверяется, определена ли переменная (и имеет истинное значение), и ес¬ 
ли да, то берется ее значение, а если нет, берется значение по умолчанию: 

д гееіііпд = "Меііо " + (изегпате ? изегпате : "ІіМеге"); 

Эта проверка эквивалентна следующей конструкции іі 1 , но более компактна: 

дгееіііпд = "Меііо 
іТ (изегпате) 

дгееіііпд += изегпате; 

еізе 

дгееіііпд += "іМеге"; 

4.13.2. Оператор Іурео? 

Унарный оператор Ііурео'Г помещается перед единственным операндом, который 
может иметь любой тип. Его значением является строка, указывающая на тип 
данных операнда. Следующая таблица определяет значения оператора 1:урео1 = для 
всех значений, возможных в языке ^ѵаЗсгірі: 
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X 

Іуреоі х 

ипсІеГіпесІ 

"ипсІеГіпесГ 

* 

пиіі 

"оЬ^есІ:" 

Ггие или Гаізе 

"Ьооіеап" 

любое число или 

"питЬег" 

любая строка 

"зі: гіпд" 

любая функция 

"ГипсГіоп” 

любой объект базового языка, 
не являющийся функцией 

"оЬіесГ" 

любой объект среды выполнения 

Строка, содержимое которой зависит от реализации, 
ноне "ипсІеГіпесГ, "Ьооіеап", "питЬег" или "зі гіпд”. 


Оператор ГуреоГ может применяться, например, в таких выражениях: 

(ІіуреоГ ѵаіііе == ’зі:гіпд") ? . + ѵаіие + . : ѵаіие 

Оператор ІіуреоГ можно также использовать в инструкции з\л/і1ісГі (раздел 5.4.3). 
Обратите внимание, что операнд оператора ГуреоГ можно заключить в скобки, что 
делает оператор ГуреоГ более похожим на имя функции, а не на ключевое слово 
или оператор: 

ГуреоГ(і) 

Обратите внимание, что для значения пиіі оператор ГуреоГ возвращает строку 
«оЬ^есі». Если вам потребуется отличать пиіі от других объектов, добавьте про¬ 
верку для этого спецслучая. Для объектов, определяемых средой выполнения, 
оператор ГуреоГ может возвращать строку, отличную от «оЬ^есі». Однако на прак¬ 
тике большинство таких объектов в клиентском ^ѵаЗсгірі имеют тип «оЬіесі». 

Для всех объектных типов и типов массивов результатом оператора ГуреоГ явля¬ 
ется строка «оЬ^есі», поэтому он может быть полезен только для определения 
принадлежности значения к объектному или к простому типу. Чтобы отличить 
один класс объектов от другого, следует использовать другие инструменты, такие 
как оператор іпзГапсеоГ (раздел 4.9.4), атрибут сіазз (раздел 6.8.2) или свойство 
сопзГгисГог (разделы 6.8.1 и 9.2.2). 

Несмотря на то что функции в ^ѵаЗсгірі также являются разновидностью объек¬ 
тов, оператор ГуреоГ отличает функции, потому что они имеют собственные воз¬ 
вращаемые значения. В ЛѵаЗсгірі имеется тонкое отличие между функциями 
и «вызываемыми объектами». Функции могут вызываться, но точно так же мож¬ 
но создать вызываемый объект - который может вызываться подобно функции, - 
не являющийся настоящей функцией. В спецификации ЕСМАЗсгірі 3 говорится, 
что оператор ГуреоГ должен возвращать строку «Гипсііоп» для всех объектов базо¬ 
вого языка, которые могут вызываться. Спецификация ЕСМАВсгірі 5 расширяет 
это требование и требует, чтобы оператор ГуреоГ возвращал строку «ГипсГіоп» для 
всех вызываемых объектов, будь то объекты базового языка или среды выполне¬ 
ния. Большинство производителей броузеров для реализации методов своих объ¬ 
ектов среды выполнения используют обычные объекты-функции базового языка 
^ѵаЗсгірі. Однако корпорация МісгозоГі для реализации своих клиентских ме¬ 
тодов всегда использовала собственные вызываемые объекты, вследствие чего 
в версиях до ІЕ9 оператор ГуреоГ возвращает строку «оЬ^есі» для них, хотя они ве- 
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дут себя как функции. В версии ІЕ9 клиентские методы были реализованы как 
обычные объекты-функции базового языка. Подробнее об отличиях между ис¬ 
тинными функциями и вызываемыми объектами рассказывается в разделе 8.7.7. 


4.13.3. Оператор сіеіеіе 


Унарный оператор сіеіеііе выполняет попытку удалить свойство объекта или эле¬ 
мент массива, определяемый операндом. 1 Подобно операторам присваивания, ин¬ 
кремента и декремента, оператор сіеіеііе обычно используется ради побочного эф¬ 
фекта, выражающегося в удалении свойства, а не ради возвращаемого значения. 
Ниже приводятся несколько примеров его использования: 


ѵаг о = {х: 1, у: 2}; // Определить объект 

сіеіеііе о.х; // Удалить одно из его свойств 

"х" іп о // => І'аізе: свойство больше не существует 


ѵаг а = [1,2,3]; 
сіеіеііе а[2]; 

2 іп а 
а. ІепдііІ') 


// Создать массив 

// Удалить последний элемент массива 
// => 'Раізе: второй элемент больше не существует 
// => 3: обратите внимание, что длина массива при этом не изменилась 


Внимание: удаленное свойство или элемент массива не просто получает значение 
ипсІе'ГіпесІ. После удаления свойства оно прекращает свое существование. Попыт¬ 
ка прочитать значение несуществующего свойства возвратит значение ипсІе'ГіпесІ, 
но вы можете проверить фактическое наличие свойства с помощью оператора іп 
(раздел 4.9.3). Операция удаления элемента массива оставляет в массиве «дырку» 
и не изменяет длину массива. В результате получается разреженный массив. 

Оператор сіеіеііе требует, чтобы его операнд был левосторонним выражением. Ес¬ 
ли операнд не является левосторонним выражением, оператор не будет выпол¬ 
нять никаких действий и вернет значение Ігие. В противном случае сіеіеііе попы¬ 
тается удалить указанное левостороннее выражение. В случае успешного удале¬ 
ния значения левостороннего выражения оператор сіеіеііе вернет значение ігие. 
Не все свойства могут быть удалены: некоторые встроенные свойства из базового 
и клиентского языков ^ѵабсгірі устойчивы к операции удаления. Точно так же 
не могут быть удалены пользовательские переменные, объявленные с помощью 
инструкции ѵаг. Кроме того, невозможно удалить функции, объявленные с помо¬ 
щью инструкции Гипсіііоп, а также объявленные параметры функций. 

В строгом режиме, определяемом стандартом ЕСМАЗсгірі 5, оператор сіеіеііе воз¬ 
буждает исключение ЗупІахЕггог, если его операндом является неквалифициро¬ 
ванный идентификатор, такой как имя переменной, функции или параметра 
функции: он может оперировать только операндами, которые являются выраже¬ 
ниями обращения к свойству (раздел 4.4). Кроме того, строгий режим определя¬ 
ет, что оператор сіеіеііе должен возбуждать исключение ТуреЕггог, если запрошено 
удаление ненастраиваемого свойства (раздел 6.7). В обычном режиме в таких слу¬ 
чаях исключение не возбуждается, и оператор сіеіеііе просто возвращает І'аізе, 
чтобы показать, что операнд не был удален. 


1 Программистам на С++ следует обратить внимание, что сіеіеііе в ^ѵаЗсгірІ; совершенно 
не похож на сіеіеііе в С++. В ^ѵаЗсгірІ; освобождение памяти выполняется сборщиком 
мусора автоматически, и беспокоиться о явном освобождении памяти не надо. Поэтому 
в операторе сіеіеііе в стиле С++, удаляющем объекты без остатка, нет необходимости. 
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Ниже приводится несколько примеров использования оператора сіеіеііе: 


ѵаг о = {х: 1, 
сіеіеііе о.х; 
Іуреоі о.х; 
сіеіеііе о.х; 
сіеіеііе о; 

сіеіеііе 1; 
ГНіз.х = 1; 
сіеіеііе х; 

х; 


у:2}; // Определить переменную; инициализировать ее объектом 
// Удалить одно из свойств объекта; вернет Ггие 
// Свойство не существует; вернет "ипсІеГіпесІ" 

// Удалить несуществующее свойство; вернет Тгие 
// Объявленную переменную удалить нельзя; вернет Гаізе 
// В строгом режиме возбудит исключение. 

// Аргумент не является левосторонним выражением; вернет 1гие 
// Определить свойство глобального объекта без ѵаг 
// Удалить: вернет Ггие при выполнении в нестрогом режиме; в строгом 
// режиме возбудит исключение. Используйте 'сіеіеііе ГНіз.х' взамен. 
// Ошибка времени выполнения: переменная х не определена 


С оператором сіеіеііе мы снова встретимся в разделе 6.3. 


4.13.4. Оператор ѵоісі 

Унарный оператор ѵоісі указывается перед своим единственным операндом любо¬ 
го типа. Этот оператор редко используется и имеет необычное действие: он вычис¬ 
ляет значение операнда, затем отбрасывает его и возвращает ипсІеГіпесІ. Посколь¬ 
ку значение операнда отбрасывается, использовать оператор ѵоісі имеет смысл 
только ради побочных эффектов, которые дает вычисление операнда. 

Чаще всего этот оператор применяется в клиентском ЛѵаВсгірі, в адресах ИНЬ 
вида ^ѵаЗсгірГ:, где он позволяет вычислить выражение ради его побочных дей¬ 
ствий, не отображая в броузере вычисленное значение. Например, оператор ѵоісі 
можно использовать в НТМЬ-теге <а>: 

<а НгеГ=" іаѵазсгірГ : ѵоісі міпсіом. ореп(); ">0ткрыть новое окно</а> 

Эта разметка НТМЬ была бы более очевидна, если бы вместо ИНЬ заѵазсгірГ: при¬ 
менялся обработчик события опсііск, где в использовании оператора ѵоісі нет ни¬ 
какой необходимости. 


4.13.5. Оператор «запятая» (,) 

Оператор «запятая» (,) является двухместным оператором и может принимать 
операнды любого типа. Он вычисляет свой левый операнд, вычисляет свой пра¬ 
вый операнд и возвращает значение правого операнда. То есть следующая строка: 

і=0, і=1 , к=2; 

вернет значение 2 и практически эквивалентна строке: 

і = 0; і = 1; к = 2; 

Выражение слева вычисляется всегда, но его значение отбрасывается, поэтому 
применять оператор запятая имеет смысл только ради побочного эффекта левого 
операнда. Единственным типичным применением оператора запятая является 
его использование в циклах Гог (раздел 5.5.3) с несколькими переменными цикла: 

// Первая запятая ниже является частью синтаксиса инструкции ѵаг 

// Вторая запятая является оператором: она позволяет внедрить 2 выражения (і++ и ]--) 

// в инструкцию (цикл Гог), которая ожидает 1 выражение. 

Гог(ѵаг і=0,і=10; і < у, і++о — ) 
сопзоіе.1од(і+і ); 
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Инструкции 


В главе 4 выражения были названы фразами языка ^ѵаЗсгірі. По аналогии инст¬ 
рукции можно считать предложениями на языке ^ѵаЗсгірі, или командами. Как 
в обычном языке предложения завершаются и отделяются друг от друга точка¬ 
ми, так же и инструкции ^ѵаЗсгірі завершаются точками с запятой (раздел 2.5). 
Выражения вычисляются и возвращают значение, а инструкции выполняются , 
чтобы что-то происходило. 

Чтобы «что-то происходило», можно вычислить выражение, имеющее побочные 
эффекты. Выражения с побочными эффектами, такие как присваивание и вызо¬ 
вы функций, могут играть роль самостоятельных инструкций - при таком ис¬ 
пользовании их обычно называют инструкциями-выражениями . Похожую кате¬ 
горию инструкций образуют инструкции-объявления , которые объявляют новые 
переменные и определяют новые функции. 

Программы на языке ^ѵаЗсгірі представляют собой не более чем последователь¬ 
ности выполняемых инструкций. По умолчанию интерпретатор ^ѵаЗсгірі вы¬ 
полняет эти инструкции одну за другой в порядке их следования. Другой способ 
сделать так, чтобы «что-то происходило», заключается в том, чтобы влиять на 
этот порядок выполнения по умолчанию, для чего в языке ЛѵаЗсгірі имеется не¬ 
сколько инструкций, или управляющих конструкций, специально предназна¬ 
ченных для этого: 

• Условные инструкции , такие как і? и з\л/іі:сіп, которые заставляют интерпрета¬ 
тор ^ѵаЗсгірі выполнять или пропускать другие инструкции в зависимости 
от значения выражения. 

• Инструкции циклов , такие как мііііе и -Гог, которые многократно выполняют 
другие инструкции. 

• Инструкции переходов , такие как Ьгеак, геііигп и ІіИ го\л/, которые заставляют 
интерпретатор выполнить переход в другую часть программы. 

В разделах, следующих далее, описываются различные инструкции языка Л- 
ѵаЗсгірі и их синтаксис. Краткая сводка синтаксиса инструкций приводится 
в табл. 5.1, в конце главы. Программа на языке ^ѵаЗсгірі - это просто последо- 
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вательность инструкций, разделенных точками с запятой, поэтому, познакомив¬ 
шись с инструкциями ^ѵаЗсгірі, вы сможете писать программы на этом языке. 

• ^ 

5.1. Инструкции-выражения 

Простейший вид инструкций в ЛѵаЗсгірі - это выражения, имеющие побочные 
эффекты. (Загляните в раздел 5.7.3, где описывается инструкция-выражение, не 
имеющая побочных эффектов.) Инструкции такого рода мы рассматривали в гла¬ 
ве 4. Основной категорией инструкций-выражений являются инструкции при¬ 
сваивания. Например: 

дгееііпд = "Неііо " + пате; 
і *= 3; 

Операторы инкремента и декремента, ++ и -- схожи с инструкциями присваива¬ 
ния. Их побочным эффектом является изменение значения переменной, как при 
выполнении присваивания: 

соііп1:ег++; 

Оператор сіеіеііе имеет важный побочный эффект - он удаляет свойство объекта. 
Поэтому он почти всегда применяется как инструкция, а не как часть более слож¬ 
ного выражения: 

сіеіеііе о.х; 

Вызовы функций - еще одна большая категория инструкций-выражений. На¬ 
пример: 

аІегКдгееІіпд); 
ѵ\/іпсіо\л/. с1озе(); 

Эти вызовы клиентских функций являются выражениями, однако они имеют 
побочный эффект, заключающийся в воздействии на веб-броузер, поэтому также 
могут использоваться в качестве инструкций. Если функция не имеет каких-ли¬ 
бо побочных эффектов, нет смысла вызывать ее, если только она не является ча¬ 
стью более сложного выражения или инструкции присваивания. Например, ни¬ 
кто не станет просто вычислять косинус и отбрасывать результат: 

МаІИ. соз(х); 

Наоборот, надо вычислить значение и присвоить его переменной для дальнейше¬ 
го использования: 

сх = МаІИ. соз(х); 

Обратите внимание, что каждая строка в этих примерах завершается точкой с за¬ 
пятой. 

5.2. Составные и пустые инструкции 

Подобно оператору запятой (раздел 4.13.5), объединяющему несколько выраже¬ 
ний в одно выражение, блок инструкций позволяет объединить несколько инст¬ 
рукций в одну составную инструкцию . Блок инструкций - это просто последова- 
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тельность инструкций, заключенная в фигурные скобки. Таким образом, сле¬ 
дующие строки рассматриваются как одна инструкция и могут использоваться 
везде, где интерпретатор ^ѵаЗсгірі требует наличия единственной инструкции: 

{ 

х = МаТП. РІ; 

сх = МаТП.со$(х); 

сопзоіе. 1од("соз(я) = " + сх); 

} 

Здесь есть несколько аспектов, на которые следует обратить внимание. Во-пер¬ 
вых, составная инструкция не завершается точкой с запятой. Отдельные инст¬ 
рукции внутри блока завершаются точками с запятой, однако сам блок - нет. Во- 
вторых, строки внутри блока оформлены с отступами относительно фигурных 
скобок, окружающих их. Это не является обязательным требованием, но подоб¬ 
ное оформление программного кода упрощает его чтение и понимание. Наконец, 
напомню, что в языке ^ѵаЗсгірі не поддерживается область видимости блока, 
поэтому переменные, объявленные внутри блока, не являются частными по отно¬ 
шению к этому блоку (подробности смотрите в разделе 3.10.1). 

Объединение инструкций в более крупные блоки инструкций используется в язы¬ 
ке ^ѵаЗсгірі повсеместно. Подобно тому как выражения часто включают другие 
подвыражения, многие инструкции ^ѵаЗсгірі могут содержать другие инструк¬ 
ции. Формальный синтаксис языка ^ѵаЗсгірі обычно позволяет использовать не 
более одной подынструкции. Например, синтаксис инструкции цикла ѵМІе вклю¬ 
чает единственную подынструкцию, которая служит телом цикла. Блоки инст¬ 
рукций позволяют помещать любое количество инструкций там, где требуется 
наличие единственной подынструкции. 

Составные инструкции позволяют использовать множество инструкций там, где 
синтаксис ^ѵаЗсгірі допускает только одну инструкцию. Пустая инструкция 
действует противоположным образом: она позволяет не вставлять инструкции 
там, где они необходимы. Пустая инструкция имеет следующий вид: 


Встретив пустую инструкцию, интерпретатор ^ѵаЗсгірі не выполняет никаких 
действий. Пустая инструкция может оказаться полезной, когда требуется соз¬ 
дать цикл с пустым телом. Взгляните на следующий цикл "Гог (циклы -Гог будут 
рассматриваться в разделе 5.5.3): 

// Инициализировать массив а 

1 = ог(і = 0; і < а.ІепдІіИ; а[і++] = 0) ; 

В этом цикле вся работа выполняется выражением а[і++] = 0, и тело цикла здесь 
не требуется. Однако синтаксис ^ѵаЗсгірі требует, чтобы цикл имел тело, поэто¬ 
му здесь использована пустая инструкция - просто точка с запятой. 

Обратите внимание, что ошибочное добавление точки с запятой после закрываю¬ 
щей круглой скобки в инструкции -Гог, хѵітііе или іТ может вызывать появление 
досадных ошибок, которые сложно обнаружить. Например, следующий фраг¬ 
мент наверняка будет делать не совсем то, что предполагал автор: 

((а == 0) || (Ь == 0)); // 0й! Эта строка ничего не делает... 

о = пиіі; // а эта будет выполняться всегда. 
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Если вы собираетесь намеренно использовать пустую инструкцию, нелишним бу¬ 
дет добавить комментарий, поясняющий ваши намерения. Например: 

Гог(і = 0; і < а. ІепдТГі ; а[і++] = 0) /* пустое тело цикла */ ; 


5.3. Инструкции-объявления 

Инструкции ѵаг и ГипсТіоп являются инструкциями-объявлениями - они объ¬ 
являют, или определяют, переменные и функции. Эти инструкции определяют 
идентификаторы (имена переменных и функций), которые могут использоваться 
повсюду в программе, и присваивают значения этим идентификаторам. Инструк¬ 
ции-объявления сами ничего особенного не делают, но, создавая переменные 
и функции, они в значительной степени определяют значение других инструкций 
в программе. 

В подразделах, следующих ниже, описываются инструкции ѵагиГипс1:іоп,но они 
не дают исчерпывающего описания переменных и функций. Более подробная ин¬ 
формация о переменных приводится в разделах 3.9 и 3.10, а полное описание 
функций - в главе 8. 


5.3.1. Инструкция ѵаг 

Инструкция ѵаг позволяет явно объявить одну или несколько переменных. Инст¬ 
рукция имеет следующий синтаксис: 

ѵаг имя_1 [ = значение_1 ] [ . имя_п [= значение_п]] 


За ключевым словом ѵаг следует список объявляемых переменных через запя¬ 
тую; каждая переменная в списке может иметь специальное выражение-инициа¬ 
лизатор, определяющее ее начальное значение. Например: 


ѵаг і; 
ѵаг ] = 0; 
ѵаг р, ц\ 

ѵаг дгееіііпд = "Ііеііо" + пате; 
ѵаг х = 2.34, у = МаІіГі.соз(0.75), г, 
ѵаг х = 2, у = х*х; 
ѵаг х = 2, 

Г = Гипсіііоп(х) { геііигп х*х }, 

У = ^(х); 


// Одна простая переменная 
// Одна переменная, одно значение 
// Две переменные 
// Сложный инициализатор 
ІіГіеІіа; // Множество переменных 

// Вторая переменная использует первую 
// Множество переменных. .. 

// каждая определяется 
// в отдельной строке 


Если инструкция ѵаг находится внутри тела функции, она определяет локальные 
переменные, видимые только внутри этой функции. При использовании в про¬ 
граммном коде верхнего уровня инструкция ѵаг определяет глобальные перемен¬ 
ные, видимые из любого места в программе. Как отмечалось в разделе 3.10.2, гло¬ 
бальные переменные являются свойствами глобального объекта. Однако, в отли¬ 
чие от других глобальных свойств, свойства, созданные с помощью инструкции 
ѵаг, нельзя удалить. 

Если в инструкции ѵаг начальное значение переменной не указано, то перемен¬ 
ная определяется, однако ее начальное значение остается неопределенным (ипсіе- 
■Гіпесі). Как описывалось в разделе 3.10.1, переменные определены во всем сцена¬ 
рии или в функции, где они были объявлены, - их объявления «поднимаются» 
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в начало сценария или функции. Однако инициализация переменной произво¬ 
дится в той точке пррграммы, где находится инструкция ѵаг, а до этого перемен¬ 
ная имеет значение ипсІе'ГіпесІ. 

Обратите внимание, что инструкция ѵаг может также являться частью циклов 
■Гог и І^ог/іп. (Объявления этих переменных так же поднимаются в начало сцена¬ 
рия или функции, как и объявления других переменных вне цикла.) Ниже по¬ 
вторно приводятся примеры из раздела 3.9: 

1"ог(ѵаг і = 0; і < 10; і++) сопзоіе.1од(і); 

1"ог(ѵаг і = 0, ]=10; і < 10; і++.3--) сопзоіе. 1од(і*^); 

1"ог(ѵаг і іп о) сопзоіе. Іод(і); 

Отметьте также, что допускается несколько раз объявлять одну и ту же перемен¬ 
ную. 

5.3.2. Инструкция іипсііоп 

Ключевое слово ^ипсіііоп в языке ЛаѵаЗсгірі используется для определения функ¬ 
ций. В разделе 4.3 мы уже встречались с выражением определения функции. Но 
функции можно также определять в форме инструкций. Взгляните на следую¬ 
щие две функции: 

ѵаг Т = ■Рипс1:іоп(х) { геіигп х+1; } // Выражение присваивается переменной 
"Гипсі;іоп 1"(х) { геііігп х+1; } // Инструкция включает имя переменной 

Объявление функции в форме инструкции имеет следующий синтаксис: 

^ипсі;іоп имя_функции([арг1 [,арг2 [..., аргп ]]]) { 
инструкции 

} 

Здесь имя_функции - это идентификатор, определяющий имя объявляемой функ¬ 
ции. За именем функции следует заключенный в скобки список имен аргумен¬ 
тов, разделенных запятыми. Эти идентификаторы могут использоваться в теле 
функции для ссылки на значения аргументов, переданных при вызове функции. 

Тело функции состоит из произвольного числа ЛаѵаЗсгірі-инструкций, заклю¬ 
ченных в фигурные скобки. Эти инструкции не выполняются при определении 
функции. Они просто связываются с новым объектом функции для выполнения 
при ее вызове. Обратите внимание, что фигурные скобки являются обязательной 
частью инструкции "Гипсіііоп. В отличие от блоков инструкций в циклах мШе 
и в других конструкциях, тело функции требует наличия фигурных скобок, да¬ 
же если оно состоит только из одной инструкции. 

Ниже приводится несколько примеров определений функций: 

І^ипсі;іоп ЬуроІіепизеСх, у) { 

геіигп МаіИ.зрг1;(х*х + у*у); // Инструкция геіигп описывается далее 

} 

^ипсііоп ^асіогіаі(п) { 
і? (п <= 1) геіигп 1; 

геіигп п * ^асіогіаі(п 

} 

Инструкции объявления функций могут находиться в Лаѵа8сгірі-коде верхнего 
уровня или быть вложенными в определения других функций, но только на 


// Рекурсивная функция 

- 1 ); 
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«верхнем уровне», т. е. объявления функций не могут находиться внутри инст¬ 
рукций іГ, циклов мПіІе или любых других конструкций. Из-за такого ограниче¬ 
ния, накладываемого на объявления функций, спецификация ЕСМАЗсгірі не 
относит объявления функций к истинным инструкциям. Некоторые реализации 
ЛаѵаЗсгірі позволяют вставлять объявления функций в любые инструкции, но 
разные реализации по-разному обрабатывают эти случаи, поэтому включение 
объявлений функций в другие инструкции снижает переносимость программ. 

Инструкция объявления функции отличается от выражения тем, что она вклю¬ 
чает имя функции. Обе формы создают новый объект функции, но инструкция 
объявления функции при этом объявляет имя функции - переменную, которой 
присваивается объект функции. Подобно переменным, объявляемым с помощью 
инструкции ѵаг, объявления функций, созданные с помощью инструкции Гипсііі- 
оп, неявно «поднимаются» в начало содержащего их сценария или функции, по¬ 
этому они видимы из любого места в сценарии или функции. Однако при исполь¬ 
зовании инструкции ѵаг поднимается только объявление переменной, а инициа¬ 
лизация остается там, куда ее поместил программист. В случае же с инструкцией 
Гипсіііоп поднимается не только имя функции, но и ее тело: все функции в сцена¬ 
рии или все функции, вложенные в функцию, будут объявлены до того, как нач¬ 
нется выполнение программного кода. Это означает, что функцию можно вызвать 
еще до того, как она будет объявлена. 

Подобно инструкции ѵаг, инструкции объявления функций создают переменные, 
которые невозможно удалить. Однако эти переменные доступны не только для 
чтения - им можно присвоить другие значения. 

5.4. Условные инструкции 

Условные инструкции позволяют пропустить или выполнить другие инструкции 
в зависимости от значения указанного выражения. Эти инструкции являются 
точками принятия решений в программе, и иногда их также называют инструк¬ 
циями «ветвления». Если представить, что программа - это дорога, а интерпрета¬ 
тор ЛаѵаЗсгірі - путешественник, идущий по ней, то условные инструкции мож¬ 
но представить как перекрестки, где программный код разветвляется на две или 
более дорог, и на таких перекрестках интерпретатор должен выбирать, по какой 
дороге двигаться дальше. 

В подразделах ниже описывается основная условная инструкция языка Лѵа- 
Зсгірі - инструкция ііуеізе, а также более сложная инструкция змііісП, позволяю¬ 
щая создавать множество ответвлений. 

5.4.1. Инструкция \і 

Инструкция ІТ - это базовая управляющая инструкция, позволяющая интерпре¬ 
татору ЛаѵаЗсгірі принимать решения или, точнее, выполнять инструкции в за¬ 
висимости от условий. Инструкция имеет две формы. Первая: 

( выражение) 
инструкция 

В этой форме сначала вычисляется выражение. Если полученный результат являет¬ 
ся истинным, то инструкция выполняется. Если выражение возвращает ложное зна- 
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чение, то инструкция не выполняется. (Определения истинных и ложных значений 
приводятся в разделе 3.3.) Например: 

ІТ (и$егпате == піііі) // Если переменная изегпате равна піЛІ или ипсіеі'іпесі, 

изегпате = "ОоПп Оое"; // определить ее 

Аналогично: 

// Если переменная изегпате равна пиіі, ипсіе^іпесі, 0, "" или МаМ , 

// присвоить ей новое значение. 

И (!изегпате) изегпате = "ОоПп Оое"; 

Обратите внимание, что скобки вокруг условного выражения являются обяза¬ 
тельной частью синтаксиса инструкции іТ. 

Синтаксис языка ЛаѵаЗсгірі позволяет вставить только одну инструкцию после 
инструкции іТ и выражения в круглых скобках, однако одиночную инструкцию 
всегда можно заменить блоком инструкций. Поэтому инструкция і? может вы¬ 
глядеть так: 

і? (іасісігезз) { 
асісігезз = 

теззаде = "Пожалуйста, укажите почтовый адрес."; 

} 

Вторая форма инструкции іТ вводит конструкцию еізе, выполняемую в тех слу¬ 
чаях, когда выражение возвращает ложное значение. Ее синтаксис: 

( выражение) 
инструкция 1 

еізе 

инструкция2 

Эта форма инструкции выполняет инструкциюі , если выражение возвращает истинное 
значение, и инструкцию2 , если выражение возвращает ложное значение. Например: 


11= (п == 1) 

сопзоіе.Іод ("Получено 1 новое сообщение."); 

еізе 

сопзоіе.Іод ("Получено " + п + " новых сообщений."); 

При наличии вложенных инструкций іТ с блоками еізе требуется некоторая ос¬ 
торожность - необходимо гарантировать, что еізе относится к соответствующей 
ей инструкции іТ. Взгляните на следующие строки: 

і = і = 1; 

к = 2; 

М (і == І) 
іі 1 (3 == к) 

сопзоіе.1од("і равно к"); 

еізе 

сопзоіе. 1од("і не равно У); // НЕПРАВИЛЬНО!! 

В этом примере внутренняя инструкция іТ является единственной инструкцией, 
вложенной во внешнюю инструкцию ІТ. К сожалению, неясно (если исключить 
подсказку, которую дают отступы), к какой инструкции іб относится блок еізе. 
А отступы в этом примере выставлены неправильно, потому что в действительно¬ 
сти интерпретатор ЛаѵаВсгірі интерпретирует предыдущий пример так: 
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і* (і == Я { 

ІГ (] == к) 

сопзоіе. ІодС'і равно к"); • 

еізе 

сопзоіе.ІодС'і не равно // Вот как! 

} 

Согласно правилам ЛаѵаЗсгірі (и большинства других языков программирова¬ 
ния), конструкция еізе является частью ближайшей к ней инструкции ІГ. Чтобы 
сделать этот пример менее двусмысленным и более легким для чтения, понима¬ 
ния, сопровождения и отладки, надо поставить фигурные скобки: 

11= (і == І) { 
іі= а == к) { 

сопзоІе.ІодС'і равно к"); 

} 

} 

еізе { // Вот какая разница возникает из-за добавления фигурных скобок! 
сопзоІе.ІодС'і не равно 

} 

Хотя этот стиль и не используется в данной книге, тем не менее многие програм¬ 
мисты заключают тела инструкций ІГ и еізе (а также других составных инструк¬ 
ций, таких как циклы \л/Пі1е) в фигурные скобки, даже когда тело состоит только 
из одной инструкции. Последовательное применение этого правила поможет из¬ 
бежать неприятностей, подобных только что описанной. 

5.4.2. Инструкция еІ$е ІГ 

Инструкция іГ/еІзе вычисляет значение выражения и выполняет тот или иной 
фрагмент программного кода, а зависимости от результата. Но что если требуется 
выполнить один из многих фрагментов? Возможный способ сделать это состоит 
в применении инструкции еізе ІГ. Формально она не является самостоятельной 
инструкцией ЛаѵаЗсгірі; это лишь распространенный стиль программирования, 
заключающийся в применении повторяющихся инструкций іГ/еІзе: 

ІГ (п == 1) { 

// Выполнить блок 1 

} 

еізе ІГ (п == 2) { 

// Выполнить блок 2 

} 

еізе ІГ (п == 3) { 

// Выполнить блок 3 

} 

еізе { 

// Если ни одна из предыдущих инструкций еізе не была выполнена, выполнить блок 4 

} 

В этом фрагменте нет ничего особенного. Это просто последовательность инструк¬ 
ций ІГ, где каждая инструкция ІГ является частью конструкции еізе предыду¬ 
щей инструкции. Стиль еізе ІГ предпочтительнее и понятнее записи в синтакси¬ 
чески эквивалентной форме, полностью показывающей вложенность инструк¬ 
ций: 
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ІГ (п == 1) { 

// Выполнить блок 1 

} 

еізе { 

11= (п == 2 ) { 

// Выполнить блок 2 

} 

еізе { 

і* (п == 3) { 

// Выполнить блок 3 

} 

еізе { 

// Если ни одна из предыдущих инструкций еізе 
// не была выполнена, выполнить блок 4 

} 

} 

} 

5.4.3. Инструкция зѵѵіісіі 

Инструкция іб создает ветвление в потоке выполнения программы, а многопо¬ 
зиционное ветвление можно реализовать посредством нескольких инструкций 
еізе ІТ. Однако это не всегда наилучшее решение, особенно если все ветви зависят 
от значения одного и того же выражения. В этом случае расточительно повторно 
вычислять значение одного и того же выражения в нескольких инструкциях іб. 

Инструкция зѵуііісИ предназначена именно для таких ситуаций. За ключевым сло¬ 
вом зѵѵіІісП следует выражение в скобках и блок кода в фигурных скобках: 

5ѵііІси( выражение) { 
инструкции 

} 

Однако полный синтаксис инструкции зѵуііісіп более сложен, чем показано здесь. 
Различные места в блоке помечены ключевым словом сазе, за которым следует 
выражение и символ двоеточия. Ключевое слово сазе напоминает инструкцию 
с меткой за исключением того, что оно связывает инструкцию с выражением, а не 
с именем. Когда выполняется инструкция зѵуііісИ, она вычисляет значение выраже¬ 
ния ', а затем ищет метку сазе, соответствующую этому значению (соответствие оп¬ 
ределяется с помощью оператора идентичности ===). Если метка найдена, выпол¬ 
няется блок кода, начиная с первой инструкции, следующей за меткой сазе. Если 
метка сазе с соответствующим значением не найдена, выполнение начинается 
с первой инструкции, следующей за специальной меткой сіе^аиіі: :. Если метка 
сіебаиіі:: отсутствует, блок инструкции змііісН пропускается целиком. 

Работу инструкции зѵѵііісП сложно объяснить на словах, гораздо понятнее выгля¬ 
дит объяснение на примере. Следующая инструкция зѵѵіІісН эквивалентна повто¬ 
ряющимся инструкциям ііуеізе, показанным в предыдущем разделе: 

з\л/і1:сб(п) { 

сазе 1: // Выполняется, если п === 1 

// Выполнить блок 1. 

Ьгеак; // Здесь остановиться 
сазе 2: // Выполняется, если п === 2 
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// Выполнить блок 2. 

Ьгеак; // Здесь остановиться 
сазе 3: // Выполняется, если п === 3 

// Выполнить блок 3. 

Ьгеак; // Здесь остановиться 
сіеГаиІІі: // Если все остальное не подходит... 

// Выполнить блок 4. 

Ьгеак; // Здесь остановиться 

} 

Обратите внимание на ключевое слово Ьгеак в конце каждого блока сазе. Инструк¬ 
ция Ьгеак, описываемая далее в этой главе, приводит к передаче управления в ко¬ 
нец инструкции зѵѵіІісЬ и продолжению выполнения инструкций, следующих да¬ 
лее. Конструкции сазе в инструкции зѵѵііісЬ задают только начальную точку вы¬ 
полняемого программного кода, но не задают никаких конечных точек. В случае 
отсутствия инструкций Ьгеак инструкция зѵѵііісЬ начнет выполнение блока кода 
с меткой сазе, соответствующей значению выражения , и продолжит выполнение ин¬ 
струкций до тех пор, пока не дойдет до конца блока. В редких случаях это полез¬ 
но для написания программного кода, который переходит от одной метки сазе 
к следующей, но в 99% случаев следует аккуратно завершать каждый блок сазе 
инструкцией Ьгеак. (При использовании зѵѵііісЬ внутри функции вместо Ьгеак мож¬ 
но использовать инструкцию геііигп. Обе эти инструкции служат для завершения 
работы инструкции зѵѵііісЬ и предотвращения перехода к следующей метке сазе.) 

Ниже приводится более практичный пример использования инструкции змгЬсЬ; 
он преобразует значение в строку способом, зависящим от типа значения: 

^ипсПоп сопѵегіі(х) { 

5\л/і1ісЬ(4іуреоГ х) { 

сазе ’питЬег': // Преобразовать число в шестнадцатеричное целое 

геііигп х. ІіоЗі:гіпд(16); 

сазе 'зіігіпд': // Вернуть строку, заключенную в кавычки 

геііигп '+ х + '"'; 

сІеГаиІІі : // Любой другой тип преобразуется обычным способом 

геіюгп х. ІіоЗІігіпд( ) 

} 

} 

Обратите внимание, что в двух предыдущих примерах за ключевыми словами 
сазе следовали числа или строковые литералы. Именно так инструкция зѵѵііісЬ ча¬ 
ще всего используется на практике, но стандарт ЕСМАЗсгірі позволяет указы¬ 
вать после сазе произвольные выражения. 

Инструкция зѵѵііісЬ сначала вычисляет выражение после ключевого слова зѵѵііісЬ, 
а затем выражения сазе в том порядке, в котором они указаны, пока не будет най¬ 
дено совпадающее значение. 1 Факт совпадения определяется с помощью оператора 


1 Тот факт, что выражения в метках сазе вычисляются во время выполнения програм¬ 
мы, существенно отличает инструкцию зѵѵііісЬ в языке ^ѵаЗсгірі (и делает ее менее эф¬ 
фективной) от инструкции зѵѵііісЬ в С, С++ и ^ѵа. В этих языках выражения сазе долж¬ 
ны быть константами, вычисляемыми на этапе компиляции, и иметь один тот же тип. 
Кроме того, инструкция зѵѵііісЬ в этих языках часто может быть реализована с исполь¬ 
зованием высокоэффективной таблицы переходов . 
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идентичности ===, а не с помощью оператора равенства ==, поэтому выражения 
должны совпадать без какого-либо преобразования типов. 

Поскольку при каждом выполнении инструкции зѵѵііісв вычисляются не все вы¬ 
ражения сазе, следует избегать использования выражений сазе, имеющих побоч¬ 
ные эффекты, такие как вызовы функций и присваивания. Безопаснее всего ог¬ 
раничиваться в выражениях сазе константными выражениями. 

Как объяснялось ранее, если ни одно из выражений сазе не соответствует выра¬ 
жению з\ѵі1:сИ, инструкция змііісв начинает выполнение с инструкции с меткой 
сІе'ГаиІІ: :. Если метка сіе'ГаиІІ: : отсутствует, тело инструкции з\ѵі1:сИ полностью про¬ 
пускается. Обратите внимание, что в предыдущих примерах метка сІе'ГаиІІ:: ука¬ 
зана в конце тела инструкции зѵѵііісП после всех меток сазе. Это логичное и обыч¬ 
ное место для нее, но на самом деле она может располагаться в любом месте внут¬ 
ри инструкции 5\л/і1:сН. 

5.5. Циклы 

Чтобы понять действие условных инструкций, мы предлагали представить их 
в виде разветвлений на дороге, по которой двигается интерпретатор ЛѵаЗсгірі. 
Инструкции циклов можно представить как разворот на дороге, возвращающий 
обратно, который заставляет интерпретатор многократно проходить через один 
и тот же участок программного кода. В языке ЛаѵаЗсгірі имеется четыре инст¬ 
рукции циклов: \л/Ні1е, сіо/\л/Ні1е, 1 : ог и -Гог/іп. Каждому из них посвящен один из 
следующих подразделов. Одно из обычных применений инструкций циклов - об¬ 
ход элементов массива. Эта разновидность циклов подробно обсуждается в разде¬ 
ле 7.6, где также рассматриваются специальные методы итераций класса Аггау. 

5.5.1. Инструкция ѵѵНіІе 

Инструкция іГ является базовой условной инструкцией в языке ЛаѵаЗсгірі, а ба¬ 
зовой инструкцией циклов для ЛаѵаЗсгірі можно считать инструкцию ѵуИііѳ. Она 
имеет следующий синтаксис: 

ѵѵііііе ( выражение) 
инструкция 

Инструкция ѵуГіііѳ начинает работу с вычисления выражения . Если это выражение 
имеет ложное значение, интерпретатор пропускает инструкцию , составляющую те¬ 
ло цикла, и переходит к следующей инструкции в программе. Если выражение 
имеет истинное значение, то выполняется инструкция , образующая тело цикла, за¬ 
тем управление передается в начало цикла и выражение вычисляется снова. Ины¬ 
ми словами, интерпретатор снова и снова выполняет инструкцию тела цикла, пока 
(дѵЬіІе) значение выражения остается истинным. Обратите внимание, что имеется 
возможность организовать бесконечный цикл с помощью синтаксиса \л/Ше(1:гие). 

Обычно не требуется, чтобы интерпретатор ЛаѵаЗсгірі снова и снова выполнял од¬ 
ну и ту же операцию. Почти в каждом цикле с каждой итерацией цикла одна или 
несколько переменных изменяют свои значения. Поскольку переменная меняет¬ 
ся, действия, которые выполняет инструкция , при каждом проходе тела цикла мо¬ 
гут отличаться. Кроме того, если изменяемая переменная (или переменные) при¬ 
сутствует в выражении , значение выражения может меняться при каждом проходе 
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цикла. Это важно, т. к. в противном случае выражение, значение которого было 
истинным, никогда не изменится и цикл никогда не завершится! Ниже приво¬ 
дится пример цикла ѵѵНіІе, который выводит числа от 0 до 9: 

ѵаг соипі: = 0; 
ѵѵііііе (соипі; < 10) { 
сопзоіе. 1од( соипі:); 
соип1:++; 

} 

Как видите, в начале переменной соипі: присваивается значение 0, а затем ее зна¬ 
чение увеличивается каждый раз, когда выполняется тело цикла. После того как 
цикл будет выполнен 10 раз, выражение вернет Гаізе (т.е. переменная соипі: уже 
не меньше 10), инструкция ѵѵОіІе завершится и интерпретатор перейдет к следую¬ 
щей инструкции в программе. Большинство циклов имеют переменные-счетчи¬ 
ки, аналогичные соипі:. Чаще всего в качестве счетчиков цикла выступают пере¬ 
менные с именами і, ] и к, хотя для того чтобы сделать программный код более 
понятным, следует давать счетчикам более наглядные имена. 

5.5.2. Инструкция сІо/ѵѵНіІе 

Цикл сІо/\л/Пі1е во многом похож на цикл \л/Пі1е, за исключением того, что выраже¬ 
ние цикла проверяется в конце, а не в начале. Это значит, что тело цикла всегда 
выполняется как минимум один раз. Эта инструкция имеет следующий синтак¬ 
сис: 

сіо 

инструкция 
ѵМІе ( выражение ); 

Цикл сІо/\л/Пі1е используется реже, чем родственный ему цикл мвііе. Дело в том, 
что на практике ситуация, когда вы заранее уверены, что потребуется хотя бы 
один раз выполнить тело цикла, несколько необычна. Ниже приводится пример 
использования цикла сіо/мвііе: 

ГипсИоп ргіпІіАггау(а) { 

ѵаг Іеп = а. ІепдііГі. і = 0; 

ІГ (Іеп == 0) 

сопзоіе.Іод("Пустой массив"); 
еізе { 
сіо { 

сопзоіе.Іод(а[і]); 

} ѵѵЫІе (++і < Іеп); 

} 

} 

Между циклом сІо/ѵѵИіІе и обычным циклом ѵѵИіІе имеется два отличия. Во-пер¬ 
вых, цикл сіо требует как ключевого слова сіо (для отметки начала цикла), так 
и ключевого слова ѵѵИіІе (для отметки конца цикла и указания условия). Во-вто¬ 
рых, в отличие от цикла ѵѵіпііе, цикл сіо завершается точкой с запятой. Цикл ѵѵИіІе 
необязательно завершать точкой с запятой, если тело цикла заключено в фигур¬ 
ные скобки. 
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5.5.3. Инструкция іог 

Инструкция І'ог представляет собой конструкцию цикла, которая часто оказыва- 
ется более удобной, чем инструкция ѵѵОіІе. Инструкция 'Рог упрощает конструиро¬ 
вание циклов, следующих шаблону, общему для большинства циклов. Большин¬ 
ство циклов имеют некоторую переменную-счетчик. Эта переменная инициали¬ 
зируется перед началом цикла и проверяется перед каждой итерацией. Наконец, 
переменная-счетчик инкрементируется или изменяется каким-либо другим об¬ 
разом в конце тела цикла, непосредственно перед повторной проверкой перемен¬ 
ной. Инициализация, проверка и обновление - это три ключевых операции, вы¬ 
полняемых с переменной цикла. Инструкция 'Рог делает эти три шага явной ча¬ 
стью синтаксиса цикла: 

Тог(инициализация: проверка ; инкремент ) 
инструкция 

Инициализация , проверка и инкремент - это три выражения (разделенных точкой с за¬ 
пятой), которые ответственны за инициализацию, проверку и увеличение пере¬ 
менной цикла. Расположение их в первой строке цикла упрощает понимание то¬ 
го, что делает цикл Рог, и не позволяет забыть инициализировать или увеличить 
переменную цикла. 

Проще всего объяснить работу цикла Рог, показав эквивалентный ему цикл ѵѵРііІе: 1 

инициализация ; 
ѵѵ/Рііі е(проверка) { 
инструкция 
инкремент ; 

} 

Другими словами, выражение инициализации вычисляется один раз перед началом 
цикла. Это выражение, как правило, является выражением с побочными эффек¬ 
тами (обычно присваиванием). В ^ѵаЗсгірі также допускается, чтобы выраже¬ 
ние инициализации было инструкцией объявления переменной ѵаг, поэтому можно 
одновременно объявить и инициализировать счетчик цикла. Выражение проверки 
вычисляется перед каждой итерацией и определяет, будет ли выполняться тело 
цикла. Если результатом проверки является истинное значение, выполняется ин¬ 
струкция, являющаяся телом цикла. В конце цикла вычисляется выражение ин¬ 
кремент. Чтобы использование этого выражения имело смысл, оно должно быть 
выражением с побочными эффектами. Обычно это либо выражение присваива¬ 
ния, либо выражение, использующее оператор ++ или 

Вывести числа от 0 до 9 можно также с помощью цикла -Гог, как показано ниже. 
В противовес эквивалентному циклу ѵѵМіІе, показанному в предыдущем разделе: 

^ог(ѵаг соипі: = 0; соипі: < 10; соип1:++) 
сопзоіе. 1од(соип1; ); 

Конечно, циклы могут быть значительно более сложными, чем в этих простых 
примерах, и иногда в каждой итерации цикла изменяется несколько перемен¬ 
ных. Эта ситуация - единственный случай в ^ѵаЗсгірі, когда часто применяется 


1 Как мы увидим, когда будем знакомиться с инструкцией сопііпие в разделе 5.6.3, этот 
цикл ѵѵ/ИіІе не является точным эквивалентом цикла Т о г. 
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оператор «запятая» - он позволяет объединить несколько выражений инициали¬ 
зации и инкрементирования в одно выражение, подходящее для использования 
в цикле Гог: 


ѵаг і, ] 

Гог(і =0, і = 10; і < 10; і++, ]--) 
зиш += і * у, 


Во всех наших примерах циклов, представленных до сих пор, переменная цикла 
содержала число. Это достаточно распространенная, но не обязательная практи¬ 
ка. В следующем примере цикл Гог используется для обхода связанного списка 
структур данных и получения последнего объекта в списке (например, первого 
объекта, который не имеет свойства пехГ): 


ГипсГіоп Таіі(о) { 

Гог(; о.пехТ; о = о.пехТ) /* пустое */ ; 
геГигп о; 

} 


// Возвращает последний элемент в списке о 
// Выполнять обход, пока о.пехі; 

// является истинным значением 


Обратите внимание на отсутствие выражения инициализации в примере выше. 
Любое из трех выражений цикла Гог может быть опущено, но две точки с запятой 
являются обязательными. Если опустить выражение проверки , цикл будет повто¬ 
ряться вечно, и форма записи Гог( ;;) является еще одним способом написать бес¬ 
конечный цикл, подобно ѵѵИіІе(Іігие). 


5.5.4. Инструкция Тог/іп 

Инструкция цикла Гог/іп использует ключевое слово Гог, но она в корне отличает¬ 
ся от инструкции обычного цикла Гог. Цикл Гог/іп имеет следующий синтаксис: 

Гог ( переменная іп объект) 
инструкция 

В качестве переменной здесь обычно используется имя переменной, но точно так 
же можно использовать любое выражение, возвращающее левостороннее выра¬ 
жение (раздел 4.7.3), или инструкцию ѵаг, объявляющую единственную перемен¬ 
ную, - практически все, что может находиться слева от оператора присваивания. 
Параметр объект - это выражение, возвращающее объект. И как обычно, инструк¬ 
ция - это инструкция или блок инструкций, образующих тело цикла. 

Для обхода элементов массива естественно использовать обычный цикл Гог: 

Гог(ѵаг і = 0; і < а. ІепдІзИ ; і++) // Присваивать индексы в массиве переменной і 

сопзоіе.Іод(а[і]); // Вывести значение каждого элемента массива 

Инструкция Гог/іп так же естественно позволяет выполнить обход свойств объекта. 

Гог(ѵаг р іп о) // Присваивать имена свойств объекта о переменной р 

сопзоіе.Іод(о[р]); // Вывести значение каждого свойства 

Чтобы выполнить инструкцию Гог/іп, интерпретатор ^ѵаЗсгірі сначала вычисля¬ 
ет выражение объект. Если оно возвращает значение пиіі или ипсЗГеГіпесІ, интерпре¬ 
татор пропускает цикл и переходит к следующей инструкции. 1 Если выражение 


1 Реализации, следующие стандарту ЕСМАВсгірі 3, в этом случае могут возбуждать ис¬ 
ключение Туре Е г го г. 
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возвращает простое значение, оно преобразуется в эквивалентный объект-оберт¬ 
ку (раздел 3.6). В противном случае выражение возвращает объект. Затем интер¬ 
претатор выполняет по одной итерации цикла для каждого перечислимого свой¬ 
ства объекта. Перед каждой итерацией интерпретатор вычисляет значение выра¬ 
жения переменная и присваивает ему имя свойства (строковое значение). 

Обратите внимание, что переменная в цикле іог/іп может быть любым выражени¬ 
ем, возвращающим значение, которое можно использовать слева от оператора 
присваивания. Это выражение вычисляется в каждой итерации цикла, т. е. каж¬ 
дый раз оно может возвращать разные значения. Например, чтобы скопировать 
имена всех свойств объекта в массив, можно использовать следующий цикл: 

ѵаг о = {х:1, у:2. 2:3}; 

ѵаг а = []; ѵаг і = 0; 

іог(а[і++] іп о) /* пустое тело цикла */; 

Массивы в ^ѵаЗсгірі - это просто специальный тип объектов, а индексы в масси¬ 
ве - свойства объекта, обход которых можно выполнить с помощью цикла іог/іп. 
Например, следующая инструкция перечислит индексы 0, 1 и 2 массива, объяв¬ 
ленного выше: 

іог(і іп а) сопзоіе.1од(і); 

В действительности цикл 'Рог/іп может совершать обход не по всем свойствам объ¬ 
екта, а только по перечислимым свойствам (раздел 6.7). Многочисленные встро¬ 
енные методы, определяемые в базовом языке ^ѵаЗсгірі, не являются перечис¬ 
лимыми. Например, все объекты имеют метод іоЗігіпдО, но цикл іог/іп не пере¬ 
числит свойство іоЗігіпд. Кроме встроенных методов также не являются перечис¬ 
лимыми многие другие свойства встроенных объектов. При этом все свойства 
и методы, определяемые пользователем, являются перечислимыми. (Но в реали¬ 
зации, следующей стандарту ЕСМАЗсгірі 5, имеется возможность сделать их не¬ 
перечислимыми, использовав прием, описанный в разделе 6.7.) Унаследованные 
свойства, которые были определены пользователем (раздел 6.2.2), также пере¬ 
числяются циклом іог/іп. 

Если в теле цикла Рог/іп удалить свойство, которое еще не было перечислено, это 
свойство перечислено не будет. Если в теле цикла создать новые свойства, то обыч¬ 
но такие свойстве не будут перечислены. (Однако некоторые реализации могут 
перечислять унаследованные свойства, добавленные в ходе выполнения цикла.) 

5.5.4.1. Порядок перечисления свойств 

Спецификация ЕСМАЗсгірі не определяет порядок, в каком цикл Рог/іп должен 
перечислять свойства объекта. Однако на практике реализации ЛѵаЗсгірі во всех 
основных броузерах перечисляют свойства простых объектов в порядке, в каком 
они были определены, - когда ранее объявленные свойства перечисляются первы¬ 
ми. Если объект был создан с помощью литерала объекта, свойства перечисляют¬ 
ся в том же порядке, в каком они следуют в литерале. В Интернете существуют 
сайты и библиотеки, которые опираются на такой порядок перечисления, поэто¬ 
му маловероятно, что производители броузеров изменят его. 

В абзаце выше описывается порядок перечисления свойств «простых» объектов. 
Однако в разных реализациях порядок перечисления может отличаться, если: 
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• объект наследует перечислимые свойства; 

• объект имеет свойства, которые являются целочисленными индексами массива; 

• использовалась инструкция сіеіеііе для удаления существующих свойств объ¬ 
екта или 

• использовался метод 0Ь]ес1:.сІеГіпеРгорегі:у( ) (раздел 6.7) или аналогичный ему 
для изменения атрибутов свойства объекта. 

Обычно (но не во всех реализациях) унаследованные свойства (раздел 6.2.2) пере¬ 
числяются после всех неунаследованных, «собственных» свойств объекта, но они 
также перечисляются в порядке их определения. Если объект наследует свойства 
более чем от одного «прототипа» (раздел 6.1.3) - например, когда в его «цепочке 
прототипов» имеется более одного объекта, - свойства каждого объекта-прототи¬ 
па в цепочке перечисляются в порядке их создания перед перечислением свойств 
следующего объекта. Некоторые (но не все) реализации перечисляют свойства 
массива в порядке возрастания чисел, а не в порядке их создания, но при наличии 
в массиве свойств с нечисловыми именами происходит возврат к перечислению 
в порядке создания свойств, то же самое происходит и в случае разреженных мас¬ 
сивов (т. е. когда в массиве отсутствуют некоторые элементы). 

5.6. Переходы 

Еще одной категорией инструкций языка ^ѵаЗсгірі являются инструкции пере¬ 
хода. Как следует из названия, эти инструкции заставляют интерпретатор ^ѵа- 
Зсгірі переходить в другое место в программном коде. Инструкция Ьгеак заставля¬ 
ет интерпретатор перейти в конец цикла или другой инструкции. Инструкция 
сопііпие заставляет интерпретатор пропустить оставшуюся часть тела цикла, пе¬ 
рейти обратно в начало цикла и приступить к выполнению новой итерации. В язы¬ 
ке ^ѵаЗсгірі имеется возможность помечать инструкции именами, благодаря 
чему в инструкциях Ьгеак и сопіііпие можно явно указывать, к какому циклу или 
к какой другой инструкции они относятся. 

Инструкция геііигп заставляет интерпретатор перейти из вызванной функции об¬ 
ратно в точку ее вызова и вернуть значение вызова. Инструкция ІіЬгоѵѵ возбуждает 
исключение и предназначена для работы в сочетании с инструкцией ігу/саІсЬ/ 
Гіпаііу, которая определяет блок программного кода для обработки исключения. 
Это достаточно сложная разновидность инструкции перехода: при появлении ис¬ 
ключения интерпретатор переходит к ближайшему объемлющему обработчику 
исключений, который может находиться в той же функции или выше, в стеке 
возвратов вызванной функции. 

Подробнее все эти инструкции перехода описываются в следующих подразделах. 

5.6.1. Метки инструкций 

Любая инструкция может быть помечена указанным перед ней идентификато¬ 
ром и двоеточием: 

идентификатор : инструкция 

Помечая инструкцию, вы тем самым даете ей имя, которое затем можно будет 
использовать в качестве ссылки в любом месте в программе. Пометить можно 
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любую инструкцию, однако помечать имеет смысл только инструкции, имеющие 
тело, такие как циклы и условные инструкции. Присвоив имя циклу, его затем 
можно использовать в инструкциях Ьгеак и сопіііпие, внутри цикла для выхода из 
него или для перехода в начало цикла, к следующей итерации. Инструкции Ьгеак 
и сопіііпие являются единственными инструкциями в языке ЛѵаЗсгірі, в кото¬ 
рых можно указывать метки - о них подробнее рассказывается далее в этой гла¬ 
ве. Ниже приводится пример инструкции ѵѵИіІе с меткой и инструкции сопіііпие, 
использующей эту метку: 

таіпіоор: \л/Ы1е(1:океп != пиіі) { 

// Программный код опущен... 

сопііпііе таіпіоор; // Переход к следующей итерации именованного цикла 
// Программный код опущен... 

} 

Идентификатор , используемый в качестве метки инструкции, может быть любым 
допустимым идентификатором ^ѵаЗсгірі, кроме зарезервированного слова. Име¬ 
на меток отделены от имен переменных и функций, поэтому в качестве меток до¬ 
пускается использовать идентификаторы, совпадающие с именами переменных 
или функций. Метки инструкций определены только внутри инструкций, к кото¬ 
рым они применяются (и, конечно же, внутри вложенных в них инструкций). 
Вложенные инструкции не могут помечаться теми же идентификаторами, что 
и вмещающие их инструкции, но две независимые инструкции могут помечаться 
одинаковыми метками. Помеченные инструкции могут помечаться повторно. То 
есть любая инструкция может иметь множество меток. 

5.6.2. Инструкция Ьгеак 

Инструкция Ьгеак приводит к немедленному выходу из самого внутреннего цик¬ 
ла или инструкции зѵѵііісЬ. Синтаксис ее прост: 

Ьгеак; 

Поскольку инструкция Ьгеак приводит к выходу из цикла или инструкции зѵѵіісЬ, 
такая форма Ьгеак допустима только внутри этих инструкций. 

Выше мы уже видели примеры использования инструкции Ьгеак внутри инструк¬ 
ции зѵѵіісЬ. В циклах она обычно используется для немедленного выхода из цик¬ 
ла, когда по каким-либо причинам требуется завершить выполнение цикла. Ко¬ 
гда цикл имеет очень сложное условие завершения, зачастую проще бывает реа¬ 
лизовать эти условия с помощью инструкций Ьгеак, чем пытаться выразить их 
в одном условном выражении цикла. Следующий пример пытается отыскать эле¬ 
мент массива с определенным значением. Цикл завершается обычным образом 
по достижении конца массива или с помощью инструкции Ьгеак, как только будет 
найдено искомое значение: 

1"ог(ѵаг і = 0; і < а.ІепдІЬ; і++) { 
і Т (а[і] == іагдеі) Ьгеак; 

} 

В языке ^ѵаЗсгірі; допускается указывать имя метки за ключевым словом Ьгеак 
(идентификатор без двоеточия): 


Ьгеак имя_метки\ 
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Когда инструкция Ьгеак используется с меткой, она выполняет переход в конец 
именованной инструкции или прекращение ее выполнения. В случае отсутствия 
инструкции с указанной меткой попытка использовать такую форму инструкций 
Ьгеак порождает синтаксическую ошибку. Именованная инструкция не обязана 
быть циклом или инструкцией змііісЬ: инструкция Ьгеак с меткой может выпол¬ 
нять «выход» из любой вмещающей ее инструкции. Объемлющая инструкция 
может даже быть простым блоком инструкций, заключенным в фигурные скобки 
исключительно с целью пометить его. 

Между ключевым словом Ьгеак и именем метки не допускается вставлять символ 
перевода строки. Дело в том, что интерпретатор ^ѵа8сгірі автоматически встав¬ 
ляет пропущенные точки с запятой: если разбить строку программного кода ме¬ 
жду ключевым словом Ьгеак и следующей за ним меткой, интерпретатор предпо¬ 
ложит, что имелась в виду простая форма этой инструкции без метки, и добавит 
точку с запятой (раздел 2.5). 

Инструкция Ьгеак с меткой необходима, только когда требуется прервать выпол¬ 
нение инструкции, не являющейся ближайшим объемлющим циклом или инст¬ 
рукцией зѵѵііісЬ. Следующий фрагмент демонстрирует это: 

ѵаг таігіх = деЮаІіаО; // Получить 2-мерный массив чисел откуда-нибудь 
// Найти сумму всех чисел в матрице, 
ѵаг зиіп = 0, зіюсезз = Гаізе; 

// Пометить инструкцию, выполнение которой требуется прервать в случае ошибки 
сотріі1:е_зит: і Г (таігіх) { 

Гог(ѵаг х = 0; х < таіігіх. ІепдіЬ; х++) { 
ѵаг го\л/ = та1ігіх[х]; 
іГ (!го\л/) Ьгеак сотріі1:е_зііт; 

Гог(ѵаг у = 0; у < гоѵ\/. ІепдІЬ; у++) { 
ѵаг сеіі = го\л/[у]; 
іГ (ізМаИСсеіі)) Ьгеак сотріі1:е_зит; 

Зит += сеіі; 

} 

} 

зиссезз = Ігііе; 

} 

// Здесь инструкция Ьгеак выполняет переход. Если будет выполнено условие 
// зиссезз == Гаізе, значит, что-то не так в полученной матрице. 

// В противном случае переменная зит будет содержать сумму всех элементов матрицы. 

Наконец, обратите внимание, что инструкция Ьгеак, с меткой или без нее, не может 
передавать управление через границы функций. Например, нельзя пометить инст¬ 
рукцию объявления функции и затем использовать эту метку внутри функции. 

5.6.3. Инструкция согтііпие 

Инструкция сопіііпие схожа с инструкцией Ьгеак. Однако вместо выхода из цикла 
инструкция сопіііпие запускает новую итерацию цикла. Синтаксис инструкции 
сопіііпие столь же прост, как и синтаксис инструкции Ьгеак: 

сопіііпие; 

Инструкция сопіііпие может также использоваться с меткой: 

сопіііпие имя_метки\ 
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Инструкция сопіііпие, как в форме без метки, так и с меткой, может использовать¬ 
ся только в теле цикла. Использование ее в любых других местах приводит ц син¬ 
таксической ошибке. 

Когда выполняется инструкция сопіііпие, текущая итерация цикла прерывается 
и начинается следующая. Для разных типов циклов это означает разное: 

• В цикле іѵЬіІе указанное в начале цикла выражение проверяется снова, и если 
оно равно Іігие, тело цикла выполняется с начала. 

• В цикле сІо/мЬіІе происходит переход в конец цикла, где перед повторным вы¬ 
полнением цикла снова проверяется условие. 

• В цикле "Рог вычисляется выражение инкремента и снова вычисляется выраже¬ 
ние проверки , чтобы определить, следует ли выполнять следующую итерацию. 

• В цикле Рог/іп цикл начинается заново с присвоением указанной переменной 
имени следующего свойства. 

Обратите внимание на различия в поведении инструкции сопіііпие в циклах ѵѵИіІе 
и Рог: цикл ѵѵЬіІе возвращается непосредственно к своему условию, а цикл Рог сна¬ 
чала вычисляет выражение инкремента , а затем возвращается к условию. Ранее 
при обсуждении цикла Рог объяснялось поведение цикла Рог в терминах «эквива¬ 
лентного» цикла ѵѵЬіІе. Поскольку инструкция сопРіпие ведет себя в этих двух 
циклах по-разному, точно имитировать цикл Рог с помощью одного цикла ѵѵИіІе 
невозможно. 

В следующем примере показано использование инструкции сопРіпие без метки 
для выхода из текущей итерации цикла в случае ошибки: 

Рог(і = 0; і < баРа. ІепдРЬ; і++) { 

іР (! сІаРа[і]) сопРіпие; // Не обрабатывать неопределенные данные 

РоРаІ += сІаРа[ і ]; 

} 

Инструкция сопРіпие, как и Ьгеак, может применяться во вложенных циклах 
в форме, включающей метку, и тогда заново запускаемым циклом необязательно 
будет цикл, непосредственно содержащий инструкцию сопРіпие. Кроме того, как 
и для инструкции Ьгеак, переводы строк между ключевым словом сопРіпие и име¬ 
нем метки не допускаются. 

5.6.4. Инструкция геіигп 

Как вы помните, вызов функции является выражением и подобно всем выраже¬ 
ниям имеет значение. Инструкция геРигп внутри функций служит для определе¬ 
ния значения, возвращаемого функцией. Инструкция геРигп имеет следующий 
синтаксис: 

геРигп выражение ; 

Инструкция геРигп может располагаться только в теле функции. Присутствие ее 
в любом другом месте является синтаксической ошибкой. Когда выполняется ин¬ 
струкция геРигп, функция возвращает значение выражения вызывающей програм¬ 
ме. Например: 


РипсРіоп здиаге(х) { геРигп х*х; } // Функция с инструкцией геРигп 

здиаге(2) // Этот вызов вернет 4 
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Если функция не имеет инструкции геііигп, при ее вызове интерпретатор будет 
выполнять инструкции в теле функции одну за другой, пока не достигнет конца 
функции, и затем вернет управление вызвавшей ее программе. В этом случае вы" 
ражение вызова вернет значение ипсІеГіпесІ. Инструкция геііигп часто является по¬ 
следней инструкцией в функции, но это совершенно необязательно: функция вер¬ 
нет управление вызывающей программе, как только будет достигнута инструк¬ 
ция геііигп, даже если за ней следуют другие инструкции в теле функции. 

Инструкция геііигп может также использоваться без выражения , тогда она просто 
прерывает выполнение функции и возвращает значение ипсІеГіпесІ вызывающей 
программе. Например: 

Гііпсіііоп сИзр1ау_оЬ]ес1:(о) { 

// Сразу же вернуть управление, если аргумент имеет значение піііі или ііпсіеі'іпес] 

ІГ (! о) геііигп; 

// Здесь находится оставшаяся часть функции... 

} 

Из-за того что интерпретатор ^ѵа8сгірі автоматически вставляет точки с запя¬ 
той, нельзя разделять переводом строки инструкцию геііигп и следующее за ней 
выражение. 

5.6.5. Инструкция іНгоѵѵ 

Исключение - это сигнал, указывающий на возникновение какой-либо исключи¬ 
тельной ситуации или ошибки. Возбуждение исключения (Нігоѵѵ) - это способ 
просигнализировать о такой ошибке или исключительной ситуации. Перехва¬ 
тить исключение (саісЬ) - значит обработать его, т. е. предпринять действия, не¬ 
обходимые или подходящие для восстановления после исключения. В ^ѵа8сгірі 
исключения возбуждаются в тех случаях, когда возникает ошибка времени вы¬ 
полнения и когда программа явно возбуждает его с помощью инструкции ІіИгоѵѵ. 
Исключения перехватываются с помощью инструкции Іігу/саІісИДіпаІІу, которая 
описана в следующем разделе. 

Инструкция ІіИгоѵѵ имеет следующий синтаксис: 

{[том выражение ; 

Результатом выражения может быть значение любого типа. Инструкции ІіНгсм можно 
передать число, представляющее код ошибки, или строку, содержащую текст сооб¬ 
щения об ошибке. Интерпретатор ^ѵа8сгірі возбуждает исключения, используя 
экземпляр класса Еггог одного из его подклассов, и вы также можете использовать 
подобный подход. Объект Еггог имеет свойство пате, определяющее тип ошибки, 
и свойство теззаде, содержащее строку, переданную функции-конструктору (смот¬ 
рите описание класса Еггог в справочном разделе). Ниже приводится пример функ¬ 
ции, которая возбуждает объект Еггог при вызове с недопустимым аргументом: 

І^псіііоп І^асііогіаі (х) { 

// Если входной аргумент не является допустимым значением, возбуждается исключение! 
Н (х < 0) 1:1тго ѵі пе\л/ Еггог("х не может быть отрицательным''); 

// В противном случае значение вычисляется и возвращается нормальным образом 

1"ог(ѵаг ^ = 1; х>1; { *= х, х--) /* пустое тело цикла */ ; 

геііигп 

} 
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Когда возбуждается исключение, интерпретатор ^ѵаЗсгірі немедленно прерыва¬ 
ет нормальное выполнение программы и переходит к ближайшему 1 обработчику 
исключений. В обработчиках исключений используется конструкция саІісИ инст¬ 
рукции Ігу/саісіу^іпаііу, описание которой приведено в следующем разделе. Ес¬ 
ли блок программного кода, в котором возникло исключение, не имеет соответст¬ 
вующей конструкции с аі: с И, интерпретатор анализирует следующий внешний 
блок программного кода и проверяет, связан ли с ним обработчик исключений. 
Это продолжается до тех пор, пока обработчик не будет найден. Если исключение 
генерируется в функции, не содержащей инструкции Ігу/саІсІ’іДіпаІІу, предна¬ 
значенной для его обработки, то исключение распространяется выше, в про¬ 
граммный код, вызвавший функцию. Таким образом исключения распространя¬ 
ются по лексической структуре методов ЛѵаЗсгірі вверх по стеку вызовов. Если 
обработчик исключения так и не будет найден, исключение рассматривается как 
ошибка и о ней сообщается пользователю. 

5.6.6. Инструкция Ігу/саісН/ііпаІІу 

Инструкция Ігу/саІсІ’іДіпаІІу реализует механизм обработки исключений в ^ѵа- 
Зсгірі. Конструкция 1:гу в этой инструкции просто определяет блок кода, в кото¬ 
ром обрабатываются исключения. За блоком 1:гу следует конструкция саіісИ с бло¬ 
ком инструкций, вызываемых, если где-либо в блоке 1:гу возникает исключение. 
За конструкцией саІісИ следует блок -Ріпаііу, содержащий программный код, вы¬ 
полняющий заключительные операции, который гарантированно выполняется 
независимо от того, что происходит в блоке 1:гу. И блок саІісИ, и блок 'Ріпаііу не яв¬ 
ляются обязательными, однако после блока 1:гу должен обязательно присутство¬ 
вать хотя бы один из них. Блоки 1:гу, саІісИ и 'Гіпаііу начинаются и заканчиваются 
фигурными скобками. Это обязательная часть синтаксиса, и она не может быть 
опущена, даже если между ними содержится только одна инструкция. 

Следующий фрагмент иллюстрирует синтаксис и назначение инструкции 1:гу/ 
саісіу^іпаііу: 

Ігу { 

// Обычно этот код без сбоев работает от начала до конца. 

// Но в какой-то момент в нем может быть сгенерировано исключение 
// либо непосредственно с помощью инструкции ІНгоѵѵ, либо косвенно - 
// вызовом метода, генерирующего исключение. 

} 

саІсН (е) { 

// Инструкции в этом блоке выполняются тогда и только тогда, когда в блоке 1:гу 
// возникает исключение. Эти инструкции могут использовать локальную переменную е, 

// ссылающуюся на объект Еггог или на другое значение, указанное в инструкции 1:И гоѵѵ/. 
// Этот блок может либо некоторым образом обработать исключение, либо 
// проигнорировать его, делая что-то другое, либо заново сгенерировать 
// исключение с помощью инструкции 1:1т гоѵѵ/ . 

} 

Еіпаііу { 

// Этот блок содержит инструкции, которые выполняются всегда, независимо от того, 

// что произошло в блоке Ігу. Они выполняются, если блок Ігу завершился: 


1 К самому внутреннему по вложенности охватывающему обработчику исключений. - 
Прим. науч. ред. 
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// 1) как обычно, достигнув конца блока 

// 2) из-за инструкции Ьгеак, сопГіпііе или геГіігп 

// 3) с исключением, обработанным приведенным в блоке саІсГі выше 

// 4) с неперехваченным исключением, которое продолжает свое 

// распространение на более высокие уровни 

} 

Обратите внимание, что за ключевым словом саІісМ следует идентификатор в скоб¬ 
ках. Этот идентификатор похож на параметр функции. Когда будет перехвачено 
исключение, этому параметру будет присвоено исключение (например, объект 
Еггог). В отличие от обычной переменной идентификатор, ассоциированный с кон¬ 
струкцией саіісіі, существует только в теле блока саГсЬ. 

Далее приводится более реалистичный пример инструкции Ггу/саГсЬ. В нем вы¬ 
зываются метод ГасГогіаІО, определенный в предыдущем разделе, и методы 
рготрГ() и а1егГ() клиентского ^ѵаЗсгірі; для организации ввода и вывода: 

Ггу { 

// Запросить число у пользователя 

ѵаг п = МцтЬег( рготрі; ("Введите положительное число", 

// Вычислить факториал числа, предполагая, что входные данные корректны 
ѵаг Г = ГасГогіаІ(п); 

// Вывести результат 
а1егГ(п + "! = " + О; 

} 

саГсЬ (ех) { // Если данные некорректны, управление будет передано сюда 

аІегГ(ех); // Сообщить пользователю об ошибке 

} 

Это пример инструкции Ггу/саГсЬ без конструкции Гіпаііу. Хотя Гіпаііу использу¬ 
ется не так часто, как саГсЬ, тем не менее иногда эта конструкция оказывается 
полезной. Однако ее поведение требует дополнительных объяснений. Блок Гіпаііу 
гарантированно исполняется, если исполнялась хотя бы какая-то часть блока Гг у, 
независимо от того, каким образом завершилось выполнение программного кода 
в блоке Ггу. Эта возможность обычно используется для выполнения заключитель¬ 
ных операций после выполнения программного кода в предложении Ггу. 

В обычной ситуации управление доходит до конца блока Ггу, а затем переходит 
к блоку Гіпаііу, который выполняет необходимые заключительные операции. Ес¬ 
ли управление вышло из блока Ггу как результат выполнения инструкций геГигп, 
сопГіпие или Ьгеак, перед передачей управления в другое место выполняется блок 
Гіпаііу. 

Если в блоке Ггу возникает исключение и имеется соответствующий блок саГсН 
для его обработки, управление сначала передается в блок саГсЬ, а затем - в блок 
Гіпаііу. Если отсутствует локальный блок саГсЬ, то управление сначала передает¬ 
ся в блок Гіпаііу, а затем переходит на ближайший внешний блок саГсН, который 
может обработать исключение. 

Если сам блок Гіпаііу передает управление с помощью инструкции геГигп, сопГі¬ 
пие, Ьгеак или ГЬгоѵѵ или путем вызова метода, генерирующего исключение, неза¬ 
конченная команда на передачу управления отменяется и выполняется новая. 
Например, если блок Гіпаііу сгенерирует исключение, это исключение заменит 
любое ранее сгенерированное исключение. Если в блоке Гіпаііу имеется инструк- 
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ция геііигп, произойдет нормальный выход из метода, даже если генерировалось 
исключение, которое не было обработано. 

Конструкции 1:гу и ^іпаііу могут использоваться вместе без конструкции саіісіі. 
В этом случае блок ^іпаііу - это просто набор инструкций, выполняющих заклю¬ 
чительные операции, который будет гарантированно выполнен независимо от на¬ 
личия в блоке Іту инструкции Ьгеак, сопИпие или геііигп. Напомню, из-за разли¬ 
чий в работе инструкции сопИпие в разных циклах невозможно написать цикл 
\л/Ы1е, полностью имитирующий работу цикла І'ог. Однако если добавить инструк¬ 
цию ІхуДіпаІІу, можно написать цикл \л/Ы1е, который будет действовать точно так 
же, как цикл ^ог, и корректно обрабатывать инструкцию сопіііпие: 

// Имитация цикла г( инициализация ; проверка ; инкремент ) тело цикла ; 
инициализация ; 

\л/Ы1е( проверка ) { 

1: гу { тело цикла ; } 

Ппа11у { инкремент ; } 

} 

Обратите однако внимание, что тело цикла \л/Ы1е, содержащее инструкцию Ьгеак, 
будет вести себя несколько иначе (из-за выполнения лишней операции инкремен¬ 
та перед выходом), чем тело цикла І'ог, поэтому даже используя конструкцию 
^іпаііу, невозможно точно сымитировать цикл ^ог с помощью цикла \л/Ы1е. 

5.7. Прочие инструкции 

В этом разделе описываются три остальные инструкции языка ЛѵаЗсгірі - міІЬ, 
ЬеЬиддег и изе зіігісі:. 

5.7.1. Инструкция ѵѵіііі 

В разделе 3.10.3 мы обсуждали область видимости переменных и цепочки облас¬ 
тей видимости - список объектов, в которых выполняется поиск при разрешении 
имен переменных. Инструкция \л/і1:Ь используется для временного изменения це¬ 
почки областей видимости. Она имеет следующий синтаксис: 

міІЬ ( объект ) 
инструкция 

Эта инструкция добавляет объект в начало цепочки областей видимости, выпол¬ 
няет инструкцию , а затем восстанавливает первоначальное состояние цепочки. 

Инструкция \л/іі:Ь не может использоваться в строгом режиме (раздел 5.7.3) и не 
рекомендуется к использованию в нестрогом режиме: избегайте ее использова¬ 
ния по мере возможности. Программный код ^ѵаЗсгірІ, в котором используется 
инструкция \л/і1:Ь, сложнее поддается оптимизации и наверняка будет работать 
медленнее, чем эквивалентный программный код без инструкции ѵ\/і1:Ь. 

На практике инструкция \л/і1:Ь упрощает работу с глубоко вложенными иерархия¬ 
ми объектов. В клиентском Лѵа8сгірі вам наверняка придется вводить выраже¬ 
ния, как показано ниже, чтобы обратиться к элементам НТМЬ-формы: 

сіосіітепі:. 1"огт5[0].асІсІге55. ѵаіііе 
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Если подобные выражения потребуется записать много раз, можно воспользо¬ 
ваться инструкцией ѵ\/і1:Ь, чтобы добавить объект формы в цепочку областей види¬ 
мости: 

ѵ\/і1:Іі(сіоситепі:. ^огтз[0]) { 

// Далее следуют обращения к элементам формы непосредственно, например: 
пате.ѵаіие = 
асісігезз . ѵаіие = 
етаіі.ѵаіііе = ; 

} 

Этот прием сокращает объем текста программы - больше не надо указывать 
фрагмент Ьоситеп1:.Гогтз[0] перед каждым именем свойства. Этот объект представ¬ 
ляет собой временную часть цепочки областей видимости и автоматически участ¬ 
вует в поиске, когда Лѵабсгірі требуется разрешить идентификаторы, такие как 
асісігезз. Избежать применения инструкции мііь достаточно просто, если записать 
предыдущий пример, как показано ниже: 

ѵаг ? = сіоситепі: . ^огтз[0]; 

Г. пате.ѵаіие = 

1\ асісігезз. ѵаіие = 

Г. етаіі.ѵаіие = 

Имейте в виду, что цепочка областей видимости используется только для поиска 
идентификаторов и не используется при их создании. Взгляните на следующий 
пример: 

\л/і1Ь(о) х = 1; 

Если объект о имеет свойство х, то данный программный код присвоит значение 1 
этому свойству. Но если х не является свойством объекта о, данный программный 
код выполнит то же действие, что и инструкция х = 1 без инструкции ѵѵіііГі. Он 
присвоит значение локальной или глобальной переменной с именем х или создаст 
новое свойство глобального объекта. Инструкция ѵѵііііі обеспечивает более корот¬ 
кую форму записи операций чтения свойств объекта о, но не создания новых 
свойств этого объекта. 

5.7.2. Инструкция сіеЬиддег 

Инструкция сіеЬиддег обычно ничего не делает. Однако если имеется и запущена 
программа-отладчик, реализация ^ѵабсгірі может (но не обязана) выполнять 
некоторые отладочные операции. Обычно эта инструкция действует подобно точ¬ 
ке останова: интерпретатор ^ѵабсгірі приостанавливает выполнение программ¬ 
ного кода, и вы можете с помощью отладчика вывести значения переменных, оз¬ 
накомиться с содержимым стека вызовов и т. д. Допустим, к примеру, что ваша 
функция Г() порождает исключение, потому что она вызывается с неопределен¬ 
ным аргументом, а вы никак не можете определить, из какой точки программы 
производится этот вызов. Чтобы решить эту проблему, можно было бы изменить 
определение функции Г(), чтобы она начиналась строкой, как показано ниже: 

^ипсіііоп ?(о) { 

ІГ (о === ипсІеПпесІ) сіеЬиддег; // Временная строка для отладки 

// Далее продолжается тело функции. 


} 
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Теперь, когда 14) будет вызвана без аргумента, ее выполнение будет приостанов¬ 
лено, и вы сможете воспользоваться отладчиком и просмотреть стек вызовов, 
чтобы отыскать место, откуда был выполнен некорректный вызов. 

Официально инструкция сІеЬиддег была добавлена в язык стандартом ЕСМА- 
8сгірі 5, но производители основных броузеров реализовали ее уже достаточно 
давно. Обратите внимание, что недостаточно иметь отладчик: инструкция СІеЬиддег 
не запускает отладчик автоматически. Однако, если отладчик уже запущен, эта 
инструкция будет действовать как точка останова. Если, к примеру, воспользо¬ 
ваться расширением ЕігеЪи& для Еіге^ох, это расширение должно быть активиро¬ 
вано для веб-страницы, которую требуется отладить, и только в этом случае ин¬ 
струкция сІеЬиддег будет работать. 

5.7.3. "изе 5*гісГ' 

"изе зітісі:” - это директива , введенная стандартом ЕСМА8сгірі 5. Директивы не 
являются инструкциями (но достаточно близки, чтобы включить описание "изе 
зітісі:” в эту главу). Между обычными инструкциями и директивой "изе зітісі:" 
существует два важных отличия: 

• Она не включает никаких зарезервированных слов языка: директива - это 
лишь выражение, содержащее специальный строковый литерал (в одиночных 
или двойных кавычках). Интерпретаторы Лѵа8сгірі, не соответствующие 
стандарту ЕСМА8сгірі 5, будут интерпретировать ее как простое выражение 
без побочных эффектов и ничего не будут делать. В будущих версиях стандар¬ 
та ЕСМА8сгірі, как ожидается, слово изе будет переведено в разряд ключевых 
слов, что позволит опустить кавычки. 

• Она может появляться только в начале сценария или в начале тела функции, 
перед любыми другими инструкциями. Однако она не обязательно должна на¬ 
ходиться в самой первой строке сценария или функции: директиве "изе зітісі:" 
могут предшествовать или следовать за ней другие строковые выражения-ли¬ 
тералы, а различные реализации ^ѵа8сгірі могут интерпретировать эти стро¬ 
ковые литералы как директивы, определяемые этими реализациями. Строко¬ 
вые литералы, следующие за первой обычной инструкцией в сценарии или 
функции, интерпретируются как обычные выражения - они могут не воспри¬ 
ниматься как директивы и не оказывать никакого эффекта. 

Назначение директивы "изе зітісі:" состоит в том, чтобы показать, что следую¬ 
щий за ней программный код (в сценарии или функции) является строгим ко¬ 
дом . Строгим считается программный код верхнего уровня (не внутри функций), 
если в сценарии имеется директива "изе зітісі:". Строгим считается тело функ¬ 
ции, если она определяется внутри строгого программного кода или если она со¬ 
держит директиву "изе зітісі:". Строгим считается программный код, передавае¬ 
мый методу еѵа1( ), если вызов еѵа1( ) выполняется из строгого программного кода 
или если строка с кодом содержит директиву "изе зітісі:". 

Строгий программный код выполняется в строгом режиме . Согласно стандарту 
ЕСМА8сгірі 5, строгий режим определяет ограниченное подмножество языка, 
благодаря чему исправляет некоторые недостатки языка, а также обеспечивает 
более строгую проверку на наличие ошибок и повышенный уровень безопасно¬ 
сти. Ниже перечислены различия между строгим и нестрогим режимами (первые 
три имеют особенно большое значение): 
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• В строгом режиме не допускается использование инструкции \л/іі:Гі. 

• В строгом режиме все переменные должны объявляться: если попытаться при¬ 
своить значение идентификатору, который не является объявленной перемен 1 
ной, функцией, параметром функции, параметром конструкции саіісГі или 
свойством глобального объекта, возбуждается исключение ВеГегепсеЕггог. (В не¬ 
строгом режиме такая попытка просто создаст новую глобальную переменную 
и добавит ее в виде свойства в глобальный объект.) 

• В строгом режиме функции, которые вызываются как функции (а не как ме¬ 
тоды), получают в ссылке 1:Гііз значение ипсІеГіпесІ. (В нестрогом режиме функ¬ 
ции, которые вызываются как функции, всегда получают в ссылке Шз гло¬ 
бальный объект.) Это отличие можно использовать, чтобы определить, под¬ 
держивает ли та или иная реализация строгий режим: 

ѵаг ЬазЗіігісІіМосІе = ( ^ипсіііоп () { "изе зігісі:"; геііигп 1гЬіз===ііпсІе1 : іпес]}()); 

Кроме того, когда функция вызывается в строгом режиме с помощью са11() 
или арр1у(), значение ссылки ІіИіз в точности соответствует значению, передан¬ 
ному в первом аргументе функции са11() или арр1у(). (В нестрогом режиме зна¬ 
чения гшП и ипсІеГіпесІ замещаются ссылкой на глобальный объект, а простые 
значения преобразуются в объекты.) 

• В строгом режиме попытки присвоить значения свойствам, недоступным для 
записи, или создать новые свойства в нерасширяемых объектах порождают ис¬ 
ключение Туре Е г го г. (В нестрогом режиме эти попытки просто игнорируются.) 

• В строгом режиме программный код, передаваемый функции еѵа1( ), не может 
объявлять переменные или функции в области видимости вызывающего про¬ 
граммного кода, как это возможно в нестрогом режиме. Вместо этого перемен¬ 
ные и функции помещаются в новую область видимости, создаваемую для 
функции еѵа1(). Эта область видимости исчезает, как только еѵа1() вернет 
управление. 

• В строгом режиме объект агдитепТз (раздел 8.3.2) в функции хранит статиче¬ 
скую копию значений, переданных функции. В нестрогом режиме объект 
агдитепііз ведет себя иначе - элементы массива агдитепіз и именованные пара¬ 
метры функции ссылаются на одни и те же значения. 

• В строгом режиме возбуждается исключение ЗупІіахЕггог, если оператору сіеіеііе 
передать неквалифицированный идентификатор, такой как имя переменной, 
функции или параметра функции. (В нестрогом режиме такое выражение 
сіеіеііе не выполнит никаких действий и вернет І'аізе.) 

• В строгом режиме попытка удалить ненастраиваемое свойство приведет к ис¬ 
ключению ТуреЕггог. (В нестрогом режиме эта попытка просто завершится не¬ 
удачей и выражение сіеіеііе вернет Шзе.) 

• В строгом режиме попытка определить в литерале объекта два или более 
свойств с одинаковыми именами считается синтаксической ошибкой. (В не¬ 
строгом режиме ошибка не возникает.) 

• В строгом режиме определение двух или более параметров с одинаковыми 
именами в объявлении функции считается синтаксической ошибкой. (В не¬ 
строгом режиме ошибка не возникает.) 
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• В строгом режиме не допускается использовать литералы восьмеричных це¬ 
лых чисел (начинающихся с 0, за которым не следует символ х). (В нестрогом 
режиме некоторые реализации позволяют использовать восьмеричные лите¬ 
ралы.) 

• В строгом режиме идентификаторы еѵаі и агдитепГз интерпретируются как 
ключевые слова, и вы не можете изменить их значения. Вы сможете присво¬ 
ить значения этим идентификаторам, объявив их как переменные, использо¬ 
вав их в качестве имен функций, имен параметров функций или идентифика¬ 
торов блока саТсИ. 

• В строгом режиме ограничивается возможность просмотра стека вызовов. По¬ 
пытки обратиться к свойствам агдитепііз.саііег и агдитепііз.саііее в строгом ре¬ 
жиме возбуждают исключение ТуреЕггог. Попытки прочитать свойства саііег 
и агдитепііз функций в строгом режиме также возбуждают исключение Туре¬ 
Еггог. (Некоторые реализации определяют эти свойства в нестрогих функциях.) 

5.8. Итоговая таблица .ІаѵаБсгірІ-инструкций 

В этой главе были представлены все инструкции языка ^ѵа8сгірі. В табл. 5.1 со¬ 
держится перечень этих инструкций с указанием синтаксиса и назначения каж¬ 
дой из них. 

Таблица 5.1. Синтаксис инструкций ^ ѵаЗсгір! 


Инструкция 

Синтаксис 

Назначение 

Ъгеак 

Ьгеак [ имя_метки]\ 

Выход из самого внутреннего цик¬ 
ла, инструкции зміГсіі или инструк¬ 
ции с именем имя_метки 

сазе 

сазе выражение : 

Метка для инструкции внутри кон¬ 
струкции зміГсЬ 

сопііпие 

сопГіпііе [ имя_метки]\ 

Переход к следующей итерации са¬ 
мого внутреннего цикла или цикла, 
помеченного меткой имя_метки 

сіеЪи^ег 

сІеЬііддег; 

Точка останова отладчика 

сІеГаиІІ 

сІеГаііП:: 

Метка инструкции по умолчанию, 
внутри инструкции ЗМІГСІІ 

сіо/\ѵЬі1е 

сіо инструкция ѵу/Мі1е ( выражение ); 

Альтернатива циклу мііііе 

пустая 

инструкция 

і 

Ничего не делает 

Тог 

Гог ( инициализация ; проверка ; инкремент ) 

инструкция 

Простой в использовании цикл 

Тог/іп 

Гог ( переменная іп объект ) 

инструкция 

Цикл по свойствам объекта 

Типсііоп 

ГипсГіоп имя_функции{[парт [,...]]) 

{ 

Объявление функции с именем 

имя_функции 


} 


тело 
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Таблица 5.1 (продолжение) 


Инструкция 

Синтаксис 

Назначение 

И/еІзе 

іГ ( выражение ) инструкцияі 
[еізе инструкция2 ] 

Выполняет инструкциюі или инструк- 
цию2 

метка 

идентификатор : инструкция 

Дает инструкции имя идентификатор 

геіигп 

геТіігп [ выражение ]; 

Возвращает значение из функции 

з\ѵіісЬ 

зміісЬ ( выражение ) { инструкции } 

Многопозиционное ветвление для 
инструкций с метками сазе и беГацІІ: 

ІЬголѵ 

ТЬгом выражение', 

Генерирует исключения 

ігу 

1:гу{ инструкции } 

[саТсІМ обработчик исключений }] 

[Гіпаііу { заключит, операции }] 

Обработка исключений 

изе зігісі 

"изе зігісі" 

Применение строгого режима, на¬ 
кладывающего ограничения на сце¬ 
нарии или функции 

ѵаг 

ѵаг имя [ = выражение ] [ .... ]; 

Объявление и инициализация од¬ 
ной или более переменных 

\ѵЬі1е 

\л/Ы1е ( выражение) инструкция 

Базовая конструкция цикла 

\ѵііЬ 

міТЬ ( объект ) инструкция 

Расширение цепочки областей ви¬ 
димости. (Не рекомендуется к ис¬ 
пользованию.) 




6 

Объекты 


Объект является фундаментальным типом данных в языке ^ѵа8сгірі. Объект - 
это составное значение: он объединяет в себе набор значений (простых значений 
или других объектов) и позволяет сохранять и извлекать эти значения по име¬ 
нам. Объект является неупорядоченной коллекцией свойству каждое из которых 
имеет имя и значение. Имена свойств являются строками, поэтому можно ска¬ 
зать, что объекты отображают строки в значения. Такое отображение строк в зна¬ 
чения может называться по-разному: возможно, вы уже знакомы с такой фунда¬ 
ментальной структурой данных, как «хеш», «словарь» или «ассоциативный мас¬ 
сив». Однако объект представляет собой нечто большее, чем простое отображение 
строк в значения. Помимо собственных свойств объекты в языке ЛѵаЗсгірі могут 
также наследовать свойства от других объектов, известных под названием «про¬ 
тотипы». Методы объекта - это типичные представители унаследованных свойств, 
а «наследование через прототипы» является ключевой особенностью языка Лѵа- 
8сгірі. 

Объекты в языке Лѵа8сгірі являются динамическими - обычно они позволяют 
добавлять и удалять свойства - но они могут использоваться также для имита¬ 
ции статических объектов и «структур», которые имеются в языках программи¬ 
рования со статической системой типов. Кроме того, они могут использоваться 
(если не учитывать, что объекты отображают строки в значения) для представле¬ 
ния множеств строк. 

Любое значение в языке ^ѵа8сгірі, не являющееся строкой, числом, Ігие, 1"а1зе, 
пиіі или ипсІе'ГіпесІ, является объектом. И даже строки, числа и логические значе¬ 
ния, не являющиеся объектами, могут вести себя как неизменяемые объекты 
(раздел 3.6). 

Как вы помните, в разделе 3.7 говорилось, что объекты являются изменяемыми 
значениями и операции с ними выполняются по ссылке, а не по значению. Если 
переменная х ссылается на объект, и выполняется инструкция ѵаг у = х;, в пере¬ 
менную у будет записана ссылка на тот же самый объект, а не его копия. Любые 
изменения, выполняемые в объекте с помощью переменной у, будут также отра¬ 
жаться на переменной х. 
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Наиболее типичными операциями с объектами являются создание объектов, на¬ 
значение, получение, удаление, проверка и перечисление их свойств. Эти базовые 
операции описываются в начальных разделах этой главы. В следующих за ними 
разделах будут рассматриваться более сложные темы, многие из которых имеют 
прямое отношение к стандарту ЕСМА8сгірі 5. 

Свойство имеет имя и значение. Именем свойства может быть любая строка, 
включая и пустую строку, но объект не может иметь два свойства с одинаковыми 
именами. Значением свойства может быть любое значение, допустимое в языке 
Лѵа8сгірі, или (в ЕСМА8сгірі 5) функция чтения или записи (или обе). Поближе 
с функциями чтения и записи свойств мы познакомимся в разделе 6.6. В дополне¬ 
ние к именам и значениям каждое свойство имеет ряд ассоциированных с ним 
значений, которые называют атрибутами свойства : 

• Атрибут мгіѣаЬІе определяет доступность значения свойства для записи. 

• Атрибут епитегаЫе определяет доступность имени свойства для перечисления 
в цикле Гог/іп. 

• Атрибут сопГідигаЬІе определяет возможность настройки, т.е. удаления свой¬ 
ства и изменения его атрибутов. 

До появления стандарта ЕСМА8сгірі 5 все свойства в объектах, создаваемые про¬ 
граммой, доступны для записи, перечисления и настройки. В ЕСМА8сгірі 5 пре¬ 
дусматривается возможность настройки атрибутов ваших свойств. Как это дела¬ 
ется, описывается в разделе 6.7. 

В дополнение к свойствам каждый объект имеет три атрибута объекта : 

• Атрибут ргоіоіуре содержит ссылку на другой объект, от которого наследуют¬ 
ся свойства. 

• Атрибут сіазз содержит строку с именем класса объекта и определяет тип объ¬ 
екта. 

• Флаг ехІепзіЬІе (в ЕСМА8сгірі 5) указывает на возможность добавления но¬ 
вых свойств в объект. 

Поближе с прототипами и механизмом наследования свойств мы познакомимся 
в разделах 6.1.3и6.2.2,а более детальное обсуждение всех трех атрибутов объек¬ 
тов вы найдете в разделе 6.8. 

Наконец, ниже приводится описание некоторых терминов, которые помогут нам 
различать три обширные категории объектов в языке Лѵа8сгірі и два типа свойств: 

• Объект базового языка - это объект или класс объектов, определяемый спе¬ 
цификацией ЕСМА8сгірі. Массивы, функции, даты и регулярные выражения 
(например) являются объектами базового языка. 

• Объект среды выполнения - это объект, определяемый средой выполнения (та¬ 
кой как веб-броузер), куда встроен интерпретатор Лѵа8сгірі. Объекты НТМІ_Е1е- 
теп*, представляющие структуру веб-страницы в клиентском Лѵа8сгірі, яв¬ 
ляются объектами среды выполнения. Объекты среды выполнения могут так¬ 
же быть объектами базового языка, например, когда среда выполнения опре¬ 
деляет методы, которые являются обычными объектами РипсИоп базового 
языка Лѵа8сгірі. 

• Пользовательский объект - любой объект, созданный в результате выполне¬ 
ния программного кода ^ѵа8сгірі. 
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• Собственное свойство - это свойство, определяемое непосредственно в дан¬ 
ном объекте. 

• Унаследованное свойство - это свойство, определяемое прототипом объекта." 


6.1. Создание объектов 

Объекты можно создавать с помощью литералов объектов, ключевого слова пем 
и (в ЕСМА8сгірі 5) функции 0Ь]ес1:.сгеа1:е(). Все эти приемы описываются в сле¬ 
дующих разделах. 


6.1.1. Литералы объектов 

Самый простой способ создать объект заключается во включении в программу 
литерала объекта. Литерал объекта - это заключенный в фигурные скобки спи¬ 
сок свойств (пар имя/значение), разделенных запятыми. Именем свойства может 
быть идентификатор или строковый литерал (допускается использовать пустую 
строку). Значением свойства может быть любое выражение, допустимое в Лѵа- 
8сгірі, - значение выражения (это может быть простое значение или объект) станет 
значением свойства. Ниже приводится несколько примеров создания объектов: 


ѵаг етрііу = {}; 

ѵаг роіпі: = { х:0. у:0 }; 

ѵаг роіп1:2 = { х:роіп1:.х, у:роіпі:.у+1 }; 

ѵаг Ьоок = { 

"таіп іШе": ’^аѵаЗсгірі:", 

' 5иЬ-1:Ше' : "ТЬе ОеПпШѵе Сиісіе**. 

"^ог": "аіі аіісііепсеэ", 

аііІіЬог: { 

^ігзііпате: "ОаѵісГ, 
зіігпате: "Ріападап" 

} 

}; 


// Объект без свойств 

// Два свойства 

// Более сложные значения 

// Имена свойств с пробелами 

// и дефисами, поэтому используются 

// строковые литералы 

// Рог - зарезервированное слово, 

// поэтому в кавычках 
// Значением этого свойства является 
// объект. Обратите внимание, что 
// имена этих свойств без кавычек. 


В ЕСМА8сгірі 5 (и в некоторых реализациях ЕСМА8сгірі 3) допускается исполь¬ 
зовать зарезервированные слова в качестве имен свойств без кавычек. Однако 
в целом имена свойств, совпадающие с зарезервированными словами, в ЕСМА- 
8сгірі 3 должны заключаться в кавычки. В ЕСМА8сгірі 5 последняя запятая, 
следующая за последним свойством в литерале объекта, игнорируется. В боль¬ 
шинстве реализаций ЕСМА8сгірі 3 завершающие запятые также игнорируются, 
но ІЕ интерпретирует их наличие как ошибку. 

Литерал объекта - это выражение, которое создает и инициализирует новый объ¬ 
ект всякий раз, когда производится вычисление этого выражения. Значение ка¬ 
ждого свойства вычисляется заново, когда вычисляется значение литерала. Это 
означает, что с помощью единственного литерала объекта можно создать множе¬ 
ство новых объектов, если этот литерал поместить в тело цикла или функции, 
которая будет вызываться многократно, и что значения свойств этих объектов 
могут отличаться друг от друга. 
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6.1.2. Создание объектов с помощью оператора пеѵѵ 

Оператор пе\л/ создает и инициализирует новый объект. За этим оператором долж* 
но следовать имя функции. Функция, используемая таким способом, называется 
конструктором и служит для инициализации вновь созданного объекта. Базо¬ 
вый ^ѵаВсгірі включает множество встроенных конструкторов для создания 
объектов базового языка. Например: 

ѵаг о = пей 0Ь]ес1:(); // Создать новый пустой объект: то же, что и {}. 

ѵаг а = пей АггауО; // Создать пустой массив: то же, что и []. 

ѵаг б = пей йаііе (); // Создать объект йаііе, представляющий текущее время 

ѵаг г = пей ВедЕхр( "із" ); // Создать объект ВедЕхр для операций 

// сопоставления с шаблоном. 

Помимо этих встроенных конструкторов имеется возможность определять свои 
собственные функции-конструкторы для инициализации вновь создаваемых объ¬ 
ектов. О том, как это делается, рассказывается в главе 9. 

6.1.3. Прототипы 

Прежде чем перейти к третьему способу создания объектов, необходимо сделать 
паузу, чтобы познакомиться с прототипами. Каждый объект в языке ЛѵаВсгірі 
имеет второй объект (или пиіі, но значительно реже), ассоциированный с ним. 
Этот второй объект называется прототипом, и первый объект наследует от прото¬ 
типа его свойства. 

Все объекты, созданные с помощью литералов объектов, имеют один и тот же объ¬ 
ект-прототип, на который в программе ЛѵаВсгірі можно сослаться так: ОЬ^есІ:. рго- 
Іоііуре. Объекты, созданные с помощью ключевого слова пе\л/ и вызова конструкто¬ 
ра, в качестве прототипа получают значение свойства ргоііоіуре функции-конст¬ 
руктора. Поэтому объект, созданный выражением пе\д/ ОУесШ, наследует свойст¬ 
ва объекта 0Ь]ес1:.рго1:о1:уре, как если бы он был создан с помощью литерала 
в фигурных скобках {}. Аналогично прототипом объекта, созданного выражени¬ 
ем пе\л/ АггауО, является Аггау.ргоііоііуре, а прототипом объекта, созданного выра¬ 
жением пе\л/ 0а1:е(), является Оаііе.ргоіоіуре. 

ОЬ^есІ:. ргоііоііуре - один из немногих объектов, которые не имеют прототипа: у не¬ 
го нет унаследованных свойств. Другие объекты-прототипы являются самыми 
обычными объектами, имеющими собственные прототипы. Все встроенные кон¬ 
структоры (и большинство пользовательских конструкторов) наследуют прото¬ 
тип 0Ь]ес1:.рго1:о1:уре. Например, 0а1:е. ргоііоііуре наследует свойства от ОЬ^есІ:. ргоѣо- 
1:уре, поэтому объект 0а1:е, созданный выражением пе\л/ Эа1:е(), наследует свойства 
от обоих прототипов, Оаіе.ргоіоііуре и 0Ь]ес1:.рго1:о1:уре. Такая связанная последо¬ 
вательность объектов-прототипов называется цепочкой прототипов . 

Описание механизма наследования свойств приводится в разделе 6.2.2. Как по¬ 
лучить ссылку на прототип объекта, рассказывается в разделе 6.8.1. А в главе 9 
более детально будет обсуждаться связь между прототипами и конструкторами: 
там будет показано, как определять новые «классы» объектов посредством объяв¬ 
ления функций-конструкторов и как записывать ссылку на объект-прототип 
в их свойство ргоііоііуре для последующего использования «экземплярами», соз¬ 
данными с помощью этого конструктора. 
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6.1.4. ОЬіес1.сгеаІе() 

Стандарт ЕСМАВсгірі 5 определяет метод 0Ь]ес1:.сгеа1:е(), который создает новый 
объект и использует свой первый аргумент в качестве прототипа этого объекта. 
Дополнительно 0Ь]ес1:.сгеа1:е() может принимать второй необязательный аргу¬ 
мент, описывающий свойства нового объекта. Описание этого второго аргумента 
приводится в разделе 6.7. 

0Ь]ес1:.сгеа1:е() является статической функцией, а не методом, вызываемым отно¬ 
сительно некоторого конкретного объекта. Чтобы вызвать эту функцию, доста¬ 
точно передать ей желаемый объект-прототип: 

ѵаг оі = ОЬ^есІ: . сгеа1:е( {х: 1, у:2}); // оі наследует свойства х и у. 

Чтобы создать объект, не имеющий прототипа, можно передать значение пиіі, но 
в этом случае вновь созданный объект не унаследует ни каких-либо свойств, ни 
базовых методов, таких как 1о81гіпд() (а это означает, что этот объект нельзя бу¬ 
дет использовать в выражениях с оператором +): 

ѵаг о2 = ОЬ^есІ:. сгеа1:е(пи11); // о2 не наследует ни свойств, ни методов. 

Если в программе потребуется создать обычный пустой объект (который, напри¬ 
мер, возвращается литералом {} или выражением пеѵѵ 0Ь]ес1:()), передайте в пер¬ 
вом аргументе ОЬ^есІ:. ргоііоііуре: 

ѵаг оЗ = ОЬ^есІ:. сгеа1:е(0Ь^ес1:. ргоііоіуре); // оЗ подобен объекту, созданному 

// с помощью {} или пеѵ/ ОЬ^есІ:(). 

Возможность создавать новые объекты с произвольными прототипами (скажем 
иначе: возможность создавать «наследников» от любых объектов) является мощ¬ 
ным инструментом, действие которого можно имитировать в ЕСМАВсгірі; 3 с по¬ 
мощью функции, представленной в примере 6.1. 1 


Пример 6.1 . Создание нового объекта , наследующего прототип 


// іпНегіЛО возвращает вновь созданный объект, наследующий свойства 
// объекта-прототипа р. Использует функцию ОЬ^есІ:. сгеа*е() из ЕСМАЗсгірІ: 5, 
// если она определена, иначе используется более старый прием. 

ТипсЬіоп іпНегіі(р) { 

11= (р == пиіі) Ѵпгоѵі ТуреЕггогО; // р не может быть значением пиіі 
іТ (ОЬіес*.сгеаііе) // Если ОЬ^есІ:.сгеа1:е() определена... 

геіигп ОЬіесЬ.сгеаІе(р); // использовать ее. 
ѵаг 1: = іуреоТ р; // Иначе выяснить тип и проверить его 

ІТ (1: !== "оЬіесІ" && 1: !== "-Рипсіііоп") ІИгоѵ/ ТуреЕггогО; 

ТипсЬіоп Т() {}; // Определить фиктивный конструктор. 

Т.ргоіоіуре = р; // Записать в его свойство ргоіоіуре 

// ссылку на объект р. 

геТигп пеѵ/ Т(); // Использовать Т() для создания 

// "наследника" объекта р. 


} 


1 Дуглас Крокфорд (Бои&іаз Сгоскіогб) считается первым, кто реализовал функцию, соз¬ 
дающую объекты таким способом. См. Ыір:/Цаѵавсгірі.сгоскІогд.сот/ргоШураІ.ЫтІ. 
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Реализация функции іпГіегі1:() приобретет больше смысла, как только мы позна¬ 
комимся с конструкторами в главе 9. А пока просто считайте, что она возвращает 
новый объект, наследующий свойства объекта в аргументе. Обратите внимание, 
что функция іпЬегіГО не является полноценной заменой для ОуесГ.сгеаГеО: она 
не позволяет создавать объекты без прототипа и не принимает второй необяза¬ 
тельный аргумент, как ОЬ^есІ:. сгеа1:е(). Тем не менее мы будем использовать функ¬ 
цию іпЬегіГО во многих примерах в этой главе и в главе 9. 

Функцию іпЬегіГО можно использовать, чтобы защитить объекты от непредна¬ 
меренного (не с целью нанести вред) изменения их библиотечными функциями, 
неподконтрольными вам. Вместо того чтобы передавать функции сам объект не¬ 
посредственно, можно передать его наследника. Если функция прочитает свойст¬ 
ва наследника, она получит унаследованные значения. Однако если она изменяет 
значения свойств, эти изменения коснутся только наследника и никак не отра¬ 
зятся на оригинальном объекте: 

ѵаг о = { х: "не изменяйте это значение" }; 

1іЬгагу_Гипс1:іоп(іпЬегіі:(о)); // Защита объекта о от непреднамеренного изменения 

Чтобы понять принцип действия этого приема, необходимо знать, как произво¬ 
дится чтение и запись значений свойств объектов в языке ЛѵаВсгірі;. Об этом рас¬ 
сказывается в следующем разделе. 

6.2. Получение и изменение свойств 

Получить значение свойства можно с помощью операторов точки (.) и квадратных 
скобок ([ ]), описанных в разделе 4.4. Слева от оператора должно находиться выра¬ 
жение, возвращающее объект. При использовании оператора точки справа дол¬ 
жен находиться простой идентификатор, соответствующий имени свойства. При 
использовании квадратных скобок в квадратных скобках должно указываться 
выражение, возвращающее строку, содержащую имя требуемого свойства: 

ѵаг аиГЬог = Ьоок.аиГЬог; // Получить свойство "аиГЬог" объекта Ьоок. 

ѵаг пате = аиГЬог.зигпате // Получить свойство "зигпате" объекта аиГЬог. 

ѵаг Шіе = Ьоок["таіп ГіИе"] // Получить свойство "таіп ГіИе" объекта Ьоок. 

Чтобы создать новое свойство или изменить значение существующего свойства, 
также используются операторы точки и квадратные скобки, как в операциях 
чтения значений свойств, но само выражение помещается уже слева от оператора 
присваивания: 

Ьоок. есІіГіоп = 6; // Создать свойство "есІіГіоп" объекта Ьоок. 

Ьоок["таіп ГіИе"] = ”ЕСМАЗс гірі: "; // Изменить значение свойства "таіп ГіИе". 

В ЕСМАВсгірі; 3 идентификатор, следующий за точкой, не может быть зарезерви¬ 
рованным словом: нельзя записать обращение к свойству о.Гог или о.сіазз, пото¬ 
му что Гог является ключевым словом, а сіазз - словом, зарезервированным для 
использования в будущем. Если объект имеет свойства, имена которых совпада¬ 
ют с зарезервированными словами, для доступа к ним необходимо использовать 
форму записи с квадратными скобками: о["Гог"] и о[ "сіазз "]. Стандарт ЕСМА- 
Всгірі 5 ослабляет это требование (как это уже сделано в некоторых реализациях 
ЕСМАВсгірГ 3) и допускает возможность использования зарезервированных слов 
после оператора точки. 
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Выше уже говорилось, что при использовании формы записи с квадратными 
скобками выражение в скобках должно возвращать строку. Если быть более точ¬ 
ными, это выражение должно возвращать строку или значение, которое может 
быть преобразовано в строку. В главе 7, например, мы увидим распространенный 
прием использования чисел в квадратных скобках. 

6.2.1. Объекты как ассоциативные массивы 

Как отмечалось выше, следующие два выражения возвращают одно и то же зна¬ 
чение: 

оЬ^есІ:. ргорегіу 
оЬзесІіГ'ргорегіу] 

Первая форма записи, с использованием точки и идентификатора, напоминает 
синтаксис доступа к статическому полю структуры или объекта в языке С или 
^ѵа. Вторая форма записи, с использованием квадратных скобок и строки, вы¬ 
глядит как обращение к элементу массива, но массива, который индексируется 
строками, а не числами. Такого рода массивы называются ассоциативными мас¬ 
сивами (а также хешами и словарями). Объекты в языке ^ѵаВсгірі; являются ас¬ 
социативными массивами, и в этом разделе объясняется, почему это так важно. 

В С, С++, ^ѵа и других языках программирования со строгим контролем типов 
объект может иметь только фиксированное число свойств, а имена этих свойств 
должны определяться заранее. Поскольку ^ѵаВсгірі относится к языкам про¬ 
граммирования со слабым контролем типов, данное правило в нем не действует: 
программы могут создавать любое количество свойств в любых объектах. Однако 
при использовании для обращения к свойству оператора точка (.) имя свойства 
определяется идентификатором. Идентификаторы должны вводиться в тексте 
программы буквально - это не тип данных, поэтому в программе невозможно 
реализовать вычисление идентификаторов. 

Напротив, когда для обращения к свойствам объекта используется форма записи 
с квадратными скобками ([]), имя свойства определяется строкой. Строки в язы¬ 
ке ЛѵаВсгірі являются типом данных, поэтому они могут создаваться и изме¬ 
няться в ходе выполнения программы. Благодаря этому, например, в языке ^ѵа- 
Всгірі; имеется возможность писать такой программный код: 

ѵаг асісіг = 

^ог(і =0; і < 4; і++) 

асісіг += сиз1:огпег["асІсІге55" + і] + ‘\п'; 

Этот фрагмент читает и объединяет в одну строку значения свойств асМгеззО, 
асісігеззі, асМгезз2 и асМгеззЗ объекта сизіотег. 

Этот короткий пример демонстрирует гибкость использования формы записи 
с квадратными скобками и строковыми выражениями для доступа к свойствам 
объекта. Пример выше можно переписать с использованием оператора точки, но 
иногда встречаются случаи, когда доступ к свойствам можно организовать толь¬ 
ко с помощью формы записи с квадратными скобками. Представим, например, 
что необходимо написать программу, использующую сетевые ресурсы для вы¬ 
числения текущего значения инвестиций пользователя в акции. Программа 
должна позволять пользователю вводить имя каждой компании, акциями кото¬ 
рой он владеет, а также количество акций каждой компании. Для хранения этих 
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данных можно было бы создать объект с именем рог1:Го1іо. Объект имеет по одно¬ 
му свойству для каждой компании. Имя свойства одновременно является назва¬ 
нием компании, а значение свойства определяет количество акций этой компа¬ 
нии. То есть если, к примеру, пользователь владеет 50 акциями компании ІВМ, 
свойство рог1:Го1іо.іЬт будет иметь значение 50. 

Следующая функция, добавляющая информацию об очередном пакете акций, 
могла бы быть частью такой программы: 

Гипсіііоп аРсІзІіоскСрогі^оІіо, зііоскпате, зМагез) { 
рогіІ'оІіоЕзіоскпате] = зМагез; 

} 

Поскольку пользователь вводит имена компаний во время выполнения, нет ни¬ 
какого способа заранее определить эти имена. А так как на момент создания про¬ 
граммы имена свойств нам неизвестны, мы не можем использовать оператор точ¬ 
ки (.) для доступа к свойствам объекта рогІіГоІіо. Однако мы можем задействовать 
оператор [], потому что для обращения к свойствам он позволяет использовать 
строковые значения (которые являются динамическими и могут изменяться во 
время выполнения) вместо идентификаторов (которые являются статическими 
и должны жестко определяться в тексте программы). 

В главе 5 был представлен цикл Гог/іп (и еще раз мы встретимся с ним чуть ниже, 
в разделе 6.5). Мощь этой инструкции языка ^ѵаВсгірі; становится особенно оче¬ 
видной, когда она применяется для работы с ассоциативными массивами. Ниже 
показано, как можно использовать ее для вычисления суммарного объема инве¬ 
стиций в рогІіГоІіо: 

Гипсіііоп деІѵаІиеСрогігІ'оІіо) { 
ѵаг іоіаі = 0.0; 

Гог(з1:оск іп рог^оііо) { 

ѵаг зМагез = рогі: 1=о1іо[зііоск]; 
ѵаг ргісе = де1:дио1:е(з1:оск); 

Ііоііаі += зМагез * ргісе; 

} 

геіигп іоіаі; 

} 

6.2.2. Наследование 

Объекты в языке ^ѵаВсгірі обладают множеством «собственных свойств» и мо¬ 
гут также наследовать множество свойств от объекта-прототипа. Чтобы разо¬ 
браться в этом, необходимо внимательно изучить механизм доступа к свойствам. 
В примерах этого раздела для создания объектов с определенными прототипами 
используется функция іпИегі1:() из примера 6.1. 

Предположим, что программа обращается к свойству х объекта о. Если объект о 
не имеет собственного свойства с таким именем, выполняется попытка отыскать 
свойство х в прототипе объекта о. Если объект-прототип не имеет собственного 
свойства с этим именем, но имеет свой прототип, выполняется попытка отыскать 
свойство в прототипе прототипа. Так продолжается до тех пор, пока не будет най¬ 
дено свойство х или пока не будет достигнут объект, не имеющий прототипа. Как 
видите, атрибут ргоііоііуре объекта создает цепочку, или связанный список объек¬ 
тов, от которых наследуются свойства. 


// Для каждой компании в рогІіГоІіо : 
// получить количество акций 
// отыскать стоимость одной акции 
// прибавить к суммарному значению 

// Вернуть сумму. 
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ѵаг о = {} 

o. х = 1; 

ѵаг р = іпМегіЩо); 

p. у = 2; 

ѵаг д = іпМегі1:(р); 
д.2 = 3; 

ѵаг з = д.Щ$Ігіпд(); 
д.х + д.у 


// о наследует методы объекта ОЬ^есІ:. ргоЩІуре 
// и обладает собственным свойством х. 

// р наследует свойства объектов о и ОЬ^есІ:. ргсАоІуре 
// и обладает собственным свойством у. 

// д наследует свойства объектов р, о и ОЬ^есІ:.ргоіоіуре 
// и обладает собственным свойством г. 

// То$Тгіпд наследуется от ОЬ^есІ: . ргоТоТуре 
// => 3: х и у наследуются от о и р 


Теперь предположим, что программа присваивает некоторое значение свойству х 
объекта о. Если объект о уже имеет собственное свойство (не унаследованное) 
с именем х, то операция присваивания просто изменит значение существующего 
свойства. В противном случае в объекте о будет создано новое свойство с именем х. 
Если прежде объект о наследовал свойство х, унаследованное свойство теперь ока¬ 
жется скрыто вновь созданным собственным свойством с тем же именем. 

Операция присваивания значения свойству проверит наличие этого свойства в це¬ 
почке прототипов, чтобы убедиться в допустимости присваивания. Например, ес¬ 
ли объект о наследует свойство х, доступное только для чтения, то присваивание 
выполняться не будет. (Подробнее о том, когда свойство может устанавливаться, 
рассказывается в разделе 6.2.3.) Однако если присваивание допустимо, всегда соз¬ 
дается или изменяется свойство в оригинальном объекте и никогда в цепочке про¬ 
тотипов. Тот факт, что механизм наследования действует при чтении свойств, но 
не действует при записи новых значений, является ключевой особенностью языка 
ЛѵаВсгірі;, потому что она позволяет выборочно переопределять унаследованные 
свойства: 


ѵаг ипііхігсіе = { г:1 }; // Объект, от которого наследуется свойство 

ѵаг с = іпІіегі*(ипі1:сігс1е); // с наследует свойство г 
с.х = 1; с.у = 1; //с определяет два собственных свойства 

с.г = 2; //с переопределяет унаследованное свойство 

ипіЛсігсІе. г; // => 1: объект-прототип не изменился 

Существует одно исключение из этого правила, когда операция присваивания 
значения свойству терпит неудачу или приводит к созданию/изменению свойства 
оригинального объекта. Если объект о наследует свойство х и доступ к этому свой¬ 
ству осуществляется посредством методов доступа (раздел 6.6), то вместо созда¬ 
ния нового свойства х в объекте о производится вызов метода записи нового значе¬ 
ния. Однако обратите внимание, что метод записи вызывается относительно объ¬ 
екта о, а не относительно прототипа, в котором определено это свойство, поэтому, 
если метод записи определяет какие-либо свойства, они будут созданы в объекте 
о, а цепочка прототипов опять останется неизменной. 


6.2.3. Ошибки доступа к свойствам 

Выражения обращения к свойствам не всегда возвращают или изменяют значе¬ 
ние свойства. В этом разделе описываются ситуации, когда операции чтения или 
записи свойства терпят неудачу. 

Попытка обращения к несуществующему свойству не считается ошибкой. Если 
свойство х не будет найдено среди собственных или унаследованных свойств объ¬ 
екта о, выражение обращения к свойству о.х вернет значение ипсіе^іпесі. Напомню, 
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что наш объект Ьоок имеет свойство с именем «зиЪЧШе», но не имеет свойства 
«зиЫШе»: 

Ьоок. зиЬГіПе; // => ипсіе^іпесі : свойство отсутствует 

Однако попытка обратиться к свойству несуществующего объекта считается ошиб¬ 
кой. Значения пиіі и ипсІеГіпесІ не имеют свойств, и попытки обратиться к свойст¬ 
вам этих значений считаются ошибкой. Продолжим пример, приведенный выше: 

// Возбудит исключение ТуреЕггог. Значение ипсІеГіпесІ не имеет свойства ІепдГЬ 
ѵаг Іеп = Ьоок.зиЬГШе. ІепдГЬ; 

Если нет уверенности, что Ьоок и Ьоок. зиЬГШе являются объектами (или ведут се¬ 
бя подобно объектам), нельзя использовать выражение Ьоок. зиЬГШе. ІепдГЬ, так 
как оно может возбудить исключение. Ниже демонстрируются два способа защи¬ 
ты против исключений подобного рода: 

// Более наглядный и прямолинейный способ 
ѵаг Іеп = ипсІеГіпесІ; 

ІГ (Ьоок) { 

ІГ (Ьоок. зиЬГШе) Іеп = Ьоок. зиЬГШе. ІепдГЬ; 

} 

// Более краткая и характерная для иаѵаЗсгірГ альтернатива получения длины 
// значения свойства зиЬГШе 

ѵаг Іеп = Ьоок && Ьоок. зиЬГШе && Ьоок. зиЫііІіІе. ІепдГЬ; 

Чтобы понять, почему второе выражение позволяет предотвратить появление ис¬ 
ключений ТуреЕггог, можете вернуться к описанию короткой схемы вычислений, 
используемой оператором &&, в разделе 4.10.1. Разумеется, попытка установить 
значение свойства для значения пиіі или ипсІеГіпесІ также вызывает исключение 
ТуреЕггог. 

Попытки установить значение свойства для других значений не всегда оканчива¬ 
ются успехом: некоторые свойства доступны только для чтения и не позволяют 
изменять их значения. Кроме того, некоторые объекты не позволяют добавлять 
в них новые свойства. Однако самое интересное, что подобные неудачи, как пра¬ 
вило, не приводят к возбуждению исключения: 

// Свойства ргоГоГуре встроенных конструкторов доступны только для чтения. 

ОЬ^есГ.ргоГоГуре = 0; // Присваивание не возбудит исключения; 

// значение ОЬ^есГ.ргоГоГуре не изменится 

Этот исторически сложившийся недостаток ЛѵаВсгірІ исправлен в строгом ре¬ 
жиме, определяемом стандартом ЕСМАВсгірі 5. Все неудачные попытки изме¬ 
нить значение свойства в строгом режиме приводят к исключению ТуреЕггог. 

Правила, позволяющие определить, когда попытка выполнить операцию при¬ 
сваивания завершится успехом, а когда неудачей, просты и понятны, но их слож¬ 
но выразить в достаточно краткой форме. Попытка присвоить значение свойству р 
объекта о потерпит неудачу в следующих случаях: 

• Объект о имеет собственное свойство р, доступное только для чтения: нельзя 
изменить значение свойства, доступного только для чтения. (Обратите, однако, 
внимание на метод йеГіпеРгорегГуО, который представляет собой исключение, 
позволяющее изменять значения настраиваемых свойств, доступных только 
для чтения.) 
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• Объект о имеет унаследованное свойство р, доступное только для чтения: унас¬ 
ледованные свойства, доступные только для чтения, невозможно переопреде¬ 
лить собственными свойствами с теми же именами. 

• Объект о не имеет собственного свойства р; объект о не наследует свойство р 
с методами доступа и атрибут ехІепзіЫе (раздел 6.8.3) объекта о имеет значе¬ 
ние 1"а1зе. Если свойство р отсутствует в объекте о и для него не определен ме¬ 
тод записи, то операция присваивания попытается добавить свойство р в объ¬ 
ект о. Но поскольку объект о не допускает возможность расширения, то попыт¬ 
ка добавить в него новое свойство потерпит неудачу. 

6.3. Удаление свойств 

Оператор сіеіеііе (раздел 4.13.3) удаляет свойство из объекта. Его единственный 
операнд должен быть выражением обращения к свойству. Может показаться уди¬ 
вительным, но оператор сіеіеііе не оказывает влияния на значение свойства - он 
оперирует самим свойством: 

сіеіеііе Ьоок.аиІМог; // Теперь объект Ьоок не имеет свойства аи'ЕМог. 

сіеіеііе Ьоок["таіп іШе"]; // Теперь он не имеет свойства "таіп іііііе". 

Оператор сіеіеііе удаляет только собственные свойства и не удаляет унаследован¬ 
ные. (Чтобы удалить унаследованное свойство, необходимо удалять его в объек¬ 
те-прототипе, в котором оно определено. Такая операция затронет все объекты, 
наследующие этот прототип.) 

Выражение сіеіеііе возвращает значение Іігие в случае успешного удаления свойст¬ 
ва или когда операция удаления не привела к изменению объекта (например, при 
попытке удалить несуществующее свойство). Выражение сіеіеііе также возвраща¬ 
ет Іігие, когда этому оператору передается выражение, не являющееся выражени¬ 
ем обращения к свойству: 

о = {х: 1}; //о имеет собственное свойство х и наследует ІіоЗіігіпд 

сіеіеііе о.х; // Удалит х и вернет Іігие 

сіеіеііе о.х; // Ничего не сделает (х не существует) и вернет Іігие 

сіеіеііе о. ІіоЗіігіпд; // Ничего не сделает (іоЗіігіпд не собственное свойство) и вернет ігие 

сіеіеііе 1; // Бессмысленно, но вернет Іігие 

Оператор сіеіеііе не удаляет ненастраиваемые свойства, атрибут сопІ'ідигаЫе кото¬ 
рых имеет значение 1"а1зе. (Однако он может удалять настраиваемые свойства не¬ 
расширяемых объектов.) Ненастраиваемыми являются свойства встроенных объ¬ 
ектов, а также свойства глобального объекта, созданные с помощью инструкций 
объявления переменных и функций. Попытка удалить ненастраиваемое свойство 
в строгом режиме вызывает исключение Туре Ег го г. В нестрогом режиме (и в реа¬ 
лизациях ЕСМАЗсгірі; 3) в таких случаях оператор сіеіеііе просто возвращает 
1"а1зе: 

сіеіеііе О^есіі. ргоіоііуре; // Удаление невозможно - ненастраиваемое свойство 
ѵаг х = 1; // Объявление глобальной переменной 

сіеіеііе Шз. х; // Это свойство нельзя удалить 

іипсіііоп і() {} // Объявление глобальной функции 

сіеіеііе ііііз.Г; // Это свойство также нельзя удалить 
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При удалении настраиваемых свойств глобального объекта в нестрогом режиме 
допускается опускать ссылку на глобальный объект и передавать оператору 
сіеіеііе только имя свойства: 

Гіііз.х = 1; // Создать настраиваемое глобальное свойство (без ѵаг) 

сіеіеіе х; // И удалить его 

Однако в строгом режиме оператор сіеіеііе возбуждает исключение ЗупГахЕггог, ес¬ 
ли его операндом является неквалифицированный идентификатор, такой как х, 
поэтому необходимо указывать явное выражение обращения к свойству: 

сіеіеііе х; // В строгом режиме возбудит исключение ЗупГахЕггог 

сіеіеііе Гіііз.х; // Такой способ работает 

6.4. Проверка существования свойств 

Объекты в языке ^ѵаВсгірі; можно рассматривать как множества свойств, и не¬ 
редко бывает полезно иметь возможность проверить принадлежность к множест¬ 
ву - проверить наличие в объекте свойства с данным именем. Выполнить такую 
проверку можно с помощью оператора іп, с помощью методов НазОмпРгорегГуО 
и ргорегТуІзЕпитегаЫеО или просто обратившись к свойству. 

Оператор іп требует, чтобы в левом операнде ему было передано имя свойства 
(в виде строки) и объект в правом операнде. Он возвращает Ггие, если объект име¬ 
ет собственное или унаследованное свойство с этим именем: 

ѵаг о = { х: 1 } 

”х" іп о; // Ггие: о имеет собственное свойство "х" 

"у" іп о; // Гаізе: о не имеет свойства "у" 

"ІіоЗіігіпд" іп о; // Ггие: о наследует свойство ГоЗГгіпд 

Метод НазОѵѵпРгорегГуО объекта проверяет, имеет ли объект собственное свойство 
с указанным именем. Для наследуемых свойств он возвращает Гаізе: 

ѵаг о = { х: 1 } 

о. МазО\ѵпРгорег1:у("х"); // Ггие: о имеет собственное свойство х 

о. ИазО\ѵпР горег1:у("у"); // Гаізе: не имеет свойства у 

о. ИазОѵу/пР горег1:у("1:о31: гіпд "); // Гаізе: ГоЗГгіпд - наследуемое свойство 

Метод ргорегГуІзЕпитегаЬІеО накладывает дополнительные ограничения по срав¬ 
нению с ИазОѵѵпРгорегГуО. Он возвращает Ггие, только если указанное свойство яв¬ 
ляется собственным свойством, атрибут епитегаЫе которого имеет значение Ггие. 
Свойства встроенных объектов не являются перечислимыми. Свойства, создан¬ 
ные обычной программой на языке Лѵабсгірі;, являются перечислимыми, если 
не был использован один из методов ЕСМАбсгірі 5, представленных ниже, кото¬ 
рые делают свойства неперечислимыми. 

ѵаг о = іпітегіі: ({ у: 2 }); 
о.х = 1; 

о. ргорегіуІзЕпитегаЫеС "х”); // Ггие: о имеет собств. перечислимое свойство х 
о. ргорегіуІзЕпитегаЫеС "у"); // Гаізе: у - унаследованное свойство, не собств. 

О^есГ. ргоГоГуре. ргорегіуІзЕпитегаЫеС'ГоЗігіпд”); // Гаізе: неперечислимое 

Часто вместо оператора іп достаточно использовать простое выражение обраще¬ 
ния к свойству и использовать оператор ! == для проверки на неравенство значе¬ 
нию ипРеГіпесІ: 
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ѵаг о = { х: 1 } 

о.х !== ипсІе'ГіпесІ : // Ггие: о имеет свойство х 

о.у !== ипсІеГіпесІ; // Гаізе: о не имеет свойства у 

о.ГоЗігіпд !== ипсІе'ГіпесІ; // 1:гие: о наследует свойство ГоЗГгіпд 


Однако оператор іп отличает ситуации, которые неотличимы при использовании 
представленного выше приема на основе обращения к свойству. Оператор іп отли¬ 
чает отсутствие свойства от свойства, имеющего значение ипсІеГіпесІ. Взгляните на 
следующий пример: 


ѵаг о = { х: ипсІеГіпесІ 
о.х ! == ипсІеГіпесІ 
о. у ! == ипсІеГіпесІ 
"х" іп о 
"у” іп о 
сЗеІеГе о.х; 

"х" іп о 


// Свойству явно присвоено значение ипсІеГіпесІ 

// Гаізе: свойство имеется, но со значением ипсІеГіпесІ 

// Гаізе: свойство не существует 

// Г гие: свойство существует 

// Гаізе: свойство не существует 

// Удалить свойство х 

// Гаізе: оно больше не существует 


Обратите внимание, что в примере выше использован оператор ! ==, а не ! =. Опера¬ 
торы !== и === отличают значения ипсІеГіпесІ и пиіі, хотя иногда в этом нет необхо¬ 
димости: 


// Если о имеет свойство х, значение которого отлично от піііі и ипсІеГіпесІ, 
// то удвоить это значение. 

ІГ (о.х != пиіі) о.х *= 2; 


// Если о имеет свойство х, значение которого не может быть преобразовано в Гаізе, 

// то удвоить это значение. Если х имеет значение ипсІеГіпесІ , пиіі, Гаізе, 0 или ІШ, 
// оставить его в исходном состоянии. 

ІГ (о.х) о.х *= 2; 
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Вместо проверки наличия отдельных свойств иногда бывает необходимо обойти 
все имеющиеся свойства или получить список всех свойств объекта. Обычно для 
этого используется цикл Гог/іп, однако стандарт ЕСМАВсгірі 5 предоставляет две 
удобные альтернативы. 

Инструкция цикла Гог/іп рассматривалась в разделе 5.5.4. Она выполняет тело 
цикла для каждого перечислимого свойства (собственного или унаследованного) 
указанного объекта, присваивая имя свойства переменной цикла. Встроенные 
методы, наследуемые объектами, являются неперечислимыми, а свойства, до¬ 
бавляемые в объекты вашей программой, являются перечислимыми (если толь¬ 
ко не использовались функции, описываемые ниже, позволяющие сделать свой¬ 
ства неперечислимыми). Например: 

ѵаг о = {х:1, у:2, 2:3}; // Три собственных перечислимых свойства 

о. ргорегіуІзЕпитегаЫеС'ГоЗіігіпд" ) // => Гаізе: неперечислимое 
Гог(р іп о) // Цикл по свойствам 

сопзоіе. 1од(р); // Выведет х, у и 2 , но не ГоЗГгіпд 

Некоторые библиотеки добавляют новые методы (или другие свойства) в объект 
ОЩесТ.ргоТоТуре, чтобы они могли быть унаследованы и быть доступны всем объ¬ 
ектам. Однако до появления стандарта ЕСМАВсгірі 5 отсутствовала возможность 




150 


Глава 6. Объекты 


сделать эти дополнительные методы неперечислимыми, поэтому они оказыва¬ 
лись доступными для перечисления в циклах Гог/іп. Чтобы решить эту проблему, 
может потребоваться фильтровать свойства, возвращаемые циклом Гог/іп. Ниже 
приводятся два примера реализации такой фильтрации: 

Гог(р іп о) { 

іГ (! о. ПазОѵ/пРгорегіуСр)) сопііпие; // Пропустить унаследованные свойства 

} 

Гог(р іп о) { 

ІГ (іуреоГ о[р] === "ГипсГіоп”) сопііпие; // Пропустить методы 

} 

В примере 6.2 определяются вспомогательные функции, использующие цикл Гог/ 
іп для управления свойствами объектов. Функция ехГепсі(), в частности, часто ис¬ 
пользуется в библиотеках ^ѵаВсгірі. 1 

Пример 6.2. Вспомогательные функции, используемые для перечисления 
свойств объектов 

/* 

* Копирует перечислимые свойства из объекта р в объект о и возвращает о. 

* Если о и р имеют свойства с одинаковыми именами, значение свойства 

* в объекте о затирается значением свойства из объекта р. 

* Эта функция не учитывает наличие методов доступа и не копирует атрибуты. 

*/ 

ГипсГіоп ехіепсІ(о, р) { 

Гог(ргор іп р) { // Для всех свойств в р. 

о[ргор] = р[ргор]; // Добавить свойство в о. 

} 

геГигп о; 

} 

/* 

* Копирует перечислимые свойства из объекта р в объект о и возвращает о. 

* Если о и р имеют свойства с одинаковыми именами, значение свойства 

* в объекте о остается неизменным. 

* Эта функция не учитывает наличие методов доступа и не копирует атрибуты. 

*/ 

ГипсГіоп тегде(о, р) { 

Гог(ргор іп р) { // Для всех свойств в р. 

іГ (о. НазОѵ/п Р горе гіу[ ргор]) сопііпие; // Кроме имеющихся в о. 
о[ргор] = р[ргор]; // Добавить свойство в о. 

} 

геГигп о; 

} 

/* 

* Удаляет из объекта о свойства, отсутствующие в объекте р. 

* Возвращает о. 

V 


1 Функция ехіепсК ), представленная здесь, реализована правильно, но она не компенси¬ 
рует хорошо известную проблему в Іпіегпеі Ехріогег. Более надежная версия функции 
ехіепсК) будет представлена в примере 8.3. 
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Еъпсііоп гезТгісТ(о, р) { 

г(ргор іп о) { // Для всех свойств в о 

іі (!(ргор іп р)) Реіеіе о[ргор]; // Удалить, если отсутствует в р 

} 

геіъгп о; 

} 

Л 

* Удаляет из объекта о свойства, присутствующие в объекте р. Возвращает о. 

*/ 

Еъпсііоп 5ъЫ:гас1:(о, р) { 

^ог(ргор іп р) { // Для всех свойств в р 

Реіеіе о[ргор]; // Удалить из о (удаление несуществующих 

// свойств можно выполнять без опаски) 

} 

геіъгп о; 

} 

Л 

* Возвращает новый объект, содержащий свойства, присутствующие хотя бы в одном 

* из объектов, о или р. Если оба объекта, о и р, имеют свойства с одним 

* и тем же именем, используется значение свойства из объекта р. 

*/ 

Еъпсііоп ъпіопСо.р) { геіъгп ехіепсКехіепсК {} ,о), р); } 

Л 

* Возвращает новый объект, содержащий свойства, присутствующие сразу в обоих 

* объектах, о или р. Результат чем-то напоминает пересечение о и р, 

* но значения свойств объекта р отбрасываются 
*/ 

Еъпсііоп іпіегзесііопСо, р) { геіъгп гезі:гісі: (ех1:епс1( {}, о), р); } 

Л 

* Возвращает массив имен собственных перечислимых свойств объекта о. 

*/ 

Еъпсііоп кеуз(о) { 

ІЕ (іуреоі о !== ”оЬ]есі") 1:1л гоѵѵ ТуреЕггогО; // Арг. должен быть объектом 
ѵаг гезіДі = []; // Возвращаемый массив 

іог(ѵаг ргор іп о) { // Для всех перечислимых свойств 

іЕ (о. ІпазОмпР горе гіу( ргор)) // Если это собственное свойство, 
гезиіі:.ризіл(ргор); // добавить его в массив аггау. 

} 

геіъгп гезіЯі; Вернуть массив. 

} 

В дополнение к циклу іог/іп стандарт ЕСМАЗсгірі 5 определяет две функции, пе¬ 
речисляющие имена свойств. Первая из них, ОЬ^есІ:. кеуз(), возвращает массив 
имен собственных перечислимых свойств объекта. Она действует аналогично 
функции кеуз() из примера 6.2. 

Вторая функция ЕСМАЗсгірі; 5, выполняющая перечисление свойств, - ОЩесі. 
деіОмпРгорегіуМатезО. Она действует подобно функции 0Ь]ес1:.кеуз(), но возвраща¬ 
ет имена всех собственных свойств указанного объекта, а не только перечисли¬ 
мые. В реализациях ЕСМАЗсгірі 3 отсутствует возможность реализовать подоб¬ 
ные функции, потому что ЕСМАЗсгірі 3 не предусматривает возможность полу¬ 
чения неперечислимых свойств объекта. 
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6.6. Методы чтения и записи свойств 

Выше уже говорилось, что свойство объекта имеет имя, значение и набор атрибут 
тов. В ЕСМА8сгірІ 5 1 значение может замещаться одним или двумя методами, 
известными как методы чтения (^еііег) и записи (зеііег). Свойства, для которых 
определяются методы чтения и записи, иногда называют свойствами с метода¬ 
ми доступа , чтобы отличать их от свойств с данными , представляющих простое 
значение. 

Когда программа пытается получить значение свойства с методами доступа, ин¬ 
терпретатор вызывает метод чтения (без аргументов). Возвращаемое этим мето¬ 
дом значение становится значением выражения обращения к свойству. Когда 
программа пытается записать значение в свойство, интерпретатор вызывает ме¬ 
тод записи, передавая ему значение, находящее справа от оператора присваива¬ 
ния. Этот метод отвечает за «установку» значения свойства. Значение, возвра¬ 
щаемое методом записи, игнорируется. 

В отличие от свойств с данными, свойства с методами доступа не имеют атрибута 
ѵѵгіІіаЫе. Если свойство имеет оба метода, чтения и записи, оно доступно для чте¬ 
ния/записи. Если свойство имеет только метод чтения, оно доступно только для 
чтения. А если свойство имеет только метод записи, оно доступно только для за¬ 
писи (такое невозможно для свойств с данными) и попытки прочитать значение 
такого свойства всегда будут возвращать ипсіе^іпесі. 

Самый простой способ определить свойство с методами доступа заключается 
в использовании расширенного синтаксиса определения литералов объектов: 

ѵаг о = { 

// Обычное свойство с данными 
ба1:а_ргор: ѵаіце, 

// Свойство с методами доступа определяется как пара функций 
деі ассеззог_ргор() { /* тело функции */ }, 
зеі: ассеззог_ргор(ѵа1це) { /* тело функции */ } 

}; 

Свойства с методами доступа определяются как одна или две функции, имена ко¬ 
торых совпадают с именем свойства и с заменой ключевого слова ^ипсііоп на деі: 
и/или зеі:. Обратите внимание, что не требуется использовать двоеточие для отде¬ 
ления имени свойства от функции, управляющей доступом к свойству, но по- 
прежнему необходимо использовать запятую после тела функции, чтобы отде¬ 
лить метод от других методов или свойств с данными. Для примера рассмотрим 
следующий объект, представляющий Декартовы координаты точки на плоско¬ 
сти. Для представления координат X и У в нем имеются обычные свойства с дан¬ 
ными, а также свойства с методами доступа, позволяющие получить эквивалент¬ 
ные полярные координаты точки: 

ѵаг р = { 

// х и у - обычные свойства с данными, доступные для чтения/записи, 
х: 1.0, 


1 И в последних версиях реализации стандарта ЕСМА8сгірі 3 в основных броузерах, 
кроме ІЕ. 
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у: 1.0, 

//г - доступное для чтения/записи свойство с двумя методами доступа. 
// Не забывайте добавлять запятые после методов доступа, 
деі: г() { геіигп МаІІ’і.здгКіІііз.х^І’ііз.х + ТІііз.у*1:Іііз.у); }, 
зеі: г(пемѵаіие) { 

ѵаг оісіѵаіие = МаІН.здг1:(1:Іііз.х*1;Іііз.х + ТНіз.у*ТНіз.у); 
ѵаг гаііо = пем/аіие/оібѵаіие; 

Шз.х *= гаііо; 

Шз.у *= гаіііо; 

}, 


// ІНеІа - доступное только для чтения свойство с единственным методом чтения, 
деі: ІНеІаО { геіигп МаІН.аТап2(ТІііз.у, ТІліз.х); } 

}; 

Обратите внимание на использование ключевого слова ІіМіз в методах чтения и за¬ 
писи выше. Интерпретатор будет вызывать эти функции, как методы объекта, 
в котором они определены, т. е. в теле функции ІИіз будет ссылаться на объект 
точки. Благодаря этому метод чтения свойства г может ссылаться на свойства х 
и у, как іііііз. х и Іііііз.у. Подробнее о методах и ключевом слове іііііз рассказывается 
в разделе 8.2.2. 

Свойства с методами доступа наследуются так же, как обычные свойства с дан¬ 
ными, поэтому объект р, определенный выше, можно использовать как прототип 
для других объектов точек. В новых объектах можно определять собственные 
свойства х и у, и они будут наследовать свойства г и іИе^а: 

ѵаг д = іпііегіі(р): // Создать новый объект, наследующий методы доступа 

д.х = 1; д.у = 1; // Создать собственные свойства с данными в объекте д 

сопзоіе. 1од(д.г); // И использовать унаследованные свойства 

сопзоіе. 1од(д. ІіИеІа ); // с методами доступа 

Фрагмент выше использует свойства с методами доступа для определения АРІ, 
обеспечивающего представление единого набора данных в двух системах коорди¬ 
нат (Декартовой и полярной). Еще одной причиной использования свойств с мето¬ 
дами доступа может быть необходимость проверки Значения перед записью и воз¬ 
врат разных значений при каждом чтении свойства: 

// Этот объект генерирует последовательность увеличивающихся чисел 
ѵаг зегіаіпит = { 

// Это свойство с данными хранит следующее число в последовательности. 

// Знак $ в имени свойства говорит о том, что оно является частным. 

$п: 0, 

// Возвращает текущее значение и увеличивает его 
деі: пех*() { ге*игп Шз.$п++; }, 

// Устанавливает новое значение п, но только если оно больше текущего 
зеі: пехі(п) { 

ІТ (п >= 11ііз.$п) *Ііі5.$п = п; 

еізе Ипгом "число может быть только увеличено 

} 

}; 

Наконец, ниже приводится еще один пример использования метода чтения для 
реализации свойства с «таинственным» поведением. 
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// Этот объект имеет свойства с методами доступа, при обращении к которым возвращаются 
// случайные числа. Например, каждый раз при вычислении выражения ” гапсіот.осіеГ" 

// будет возвращаться случайное число в диапазоне от 0 до 255. 
ѵаг гапсіот = { 

деГ осГеГО { геіигп МаГЬ. Г1оог(МаГЬ. гапс!от( )*256); }, 
деГ иіпГ16() { геіигп МаіЬ. ПоогСМаіІі. гапРот( )*65536); }. 
деі: іпі16() { геіигп МаіЬ. ПоогСМаіІі. гапРот()*65536)-32768: } 

}; 

В этом разделе было показано, как определять свойства с методами доступа при 
создании нового объекта с помощью литерала. В следующем разделе будет пока¬ 
зано, как добавлять свойства с методами доступа в существующие объекты. 

6.7. Атрибуты свойств 

Помимо имени и значения свойства обладают атрибутами, определяющими их 
доступность для записи, перечисления и настройки. В ЕСМАЗсгірі; 3 не преду¬ 
сматривается возможность изменения атрибутов: все свойства, создаваемые про¬ 
граммами, выполняющимися под управлением реализации ЕСМАЗсгірі; 3, дос¬ 
тупны для записи, перечисления и настройки, и нет никакой возможности изме¬ 
нить эти атрибуты. Данный раздел описывает прикладной интерфейс (АРІ), оп¬ 
ределяемый стандартом ЕСМАЗсгірі; 5 для получения и изменения атрибутов 
свойств. Данный АРІ имеет особое значение для разработчиков библиотек, пото¬ 
му что он позволяет: 

• добавлять методы в объекты-прототипы и делать их неперечислимыми, по¬ 
добно встроенным методам; 

• «ограничивать» возможности объектов за счет определения свойств, которые 
не могут изменяться или удаляться. 

Для целей данного раздела мы будем рассматривать методы чтения и записи 
свойств с методами как атрибуты свойств. Следуя этой логике, можно даже ска¬ 
зать, что значение свойства с данными также является атрибутом. Таким обра¬ 
зом, свойства имеют имя и четыре атрибута. Четырьмя атрибутами свойств с дан¬ 
ными являются: значение (ѵаіие), признак доступности для записи (мгііаЬІе), 
признак доступности для перечисления (епитегаЫе) и признак доступности для 
настройки (сопГідигаЬІе). В свойствах с методами доступа отсутствуют атрибуты 
ѵаіие и мгііаЬІе: их доступность для записи определяется наличием или отсутст¬ 
вием метода записи. Поэтому четырьмя атрибутами свойств с методами доступа 
являются: метод чтения (деі), метод записи (зеі), признак доступности для пе¬ 
речисления (епитегаЫе) и признак доступности для настройки (сопГідигаЬІе). 

Методы получения и записи значений атрибутов свойств, предусмотренные стан¬ 
дартом ЕСМАЗсгірі; 5, используют объект, называемый дескриптором свойства 
(ргорегіу (іезсгіріог), представляющий множество из четырех атрибутов. Объект 
дескриптора свойства обладает свойствами, имена которых совпадают с именами 
атрибутов свойства, которое он описывает. То есть объекты-дескрипторы свойств 
с данными имеют свойства с именами ѵаіие, мгііаЬІе, епитегаЫе и сопГідигаЬІе. 
А дескрипторы свойств с методами доступа вместо свойств ѵаіие и ѵѵгііаЬІе имеют 
свойства деі и зеі. Свойства ѵѵгііаЬІе, епитегаЫе и сопГідигаЬІе являются логиче¬ 
скими значениями, а свойства деі и зеі - функциями. 
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Получить дескриптор свойства требуемого объекта можно вызовом ОЬ^есІ:.деі:- 
0\л/пРгорег1:у0езсгір1:ог(): 

// Вернет {ѵаіие: 1, и/гііаЫе:1:гие, епишегаЫеіТгие, сопІідигаЫе^гие} 

ОЬ^есІ:.де1:0\ѵпРгорегі:у0езсгір1:ог({х: 1}, "х"); 

// Теперь получим свойство осіеі: объекта гапсіот, объявленного выше. 

// Вернет { деі: /♦^ипс*/, зеі: ипсіеііпесі, епитегаЫе:1:гие, сопІідигаЫе^гие} 

ОЬіесІ:.деІОмпРгорегііуОезсгіріогСгапсіот, "осіеі"); 

// Вернет ипсІеТіпес! для унаследованных и несуществующих свойств. 
0Ьіес1.де10\л/пРгорегі:у0е5Сгір1:ог({}, "х"); // ипсіеТіпесІ, нет такого свойства 

ОЬзесІ.деіОмпРгорегіуОезсгіріоги}, "■ЕоЗігіпд"); // ъпсІеТіпесІ, унаследованное 

Как можно заключить из названия метода, 0уес1.де10ѵ\/пРгорег1у0езсгір1:ог() рабо¬ 
тает только с собственными свойствами. Чтобы получить атрибуты унаследован¬ 
ного свойства, необходимо явно выполнить обход цепочки прототипов (смотрите 
описание ОЬ^есІі.деІіРгоІіоІіуреОІЧ) в разделе 6.8.1). 

Чтобы изменить значение атрибута свойства или создать новое свойство с задан¬ 
ными значениями атрибутов, следует вызвать метод ОЬзесІ.сіеІіпеРгорегІіуО, пере¬ 
дав ему объект, в котором требуется выполнить изменения, имя создаваемого 
или изменяемого свойства и объект дескриптора свойства: 

ѵаг о = {}; // Создать пустой объект без свойств 

// Создать неперечислимое простое свойство х со значением 1. 

ОЬіесІ.сіеІіпеРгорегіуСо, "х", { ѵаіие : 1, 

мгіІаЫе: Ігие, 
епитегаЫе: Іаізе, 
сопІідигаЫе: Ігие}); 

// Убедиться, что свойство создано и является неперечислимым 
о.х; // => 1 

ОЬзесІ. кеуз(о) // => [] 

// Теперь сделать свойство х доступным только для чтения 
ОЬ^есІ:.сІеТіпеРгорег1:у(о, "х", { мгіІаЫе: Іаізе }); 

// Попытаться изменить значение свойства 

о.х = 2; // Неудача, в строгом режиме возбудит ТуреЕггог 

о.х // => 1 

// Свойство все еще доступно для настройки, его значение можно изменить так: 
ОЬзесТ.сІеЕіпеРгореПуСо, "х", { ѵаіие: 2 }); 
о.х // => 2 

// Теперь превратить простое свойство в свойство с методами доступа 
ОбіесТ.сІеЕіпеРгорегІуСо, "х", { деі: ІипсІіопО { геТигп 0; } }); 
о.х // => 0 

Дескриптор свойства, передаваемый методу ОУесТ.йеТіпеРгорегТуО, необязатель¬ 
но должен иметь все четыре атрибута. При создании нового свойства отсутствую¬ 
щие атрибуты получат значение Таізе или ипсіеТіпесІ. При изменении существую¬ 
щего свойства для отсутствующих атрибутов будут сохранены текущие значе¬ 
ния. Обратите внимание, что этот метод изменяет существующее собственное 
свойство или создает новое собственное свойство - он не изменяет унаследован¬ 
ные свойства. 
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Если возникнет необходимость создать или изменить сразу несколько свойств, 
можно воспользоваться методом ОУесІі.сіеГіпе РгорегІіез(). Первым аргументом 
ему передается объект, который требуется изменить. Вторым аргументом - объ¬ 
ект, отображающий имена создаваемых или модифицируемых свойств в деск¬ 
рипторы этих свойств. Например: 

ѵаг р = ОЬіесІ.сІеГіпеРгорегііези}, { 

х: { ѵаіие: 1, ѵѵгііаЫе: Ігие, егштегаЫе:1гие, сопІ'ідигаЫеіІгие }, 
у: { ѵаіие: 1, ѵѵгіІаЫе: Ігие, епитегаЫе:1гие, сопНдигаЫеіІігие }, 
г: { 

деі: ^псИопО { геіигп МаНі. здгЩЫз. х*ТІпіз.х + ІІііз.у*ТГііз.у) }, 

епитегаЫе іігие, 

сопНдигаЫеіІгие 

} 

}); 

В этом примере все начинается с пустого объекта, в который затем добавляются 
два свойства с данными и одно свойство с методами доступа, доступное только 
для чтения. Он опирается на тот факт, что 0Ь]ес1:.с1еГіпеРгорег1:іез() возвращает 
модифицированный объект (подобно методу О^есІі.йеГіпеРгорегІіуО). 

С методом 0Ь]ес1:.сгеа1:е(), определяемым стандартом ЕСМА8сгірІ 5, мы познако¬ 
мились в разделе 6.1, где узнали, что первым аргументом этому методу передает¬ 
ся объект, который будет служить прототипом для вновь созданного объекта. 
Этот метод также принимает второй необязательный аргумент, такой же, как 
и второй аргумент метода ОЬ^есІ: . сІе1 = іпеРгорег1:іез( ). Если методу ОЬ^есІ:. сгеа1:е() пе¬ 
редать множество дескрипторов свойств, они будут использованы для создания 
свойств нового объекта. 

Методы 0Уес1:.сІеГіпеРгорег1:у() и ОЬ^есІ:.сІе1 = іпеРгорег1:іез( ) возбуждают исключе¬ 
ние Ту ре Е г го г, когда создание или изменение свойств запрещено. Например, при 
попытке добавить новое свойство в нерасширяемый объект (раздел 6.8.3). Другие 
причины, по которым эти методы могут возбудить исключение ТуреЕггог, имеют 
непосредственное отношение к атрибутам. Атрибут мгіІіаЫе контролирует попыт¬ 
ки изменить атрибут ѵаіие. А атрибут сопГідигаЬІе контролирует попытки изме¬ 
нить другие атрибуты (а также определяет возможность удаления свойства). Од¬ 
нако все не так просто. Например, значение свойства, доступного только для чте¬ 
ния, можно изменить, если это свойство доступно для настройки. Кроме того, 
свойство, доступное только для чтения, можно сделать доступным для записи, 
даже если это свойство недоступно для настройки. Ниже приводится полный пе¬ 
речень правил. Вызовы О^есІі.сіеГіпеРгорегІіуО или 0Ь]ес1:.сіеГіпеРгорег1:іез(), нару¬ 
шающие их, возбуждают исключение ТуреЕггог: 

• Если объект нерасширяемый, можно изменить существующие собственные 
свойства этого объекта, но нельзя добавить в него новые свойства. 

• Если свойство недоступно для настройки, нельзя изменить его атрибуты соп- 
ГідигаЫе и епитегаЫе. 

• Если свойство с методами доступа недоступно для настройки, нельзя изме¬ 
нить его методы чтения и записи и нельзя превратить его в простое свойство 
с данными. 

• Если свойство с данными недоступно для настройки, нельзя превратить его 
в свойство с методами доступа. 
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• Если свойство с данными недоступно для настройки, нельзя изменить значе¬ 
ние его атрибута ѵѵгіІіаЫе с І^аізе на ѣгие, но его можно Изменить с Ігие на Шзе. 

• Если свойство с данными недоступно для настройки и для записи, нельзя из¬ 
менить его значение. Однако изменить значение свойства, недоступного для 
записи можно, если оно доступно для настройки (потому что свойство можно 
сделать доступным для записи, изменить его значение и затем опять сделать 
свойство доступным только для чтения). 

Пример 6.2 включает функцию ехѣепсК ), которая копирует свойства из одного объ¬ 
екта в другой. Эта функция просто копирует имена и значения свойств и игнори¬ 
рует их атрибуты. Кроме того, она не копирует методы чтения и записи из свойств 
с методами доступа, а просто преобразует их в свойства со статическими данны¬ 
ми. В примере 6.3 показана новая версия ехѣепсК ), которая копирует все атрибуты 
свойств с помощью 0Ь]ес1:.деі0ѵ\/пРгорег1:у0езсгір1:ог() и ОЬ^есІ:.сіе'ГіпеРгорегІіуС ). Но 
на этот раз данная версия оформлена не как функция, а как новый метод объекта 
и добавляется в ОЬ^есІ:. ргоііоііуре как свойство, недоступное для перечисления. 

Пример 6.3 . Копирование атрибутов свойств 
/* 

* Добавляет неперечислимый метод ехІепсіО в ОЬіесІ:.ргоііоіуре. 

* Этот метод расширяет объекты возможностью копирования свойств из объекта, 

* переданного в аргументе. Этот метод копирует не только значение свойств, 

* но и все их атрибуты. Из объекта в аргументе копируются все собственные 

* свойства (даже недоступные для перечисления), за исключением одноименных 

* свойств, имеющихся в текущем объекте. 

*/ 

ОЬ^есІ: . сіе^іпеР горе г1:у( ОЬ^ есѣ . ргоМуре, 

"ехіепсі", // Определяется ОЬіесІ:. ргоіоіуре. ехіепсі 

{ 

мгіЛаЫе: {гце, 

епцтегаЫе: І'аізе, // Сделать неперечислимым 
сопІ'ідигаЫе: {гие, 

ѵаіие: 1"ипс1:іоп(о) { // Значением свойства является данная функция 

// Получить все собственные свойства, даже неперечислимые 
ѵаг патез = ОЬіесІ:.де1:0\л/пРгорегі:уМатез(о); 

// Обойти их в цикле 

І'огСѵаг і = 0; і < патез. ІепдІП; і++) { 

// Пропустить свойства, уже имеющиеся в данном объекте 
(патез[і] іп ІІііз) сопііпие; 

// Получить дескриптор свойства из о 

ѵаг сіезс = ОЬіесІ;. де1:0\л/пРгорег1:у0е5сгір1:ог(о, патез[і]); 

// Создать с его помощью свойство в данном объекте 
ОЬ^есІ:.сІе^іпеРгорегі:у(і:Іпіз, патез[і], сіезс); 

} 

} 

}); 

6.7.1. Устаревшие приемы работы 
с методами чтения и записи 

Синтаксис определения свойств с методами доступа в литералах объектов, описан¬ 
ный разделе 6.6, позволяет определять свойства с методами в новых объектах, но 
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он не дает возможности получать методы чтения и записи и добавлять новые свой¬ 
ства с методами доступа к существующим объектам. В ЕСМАЗсгірі; 5 для этих це¬ 
лей можно использовать ОЬ^есІ:.де1:0\л/пРгорег1:у0езсгір1:ог( ) и 0Щес1і.с1еГіпеРгорег1іу().' 

Большинство реализаций ^ѵаЗсгірі (за исключением веб-броузера ІЕ) поддер¬ 
живали синтаксис деі и зеіі в литералах объектов еще до принятия стандарта 
ЕСМАЗсгірі 5. Эти реализации поддерживают нестандартный, устаревший АРІ 
для получения и назначения методов чтения и записи. Этот АРІ состоит из четы¬ 
рех методов, доступных во всех объектах._ ІоокирСеІіІіег _() и_ ІоокирЗеІіІіег _() 

возвращают методы чтения и записи для указанного свойства. А методы_ сІеГіпе- 

Сеііііег _() и_ сІеГіпеЗеІіІіег _() позволяют определить метод чтения или записи: 

в первом аргументе они принимают имя свойства, а во втором - метод чтения или 
записи. Имена всех этих методов начинаются и оканчиваются двумя символами 
подчеркивания, чтобы показать, что они являются нестандартными методами. 
Эти нестандартные методы не описываются в справочном разделе. 

6.8. Атрибуты объекта 

Все объекты имеют атрибуты ргоііоііуре, сіазз и ехѣепзіЫе. Все эти атрибуты опи¬ 
сываются в подразделах ниже; в них также рассказывается, как получать и из¬ 
менять значения атрибутов (если это возможно). 

6.8.1. Атрибут ргоіоіуре 

Атрибут ргоііоііуре объекта определяет объект, от которого наследуются свойства. 
(Дополнительные сведения о прототипах и наследовании прототипов приводятся 
в разделах 6.1.3 и 6.2.2.) Этот атрибут играет настолько важную роль, что обычно 
мы будем говорить о нем как о «прототипе объекта о», а не как об «атрибуте 
ргоііоііуре объекта о». Кроме того, важно понимать, что когда в программном коде 
встречается ссылка ргоііоііуре, она обозначает обычное свойство объекта, а не ат¬ 
рибут ргоііоііуре. 

Атрибут ргоііоііуре устанавливается в момент создания объекта. В разделе 6.1.3 
уже говорилось, что для объектов, созданных с помощью литералов, прототипом 
является ОЬзесІі. ргоііоііуре. Прототипом объекта, созданного с помощью оператора 
пеѵѵ, является значение свойства ргоііоііуре конструктора. А прототипом объекта, 
созданного с помощью ОЬ^есІі. сгеа1:е(), становится первый аргумент этой функции 
(который может иметь значение піііі). 

Стандартом ЕСМАЗсгірі; 5 предусматривается возможность определить прото¬ 
тип любого объекта, если передать его методу 0Ь]ес1.деІРго1іо1іуре0Г(). В ЕСМА¬ 
Зсгірі; 3 отсутствует эквивалентная функция, но зачастую определить прототип 
объекта о можно с помощью выражения о. сопзіігисііог. ргоііоііуре. Объекты, создан¬ 
ные с помощью оператора пем, обычно наследуют свойство сопзіігисііог, ссылающее¬ 
ся на функцию-конструктор, использованную для создания объекта. И как уже 
говорилось выше, функции-конструкторы имеют свойство ргоііоііуре, которое оп¬ 
ределяет прототип объектов, созданных с помощью этого конструктора. Подроб¬ 
нее об этом рассказывается в разделе 9.2, где также объясняется, почему этот ме¬ 
тод определения прототипа объекта не является достаточно надежным. Обратите 
внимание, что объекты, созданные с помощью литералов объектов или ОЩесІі.сге- 
а1іе( ), получают свойство сопзіігисііог, ссылающееся на конструктор 0Уес1і( ). Таким 
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образом, сопзіігисііог.ргоііоііуре ссылается на истинный прототип для литералов 
объектов, но обычно это не так для объектов, созданных вызовом 0Щес1:.сгеа1:е(). 

Чтобы определить, является ли один объект прототипом (или звеном в цепочке 
прототипов) другого объекта, следует использовать метод ізРго1іо1іуреОР(). Чтобы 
узнать, является ли р прототипом о, нужно записать выражение р. ізРгоІіоІіуреОР(о). 
Например: 


ѵаг р = {х:1}; 

и 

ѵаг о = ОЬіесР. сгеаРе(р); 

и 

р. ізРгоРоРуреОР(о) 

и 

ОЬіесР. ргоРоРуре. ізРгоРоРуреОР(р) // 


Определить объект-прототип. 

Создать объект с этим прототипом. 

=> Ргие: о наследует р 

=> Ргье: р наследует 0Ь;іесР. ргоРоРуре 


Обратите внимание, что ізРго1іо1іуреОР( ) по своему действию напоминает оператор 
іпзРапсеоР (раздел 4.9.4). 

В реализации ^ѵаЗсгірі компании Могіііа (первоначально созданной в Кеізсаре) 
значение атрибута ргоііоііуре доступно через специальное свойство_ ргоііо _, кото¬ 

рое можно использовать напрямую для определения и установки прототипа любо¬ 
го объекта. Использование свойства_ ргоііо _ухудшает переносимость: оно отсут¬ 

ствует (и, вероятно, никогда не появится) в реализациях броузеров ІЕ или Орега, 
хотя в настоящее время оно поддерживается броузерами Заіагі и СЬготе. Версии 
Еігеіох, реализующие стандарт ЕСМАЗсгірі 5, все еще поддерживают свойство 
_ ргоііо _, но не позволяют изменять прототип нерасширяемых объектов. 


6.8.2. Атрибут СІЭ55 

Атрибут сіазз объекта - это строка, содержащая информацию о типе объекта. Ни 
в ЕСМАЗсгірі 3, ни в ЕСМАЗсгірі 5 не предусматривается возможность измене¬ 
ния этого атрибута и предоставляются лишь косвенные способы определения его 
значения. По умолчанию метод РоЗіігіпдО (наследуемый от 0ЦесР. ргоііоііуре) воз¬ 
вращает строку вида: 

[оЬіесР сіазз] 

Поэтому, чтобы определить класс объекта, можно попробовать вызвать метод 
РоЗіігіпд( ) этого объекта и извлечь из результата подстроку с восьмого по предпо¬ 
следний символ. Вся хитрость состоит в том, что многие методы наследуют дру¬ 
гие, более полезные реализации метода іоЗігіпдО, и чтобы вызвать нужную вер¬ 
сию іоЗігіпдО, необходимо выполнить косвенный вызов с помощью метода Рипс- 
Ріоп.са11() (раздел 8.7.3). В примере 6.4 определяется функция, возвращающая 
класс любого объекта, переданного ей. 

Пример 6.4. Функция сІаззо{( ) 

РипсРіоп сІаззоР(о) { 

іР (о === пиіі) геРигп "МиП"; 

іР (о === ипсІеРіпесІ) геРигп "ІІпсІеРіпесІ" ; 

геРигп ОЬіесР. ргоРоРуре. РоЗРгіпд.саіі(о). з1ісе(8, -1); 

} 

Этой функции с1аззоР() можно передать любое значение, допустимое в языке ^- 
ѵаЗсгірі. Числа, строки и логические значения действуют подобно объектам, ко¬ 
гда относительно них вызывается метод Ро31ігіпд( ), а значения пиіі и ипсіеРіпесі об¬ 
рабатываются особо. (В ЕСМАЗсгірі 5 особая обработка не требуется.) Объекты, 



160 


Глава 6. Объекты 


созданные с помощью встроенных конструкторов, таких как Аггау и Оаііе, имеют 
атрибут сіазз, значение которого совпадает с именами их конструкторов. Объек¬ 
ты среды выполнения обычно также получают осмысленное значение атрибута 
сіазз, однако это зависит от реализации. Объекты, созданные с помощью литера¬ 
лов или вызовом ОЬ^есІ:.сгеаііе, получают атрибут сіазз со значением «ОУесІ». Ес¬ 
ли вы определите свой конструктор, все объекты, созданные с его помощью, по¬ 
лучат атрибут сіазз со значением «ОЬіесі»: нет никакого способа установить иное 
значение в атрибуте сіазз для собственных классов объектов: 


сІаззо^С пиіі ) 
сІаззоГ(І) 
сІаззо^С") 
сіаззоічі'аізе) 
с1аззоГ({}) 
с1аззоГ([]) 

с1аззоГ(/./) 

сІаззоІЧпем ЭаІеО) 
сІаззоГСміпсІоѵО 
Гипсііоп 1=() {}; 
сІаззоІЧпем ?()); 


// => "МиП" 

// => "МитЬег" 

// => "Зігіпд" 

// => "Вооіеап" 

// => "ОЬіесІ:" 

// => "Аггау" 

// => "Педехр" 

// => "Оаіе" 

// => "Ѵ\/іпс1о\л/" (объект клиентской среды выполнения) 
// Определение собственного конструктора 
// => "ОЬіесІ:" 


6.8.3. Атрибут ех{еп$іЫе 

Атрибут ехІепзіЬІе объекта определяет, допускается ли добавлять в объект новые 
свойства. В ЕСМАЗсгірі 3 все встроенные и определяемые пользователем объек¬ 
ты неявно допускали возможность расширения, а расширяемость объектов сре¬ 
ды выполнения определялась каждой конкретной реализацией. В ЕСМАЗсгірІ 5 
все встроенные и определяемые пользователем объекты являются расширяемы¬ 
ми, если они не были преобразованы в нерасширяемые объекты, а расширяе¬ 
мость объектов среды выполнения по-прежнему определяется каждой конкрет¬ 
ной реализацией. 

Стандарт ЕСМАЗсгірі 5 определяет функции для получения и изменения при¬ 
знака расширяемости объекта. Чтобы определить, допускается ли расширять 
объект, его следует передать методу 0Ьзес1:.ізЕх1:епзіЫе(). Чтобы сделать объект 
нерасширяемым, его нужно передать методу ОУесІі.ргеѵепІіЕхІепзіопзО. Обратите 
внимание, что после того как объект будет сделан нерасширяемым, его нельзя 
снова сделать расширяемым. Отметьте также, что вызов ргеѵеп1:Ех1:епзіопз() ока¬ 
зывает влияние только на расширяемость самого объекта. Если новые свойства 
добавить в прототип нерасширяемого объекта, нерасширяемый объект унаследу¬ 
ет эти новые свойства. 

Назначение атрибута ехІепзіЬІе заключается в том, чтобы дать возможность «фик¬ 
сировать» объекты в определенном состоянии, запретив внесение изменений. Ат¬ 
рибут объектов ехІепзіЬІе часто используется совместно с атрибутами свойств соп- 
ГідигаЬІе и ѵѵгіІіаЫе, поэтому в ЕСМАЗсгірі; 5 определяются функции, упрощаю¬ 
щие одновременную установку этих атрибутов. 

Метод ОЬ^есІ:. зеа1() действует подобно методу 0Ь]ес1.ргеѵеп1:Ех1епзіопз(), но он не 
только делает объект нерасширяемым, но и делает все свойства этого объекта не¬ 
доступными для настройки. То есть в объект нельзя будет добавить новые свойст¬ 
ва, а существующие свойства нельзя будет удалить или настроить. Однако суще¬ 
ствующие свойства, доступные для записи, по-прежнему могут быть изменены. 
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После вызова ОЬіесІ.зеаІО объект нельзя будет вернуть в прежнее состояние. 
Чтобы определить, вызывался ли метод ОЬ^есІ:. веа1() для объекта, можно вызвать 
метод 0Ь]ес1;.ізЗеа1ес1(). 

Метод ОЩесІ.'РгееіеС ) обеспечивает еще более жесткую фиксацию объектов. Поми¬ 
мо того, что он делает объект нерасширяемым, а его свойства недоступными для 
настройки, он также делает все собственные свойства с данными доступными 
только для чтения. (Это не относится к свойствам объекта с методами доступа, об¬ 
ладающими методами записи; эти методы по-прежнему будут вызываться инст¬ 
рукциями присваивания.) Чтобы определить, вызывался ли метод ОЬ^есІі.ІтеегеО 
объекта, можно вызвать метод 0Ь]ес1:.ізРго2еп(). 

Важно понимать, что 0Ь]ес1:.зеа1() и ОЬ^есІі.ІтееіеО воздействуют только на объ¬ 
ект, который им передается: они не затрагивают прототип этого объекта. Если 
в программе потребуется полностью зафиксировать объект, вам, вероятно, потре¬ 
буется зафиксировать также объекты в цепочке прототипов. 

Все методы, 0Ь]ес1:.ргеѵепі:Ех1:епзіопз(), 0Ь]ес1;.зеа1() и ОЩесІ.'РгееіеО, возвращают 
переданный им объект, а это означает, что их можно использовать во вложенных 
вызовах: 

// Создать нерасширяемый объект с ненастраиваемыми свойствами, с жестко 
// зафиксированным прототипом и свойством, недоступным для перечисления 
ѵаг о = 0 Ьіес 1 ;.зеа 1 ( 0 Ьіес 1 :.сгеа 1 :е( 0 Ьіес 1 :. 1 : гее 2 е({х: 1 }), 

{у: {ѵаіію: 2, мгИаЫе: 1:гие}})); 

6.9. Сериализация объектов 

Сериализация объектов - это процесс преобразования объектов в строковую фор¬ 
му представления, которая позднее может использоваться для их восстановле¬ 
ния. Для сериализации и восстановления объектов ЛѵаЗсгірі стандартом ЕСМА- 
8сгірі 5 предоставляются встроенные функции ^(ЖзІхіпді^уО и ^(ЖрагзеО. Эти 
функции используют формат обмена данными ^(Ж. Название ^(Ж происходит 
от « Лѵабсгірі ОЬіесі Коіаііоп» (форма записи объектов Лаѵабсгірі), а синтаксис 
этой формы записи напоминает синтаксис литералов объектов и массивов в язы¬ 
ке Лѵабсгірі: 

о = {х:1, у: {і: [ Гаізе.пиіі .""]}}| // Определить испытательный объект 
з = зі;гіпді^уСо) ; // з == ' {"х": 1, "у": {"2 ": [Шзе, пьН,}' 

р = рагзе(з); // Р - глубокая копия объекта о 

Базовые реализации этих функций в ЕСМА8сгірі 5 очень точно повторяют обще¬ 
доступные реализации в ЕСМА8сгірі 3, доступные в М1р://]80п.ог8/]80п2.]8. С прак¬ 
тической точки зрения это совершенно одинаковые реализации, и эти функции 
стандарта ЕСМА8сгірі 5 можно использовать в ЕСМА8сгірі 3, подключив ука¬ 
занный ВЫШе МОДУЛЬ ]80П2.]8 . 

Синтаксис формата ^(Ж является лишь подмножеством синтаксиса языка Звг 
ѵабсгірі и не может использоваться для представления всех возможных значе¬ 
ний, допустимых в Лаѵа8сгірі. Поддерживаются и могут быть сериализованы 
и восстановлены: объекты, массивы, строки, конечные числовые значения, Іігие, 
^аізе и пиіі. Значения №N1, Іп^іпіііу и -Іп^іпіііу сериализуются в значение пиіі. Объ¬ 
екты ОаНе сериализуются в строки с датами в формате 180 (смотрите описание 
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функции Оаііе. Тс^ЗОМ()), но ^(ЖрагзеО оставляет их в строковом представлении 
и не восстанавливает первоначальные объекты Оаие. Объекты РипсИоп, РедЕхр 
и Еггог и значение ипсіеГіпесі не могут быть сериализованы или восстановлены? 
Функция ^ОМ.зі:гіпді^у() сериализует только перечислимые собственные свойст¬ 
ва объекта. Если значение свойства не может быть сериализовано, это свойство 
просто исключается из строкового представления. Обе функции, ^(Жз1:гіпді1 : у() 
и ^ОПратзеО, принимают необязательный второй аргумент, который можно ис¬ 
пользовать для настройки процесса сериализации и/или восстановления, напри¬ 
мер, посредством определения списка свойств, подлежащих сериализации, или 
функции преобразования значений во время сериализации. В справочном разде¬ 
ле приводится полное описание этих функций. 

6.10. Методы класса ОЬдесг 

Как описывалось выше, все объекты в языке ЛѵаЗсгірі (за исключением тех, что 
явно созданы без прототипа) наследуют свойства от ОЬ^есИ. ргоНоНуре. Эти насле¬ 
дуемые свойства являются первичными методами и представляют особый инте¬ 
рес для программистов на ЛѵаЗсгірі, потому что доступны повсеместно. Мы уже 
познакомились с методами НазОмпРгорегІіуО, ргорег1:уІзЕпитегаЫе() и ізРгоІоІіу- 
реОГ(). (И мы уже охватили достаточно много статических функций, определяе¬ 
мых конструктором ОЬіесІ, таких как 0Ь]ес1:.сгеаі:е() и ОЬ^есИ. деІіРгоііоііуреО^С ).) 
В этом разделе описывается несколько универсальных методов объектов, кото¬ 
рые определены в 0Ь]ес1:.рго1:о1:уре и предназначены для переопределения в дру¬ 
гих, более специализированных классах. 

6.10.1. Метод Іо§Ігіпд() 

Метод ІоЗігіпдО не требует аргументов; он возвращает строку, каким-либо обра¬ 
зом представляющую значение объекта, для которого он вызывается. Интерпре¬ 
татор Лаѵабсгірі вызывает этот метод объекта во всех тех случаях, когда ему тре¬ 
буется преобразовать объект в строку. Например, это происходит, когда исполь¬ 
зуется оператор + для конкатенации строки с объектом, или при передаче объекта 
методу, требующему строку. 

Метод іоЗі:гіпд() по умолчанию не очень информативен (однако его удобно ис¬ 
пользовать для определения класса объекта, как было показано в разделе 6.8.2). 
Например, следующий фрагмент просто записывает в переменную з строку 

'[оЬ^есі: ОЬ^есИ] 

ѵаг з = { х:1, у:1 }. *о8*гіпд( ); 

Этот метод по умолчанию не отображает особенно полезной информации, поэтому 
многие классы определяют собственные версии метода ЮЗігіпдО. Например, ко¬ 
гда массив преобразуется в строку, мы получаем список элементов массива, каж¬ 
дый из которых преобразуется в строку, а когда в строку преобразуется функция, 
мы получаем исходный программный код этой функции. Эти специализирован¬ 
ные версии метода ИоЗИгіпд( ) описываются в справочном руководстве. Смотрите, 
например, описание методов Аггау.ИоЗі:гіпд( ), 0аІе.1:оЗі:гіпд() и РипсИіоп.і:оЗі:гіпд( ). 

В разделе 9.6.3 описывается, как можно переопределить метод *о31гіпд( ) для сво¬ 
их собственных классов. 
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6.10.2. Метод ІоІ.осаІе$ігіпд() 

В дополнение к методу ІоЗігіпдО все объекты имеют метод 1:оІ_оса1е5і:гіпд(). На¬ 
значение последнего состоит в получении локализованного строкового представ¬ 
ления объекта. По умолчанию метод ІоІ_оса1е5і:гіпд(), определяемый классом 
ОЩесІ, никакой локализации не выполняет; он просто вызывает метод ІоЗігіпдО 
и возвращает полученное от него значение. Классы даіе и МішЬег определяют соб¬ 
ственные версии метода 1:оІ-Оса1е5і:гіпд(), возвращающие строковые представле¬ 
ния чисел и дат в соответствии с региональными настройками. Класс Аггау опре¬ 
деляет версию метода ІоІ_оса1е5і:гіпд(), действующую подобно методу ІоЗігіпдО за 
исключением того, что он форматирует элементы массива вызовом их метода 
1:оІ_оса1е5і:гіпд(), а не ІоЗігіпдО. 

6.10.3. Метод ІоДОІѴІО 

В действительности ОЬзесІ.ргоііоІіуре не определяет метод Іс^ЗОМО, но метод ^(Ж 
зИгіпді^уС ) (раздел 6.9) пытается отыскать и использовать метод й^50М() любого 
объекта, который требуется сериализовать. Если объект обладает этим методом, 
он вызывается и сериализации подвергается возвращаемое значение, а не исход¬ 
ный объект. Примером может служить метод 0аіе.1:о^0М(). 

6.10.4. Метод ѵаІиеО{() 

Метод ѵаІиеОІЧ ) во многом похож на метод ІоЗі:гіпд( ), но вызывается, когда интер¬ 
претатору Лѵабсгірі требуется преобразовать объект в значение какого-либо 
простого типа, отличного от строки, - обычно в число. Интерпретатор Лѵабсгірі 
вызывает этот метод автоматически, если объект используется в контексте значе¬ 
ния простого типа. Метод ѵа1ие(Ж ) по умолчанию не выполняет ничего, что пред¬ 
ставляло бы интерес, но некоторые встроенные классы объектов переопределяют 
метод ѵа1ие(Ж) (например, Оаііе.ѵаІиеОІЧ)). В разделе 9.6.3 описывается, как мож¬ 
но переопределить метод ѵаІиеО^О в собственных типах объектов. 
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Массив - это упорядоченная коллекция значений. Значения в массиве называ¬ 
ются элементами , и каждый элемент характеризуется числовой позицией в мас¬ 
сиве, которая называется индексом . Массивы в языке ^ѵабсгірі являются нети¬ 
пизированными: элементы массива могут иметь любой тип, причем разные эле¬ 
менты одного и того же массива могут иметь разные типы. Элементы массива мо¬ 
гут даже быть объектами или другими массивами, что позволяет создавать 
сложные структуры данных, такие как массивы объектов и массивы массивов. 
Отсчет индексов массивов в языке Лѵабсгірі начинается с нуля и для них исполь¬ 
зуются 32-битные целые числа: первый элемент массива имеет индекс 0, а наи¬ 
больший возможный индекс имеет значение 4294967294 (2 32 -2), т.е. максималь¬ 
но возможный размер массива составляет 4294967295 элементов. Массивы в Л- 
ѵабсгірі являются динамическими : они могут увеличиваться и уменьшаться 
в размерах по мере необходимости; нет необходимости объявлять фиксирован¬ 
ные размеры массивов при их создании или повторно распределять память при 
изменении их размеров. Массивы в Лѵабсгірі могут быть разреженными : не тре¬ 
буется, чтобы массив содержал элементы с непрерывной последовательностью 
индексов - в массивах могут отсутствовать элементы с некоторыми индексами. 
Все массивы в ^ѵабсгірі имеют свойство ІепдііИ. Для неразреженных массивов 
это свойство определяет количество элементов в массиве. Для разреженных мас¬ 
сивов значение ІепдііИ больше числа всех элементов в массиве. 

Массивы в языке ^ѵабсгірі - это специализированная форма объектов, а индек¬ 
сы массивов означают чуть больше, чем просто имена свойств, которые по совпа¬ 
дению являются целыми числами. Мы еще не раз будем говорить о специфиче¬ 
ских особенностях массивов повсюду в этой главе. Реализации обычно оптимизи¬ 
руют операции с массивами, благодаря чему доступ к элементам массивов по их 
числовым индексам выполняется значительно быстрее, чем доступ к обычным 
свойствам объектов. 

Массивы наследуют свои свойства от прототипа Аггау. ргоііоііуре, который опреде¬ 
ляет богатый набор методов манипулирования массивами, о которых рассказы¬ 
вается в разделах 7.8 и 7.9. Большинство из этих методов являются универсалъ- 



7.1. Создание массивов 


165 


ными , т. е. они могут применяться не только к истинным массивам, но и к любым 
объектам, «похожим на массивы». Объекты, похожие на массивы, будут рассмат¬ 
риваться в разделе 7.11. В ЕСМАЗсгірі 5 строки ведут себя как массивы симво¬ 
лов, и мы обсудим такое их поведение в разделе 7.12. 

7.1. Создание массивов 

Легче всего создать массив с помощью литерала, который представляет собой про¬ 
стой список разделенных запятыми элементов массива в квадратных скобках. 
Например: 

ѵаг етрііу = []; // Пустой массив 

ѵаг ргітез = [2, 3, 5, 7, 11]; // Массив с пятью числовыми элементами 

ѵаг тізс = [ 1.1, Хгие, "а", ]; // 3 элемента разных типов + завершающая запятая 

Значения в литерале массива не обязательно должны быть константами - это мо¬ 
гут быть любые выражения: 

ѵаг Ьазе = 1024; 

ѵаг 1:аЫе = [Ьазе, Ьазе+1, Ьазе+2, Ьазе+3]; 

Литералы массивов могут содержать литералы объектов или литералы других 
массивов: 

ѵаг Ь = [[1,{х:1. у:2}], [2, {х:3, у:4}]]; 

Если литерал массива содержит несколько идущих подряд запятых без значений 
между ними, создается разреженный массив (подробнее об этом рассказывается 
в разделе 7.3). Элементы, соответствующие таким пропущенным значениям, от¬ 
сутствуют в массиве, но при обращении к ним возвращается значение ипсіе^іпесі: 

ѵаг соипі: = [ 1., 3]; // Элементы с индексами 0 и 2. соипі: [ 1 ] => ішсіеі'іпесі 
ѵаг ішсіе^з = [,,]; // Массив без элементов, но с длиной, равной 2 

Синтаксис литералов массивов позволяет вставлять необязательную завершаю¬ 
щую запятую, т.е. литерал [,,] соответствует массиву с двумя элементами, а не 
с тремя. 

Другой способ создания массива состоит в вызове конструктора Аггау(). Вызвать 
конструктор можно тремя разными способами: 

• Вызвать конструктор без аргументов: 

ѵаг а = пем АггауО; 

В этом случае будет создан пустой массив, эквивалентный литералу []. 

• Вызвать конструктор с единственным числовым аргументом, определяющим 
длину массива: 

ѵаг а = пеѵу/ Аггау(ІО); 

В этом случае будет создан пустой массив указанной длины. Такая форма вы¬ 
зова конструктора АггауО может использоваться для предварительного рас¬ 
пределения памяти под массив, если заранее известно количество его элемен¬ 
тов. Обратите внимание, что при этом в массиве не сохраняется никаких зна- 
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чений и даже свойства-индексы массива с именами «О», «1» и т. д. в массиве не 
определены. 

• Явно указать в вызове конструктора значения первых двух или более элемен : 
тов массива или один нечисловой элемент: 

ѵаг а = пеѵу/ Аггау(5, 4, 3, 2, 1, "іеаііпд, Ііезіііпд"); 

В этом случае аргументы конструктора становятся значениями элементов но¬ 
вого массива. Использование литералов массивов практически всегда проще, 
чем подобное применение конструктора Аггау(). 


7.2. Чтение и запись элементов массива 


Доступ к элементам массива осуществляется с помощью оператора [ ]. Слева от ско¬ 
бок должна присутствовать ссылка на массив. Внутри скобок должно находиться 
произвольное выражение, возвращающее неотрицательное целое значение. Этот 
синтаксис пригоден как для чтения, так и для записи значения элемента масси¬ 
ва. Следовательно, допустимы все приведенные далее ^ѵабсгірі-инструкции: 


ѵаг а = [ "ѵу/огісГ]; 

// 

ѵаг ѵаіце = а[0]; 

// 

а[1] = 3.14; 
і = 2; 

// 

а[і] = 3; 

и 

а[і + 1] = "ПеПсТ; 

и 

а[а[і]] = а[0]; 

и 


Создать массив с одним элементом 
Прочитать элемент О 
Записать значение в элемент 1 

Записать значение в элемент 2 
Записать значение в элемент 3 

Прочитать элементы 0 и 2, записать значение в элемент 3 


Напомню, что массивы являются специализированной разновидностью объек¬ 
тов. Квадратные скобки, используемые для доступа к элементам массива, дейст¬ 
вуют точно так же, как квадратные скобки, используемые для доступа к свойст¬ 
вам объекта. Интерпретатор ^ѵабсгірі преобразует указанные в скобках число¬ 
вые индексы в строки - индекс 1 превращается в строку ’Т\ - а затем использует 
строки как имена свойств. В преобразовании числовых индексов в строки нет ни¬ 
чего особенного: то же самое можно проделывать с обычными объектами: 

о = {}; // Создать простой объект 

о[1] = "опе"; // Индексировать его целыми числами 

Особенность массивов состоит в том, что при использовании имен свойств, кото¬ 
рые являются неотрицательными целыми числами, не превышающими 2 32 -2, 
массивы автоматически определяют значение свойства ІепдІИ. Например, выше 
был создан массив а с единственным элементом. Затем были присвоены значения 
его элементам с индексами 1, 2 и 3. В результате этих операций значение свойства 
ІепдІИ массива изменилось: 

а.ІепдіН // => 4 


Следует четко отличать индексы в массиве от имен свойств объектов . Все индек¬ 
сы являются именами свойств, но только свойства с именами, представленными 
целыми числами в диапазоне от 0 до 2 32 -2 являются индексами. Все массивы яв¬ 
ляются объектами, и вы можете добавлять к ним свойства с любыми именами. 
Однако если вы затрагиваете свойства, которые являются индексами массива, 
массивы реагируют на это, обновляя значение свойства ІепдІИ при необходимости. 
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Обратите внимание, что в качестве индексов массивов допускается использовать 
отрицательные и не целые числа. В этом случае числа преобразуются в строки, 
которые используются как имена свойств. Когда имя свойства не является неот¬ 
рицательным целым числом, оно интерпретируется как имя обычного свойства 
объекта, а не как индекс массива. Кроме того, при индексировании массива стро¬ 
ками, которые являются представлениями неотрицательных целых чисел, они 
интерпретируются как индексы массива, а не как свойства объекта. То же отно¬ 
сится и к вещественным числам, не имеющим дробной части: 

а[-1.23] = 1;гие; // Будет создано свойство с именем "-1.23" 

а[ ”1000"] = 0; // 1001-й элемент массива 

а[1.000] // Элемент с индексом 1. То же. что и а[1] 

То обстоятельство, что индексы массива являются всего лишь особой разновид¬ 
ностью имен свойств объекта, означает, что для массивов Лаѵабсгірі отсутствует 
понятие ошибки «выхода за границы». Попытка получить значение любого несу¬ 
ществующего свойства любого объекта не рассматривается как ошибка, в этом 
случае просто возвращается значение ипсіе^іпесі. То же относится и к массивам: 

а = [ 1;гие, ?аІ8е]; // Этот массив имеет элементы с индексами 0 и 1 

а[2] // => ипсіе^іпес) . Нет элемента с таким индексом. 

а[-1] // => ипсІеНпесІ. Нет свойства с таким именем. 

Поскольку массивы фактически являются объектами, они могут наследовать 
элементы от своих прототипов. В ЕСМАбсгірі 5 массивы могут даже иметь эле¬ 
менты, определяющие методы чтения и записи (раздел 6.6). Если массив наследу¬ 
ет элементы или элементы в нем имеют методы доступа, доступ к такому массиву 
не оптимизируется интерпретатором: время доступа к элементам такого массива 
будет сопоставимо с временем поиска обычных свойств объекта. 

7.3. Разреженные массивы 

Разреженным называется массив, индексы элементов которого не образуют не¬ 
прерывную последовательность чисел, начиная с 0. Обычно свойство Іепдіііі мас¬ 
сива определяет количество элементов в массиве. В разреженном массиве значе¬ 
ние свойства ІепдІН больше количества элементов. Разреженный массив можно 
создать с помощью конструктора АггауО или путем присваивания значения эле¬ 
менту с индексом, большим, чем текущая длина массива. 

а = пеѵу/ Аггау(5); // Нет элементов, но а.іепдіііі имеет значение 5. 
а = []; // Создаст пустой массив со значением 1епді:Н = 0. 

а[1000] = 0; // Добавит один элемент, но установит длину равной 1001. 

Далее будет показано, что разреженный массив можно также создать с помощью 
оператора сіеіеііе. 

Существенно разреженные массивы обычно более медленны и потребляют боль¬ 
ше памяти, чем плотные массивы, а поиск элементов в таких массивах занимает 
примерно столько же времени, что и поиск обычных свойств объектов. 

Обратите внимание, что литералы с пропущенными значениями (когда в опреде¬ 
лении подряд следуют запятые, например [1, ,3]) создают разреженные массивы, 
в которых пропущенные элементы просто не существуют: 
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ѵаг аі = [,]; // Массив без элементов с длиной, равной 1 

ѵаг а2 = [ітсІеГіпесІ]; // Массив с одним неопределенным элементом 

О іп аі // => Гаізе: аі не имеет элемента с индексом О 

О іп а2 // => {гію: а2 имеет элемент с индексом 0 и со значением ьпсІеГіпесІ 

Некоторые старые реализации (такие как ГігеГох 3) некорректно вставляли эле¬ 
менты со значением ипсіеГіпесі на место пропущенных элементов. В этих реализа¬ 
циях литерал [1,,3] был эквивалентен литералу [1, ипсіеГіпесі, 3]. 

7.4. Длина массива 

Любой массив имеет свойство ІепдГР, и это свойство отличает массивы от обыч¬ 
ных объектов ЛѵаВсгірі. Для плотных (т. е. неразреженных) массивов свойство 
ІепдГН определяет количество элементов в массиве. Его значение на единицу боль¬ 
ше самого большого индекса в массиве: 

[ ]. Іепдіііт // => 0: массив не имеет элементов 

[’а’,’Ь’,'с']. Іепдііі // => 3: наибольший индекс равен 2, длина равна 3 

Для разреженных массивов значение свойства ІепдГН больше числа элементов, 
и все, что можно сказать в этом случае, - это то, что значение свойства Іепдгь га¬ 
рантированно будет превышать индекс любого элемента в массиве. Или, говоря 
иначе, массивы (разреженные или нет) никогда не будут содержать элемент, ин¬ 
декс которого будет больше или равен значению свойства ІепдгН массива. Для 
поддержки этого свойства массивы проявляют две особенности поведения. Пер¬ 
вая была описана выше: если присвоить значение элементу массива, индекс і ко¬ 
торого больше или равен текущему значению свойства ІепдГИ, в свойство ІепдГИ 
записывается значение і+1. 

Вторая особенность в поведении, обеспечивающем работу свойства ІепдГІп, заклю¬ 
чается в том, что при присваивании свойству ІепдГИ неотрицательного целого чис¬ 
ла п, меньшего, чем его текущее значение, все элементы массива с индексами, 
большими или равными значению п, удаляются из массива: 

а =[1,2,3,4,5]; // Создать массив с пятью элементами. 

а.Іепдіііп = 3; // теперь массив а содержит элементы [1,2,3]. 

а. ІепдііГі = 0; // Удалит все элементы, а - пустой массив []. 

а.іепдііі = 5; // Длина равна 5, но элементы отсутствуют, подобно Аггау(5) 

В свойство ІепдГІп массива можно также записать значение больше, чем его теку¬ 
щее значение. В этом случае в массив не добавляются новые элементы, а просто 
создается разреженная область в конце массива. 

В ЕСМАЗсгірі 5 свойство ІепдГИ массива можно сделать доступным только для 
чтения, с помощью О^есГ.деГіпеРгорегГуО (раздел 6.7): 

а = [1,2,3]; // Создать массив а с тремя элементами. 

0Ь]ес1:.с1еГіпеРгорегі;у(а, "Іепд’Ыі", // Сделать свойство ІепдіП 

{ѵу/гііаЫе: Гаізе}); // доступным только для чтения. 
а.ІепдіП =0; //а не изменится. 

Аналогично, если сделать элемент массива ненастраиваемым, его нельзя будет 
удалить. Если элемент нельзя будет удалить, то и свойство ІепдГН не может быть 
установлено в значение, меньшее или равное индексу ненастраиваемого элемен- 
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та. (Смотрите раздел 6.7, а также описание методов 0Ь]ес*.зеа1() и О^есІ.ІтееіеО 
в разделе 6.8.3.) 

■ф 

7.5. Добавление и удаление элементов массива 

Мы уже видели, что самый простой способ добавить элементы в массив заключа¬ 
ется в том, чтобы присвоить значения новым индексам: 

а = [] // Создать пустой массив. 

а[0] = "гего"; // И добавить элементы. 

а[1] = "опе"; 

Для добавления одного или более элементов в конец массива можно также ис¬ 
пользовать метод ризИ(): 

а = []; // Создать пустой массив 

а. рцзІіС'гего" ) // Добавить значение в конец, а = ["гего"] 

а.рьзІіС'опе", "Тѵу/о" ) // Добавить еще два значения, а = ["гего", "опе", **1 ;ѵу/о" ] 

Добавить элемент в конец массива можно также, присвоив значение элементу 
а[а. ІепдііИ]. Для вставки элемента в начало массива можно использовать метод 
цпзНШО (описывается в разделе 7.8), при этом существующие элементы в масси¬ 
ве смещаются в позиции с более высокими индексами. 

Удалять элементы массива можно с помощью оператора сіеіеііе, как обычные 
свойства объектов: 

а = [1.2.3]; 

сіеіеііе а[ 1 ]; // теперь в массиве а отсутствует элемент с индексом 1 

1 іп а // => ^аізе: индекс 1 в массиве не определен 

а.іепдіііі // => 3: оператор сіеіеііе не изменяет свойство ІепдІП массива 

Удаление элемента напоминает (но несколько отличается) присваивание значе¬ 
ния цпсІе'ГіпесІ этому элементу. Обратите внимание, что применение оператора 
сіеіеііе к элементу массива не изменяет значение свойства ІепдІіР и не сдвигает вниз 
элементы с более высокими индексами, чтобы заполнить пустоту, оставшуюся 
после удаления элемента. После удаления элемента массив превращается в раз¬ 
реженный массив. 

Кроме того, как уже было показано выше, имеется возможность удалять элемен¬ 
ты в конце массива простым присваиванием нового значения свойству ІепдііР. 
Массивы имеют метод рор() (противоположный методу рцзК)), который уменьша¬ 
ет длину массива на 1 и возвращает значение удаленного элемента. Также имеет¬ 
ся метод зИі^І() (противоположный методу ііпзіііГЕО), который удаляет элемент 
в начале массива. В отличие от оператора сіеіеііе, метод зііі^Ш сдвигает все эле¬ 
менты вниз на позицию ниже их текущих индексов. Методы рор() и зПіІЧО опи¬ 
сываются в разделе 7.8 и в справочном разделе. 

Наконец существует многоцелевой метод зр1ісе(), позволяющий вставлять, уда¬ 
лять и замещать элементы массивов. Он изменяет значение свойства ІепдііЬ и сдви¬ 
гает элементы массива с более низкими или высокими индексами по мере необхо¬ 
димости. Подробности приводятся в разделе 7.8. 
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7.6. Обход элементов массива 

Наиболее часто для обхода элементов массива используется цикл "Гог (раздел 5.5.3)! 

ѵаг кеуз = ОЬіесІ.кеуз(о); // Получить массив имен свойств объекта о 
ѵаг ѵаіьез = [] // Массив для сохранения значений свойств 

1Ч)г(ѵаг і = 0; і < кеуз.ІепдІП; і++) { // Для каждого элемента в массиве 
ѵаг кеу = кеуз[і]; // Получить имя свойства по индексу 

ѵа1цез[і] = о[кеу]; // Сохранить значение в массиве ѵаіьез 

} 

Во вложенных циклах и в других контекстах, когда скорость работы имеет кри¬ 
тическое значение, иногда можно увидеть такой оптимизированный способ вы¬ 
полнения итераций по массиву, когда длина массива определяется только один 
раз, а не в каждой итерации: 

1"ог(ѵаг і = 0, Іеп = кеуз. Іепдіііт ; і < Іеп; і++) { 

// тело цикла осталось без изменений 

> 

В примерах выше предполагается, что выполняется обход плотного массива и все 
элементы содержат допустимые значения. В противном случае необходимо орга¬ 
низовать проверку значений элементов массива перед их использованием. Если 
желательно исключить из обработки значения пиіі, ипсіе^іпесі и несуществующие 
элементы, проверку можно записать так: 

1Ч)г(ѵа г і = 0; і < а.іепдіііі; і++) { 

іі 1 (! а[і]) сопИпце; // Пропустить пьП, ипсіе^іпесі и несуществ. элементы 
// тело цикла 

> 

Если необходимо пропустить только значение цпсіе^іпесі и несуществующие эле¬ 
менты, проверку можно записать так: 

1т)г(ѵаг і = 0; і < а.іепдіііі; і++) { 

і Т (а[і] === цпсіеі'іпесі) сопИпце; // Пропустить цпсіеі'іпесі + несуществ. эл. 

// тело цикла 

} 

Наконец, если необходимо пропустить только несуществующие элементы, а эле¬ 
менты со значением ипсіе^іпесі обрабатывать как обычные элементы, проверку 
можно записать так: 

1т)г(ѵаг і = 0; і < а.іепдіііі; і++) { 

Н (!(і іп а)) сопііпце ; // Пропустить несуществующие элементы 
// тело цикла 

} 

Для обхода разреженных массивов можно также использовать цикл ^ог/іп (раз¬ 
дел 5.5.4). Этот цикл присваивает имена перечислимых свойств (включая индексы 
массива) переменной цикла. Отсутствующие индексы в итерациях не участвуют: 

^ог(ѵаг іпсіех іп зрагзеАггау) { 
ѵаг ѵаіье = зрагзеАггау[іпсіех]; 

// Далее следуют операции с индексами и значениями 


} 




7.7. Многомерные массивы 


171 


Как отмечалось в разделе 6.5, цикл ^ог/іп может возвращать имена унаследован¬ 
ных свойств, такие как имена методов, добавленных в Аггау.ргоііоііуре. По этой 
причине не следует использовать цикл "Гог/іп для обхода массивов, не предусмот¬ 
рев дополнительной проверки для фильтрации нежелательных свойств. Для это¬ 
го можно было бы использовать, например, такие проверки: 

Гог(ѵаг і іп а) { 

іГ (! а. ІіазОѵѵ/пРгоре г1:у( і )) соШлпііе; // Пропустить унаследованные свойства 
// тело цикла 

} 

Гог(ѵаг і іп а) { 

// Пропустить і, если оно не является целым неотрицательным числом 
іГ (8*гіпд(Ма*й. Г1оог(Ма1:П.аЬз(МіітЬег(і)))) !== і) сопИгше; 

} 

Спецификация ЕСМ А8сгірі допускает возможность обхода свойств объекта в цик¬ 
ле ^ог/іп в любом порядке. Обычно реализации обеспечивают обход индексов мас¬ 
сивов в порядке возрастания, но это не гарантируется. В частности, если массив 
имеет и свойства объекта, и элементы массива, имена свойств могут возвращать¬ 
ся в порядке их создания, а не в порядке возрастания числовых значений. Разные 
реализации по-разному обрабатывают эту ситуацию, поэтому, если для вашего 
алгоритма порядок выполнения итераций имеет значение, вместо цикла І'ог/іп 
лучше использовать обычный цикл 1"ог. 

Стандарт ЕСМАЗсгірі 5 определяет множество новых методов, позволяющих вы¬ 
полнять итерации по элементам массивов в порядке возрастания индексов и пе¬ 
редавать их функции, определяемой пользователем. Наиболее типичным пред¬ 
ставителем этих методов является метод ^огЕасЬО: 

ѵаг Раіа = [1,2.3,4.5]; // Этот массив требуется обойти 

ѵаг зіітОГЗдцагез =0; // Требуется вычислить сумму квадратов элементов 

Ра1:а. ГогЕасІі(Гііпс1:іоп(х) { // Передать каждый элемент этой функции 

зіітОГЗдцагез += х*х; // прибавить квадрат к сумме 

}); 

зіітОГЗдцагез // =>55 : 1+4+9+16+25 

ГогЕасО() и другие родственные методы, предназначенные для выполнения итера¬ 
ций, позволяют использовать при работе с массивами простой и мощный стиль 
функционального программирования. Они описываются в разделе 7.9, и еще раз 
мы вернемся к ним в разделе 8.8, когда будем рассматривать приемы функцио¬ 
нального программирования. 

7.7. Многомерные массивы 

ЛѵаЗсгірі не поддерживает «настоящие» многомерные массивы, но позволяет 
неплохо имитировать их при помощи массивов из массивов. Для доступа к эле¬ 
менту данных в массиве массивов достаточно дважды использовать оператор []. 
Например, предположим, что переменная шаіігіх - это массив массивов чисел. Ка¬ 
ждый элемент ша1:гіх[х] - это массив чисел. Для доступа к определенному числу 
в массиве можно использовать выражение та*гіх[х][у]. Ниже приводится кон¬ 
кретный пример, где двумерный массив используется в качестве таблицы умно¬ 
жения: 
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// Создать многомерный массив 

ѵаг ІаЫе = пей Аггау(Ю); // В таблице 10 строк 

1Ч)г(ѵаг і = 0; і < *аЫе.1епд*й; і++) 

1:аЫе[і] = пей Аггау(Ю); // В каждой строке 10 столбцов 

// Инициализировать массив 

1Ч)г(ѵаг го ѵі = 0; го ѵі < ІаЫе. 1епді:Гі ; гои++) { 

^ог(со1 = 0; соі < *аЫе[гом]. 1епд*й; со1++) { 

1:аЫе[ го\л/][со1] = го\л/*со1: 

} 

} 

// Расчет произведения 5*7 с помощью многомерного массива 
ѵаг ргойцс* = *аЫе[5][7]; // 35 


7.8. Методы класса Аггау 

Стандарт ЕСМА8сгірі 3 определяет в составе Аггау. ргоііоііуре множество удобных 
функций для работы с массивами, которые доступны как методы любого масси¬ 
ва. Эти методы будут представлены в следующих подразделах. Более полную ин¬ 
формацию можно найти в разделе Аггау в справочной части по базовому языку 
ЛѵаЗсгірі. Стандарт ЕСМАЗсгірі 5 определяет дополнительные методы для вы¬ 
полнения итераций по массивам - эти методы рассматриваются в разделе 7.9. 


7.8.1. Метод іоіп() 

Метод Аггау.]оіп() преобразует все элементы массива в строки, объединяет их 
и возвращает получившуюся строку. В необязательном аргументе методу можно 
передать строку, которая будет использоваться для отделения элементов в строке 
результата. Если строка-разделитель не указана, используется запятая. Напри¬ 
мер, следующий фрагмент дает в результате строку «1,2,3»: 


ѵаг а = [1, 2, 3]; 
а.іоіп(); 
а.іоіпС' "); 
а. іоіпГ"); 


// Создать новый массив с указанными тремя элементами 
// => "1.2,3" 

// =>"12 3 ” 

// => "123" 


ѵаг Ь = пе\л/ Аггау(Ю); // Массив с длиной, равной 10, и без элементов 
Ь.іоіп('-‘) // => '-строка из 9 дефисов 


Метод Аггау. ]оіп() является обратным по отношению к методу ЗІгіпд.зрШО, соз¬ 
дающему массив путем разбиения строки на фрагменты. 


7.8.2. Метод геѵег5е() 

Метод Аггау. геѵегзе() меняет порядок следования элементов в массиве на обрат¬ 
ный и возвращает переупорядоченный массив. Перестановка выполняется непо¬ 
средственно в исходном массиве, т. е. этот метод не создает новый массив с пере¬ 
упорядоченными элементами, а переупорядочивает их в уже существующем мас¬ 
сиве. Например, следующий фрагмент, где используются методы геѵегзе() 
и ]оіп(), дает в результате строку 3,2,Г: 

ѵаг а = [1,2,3]; 

а.геѵегзе( ). іоіп( ); // => "3,2,1”: теперь а = [3,2,1] 
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7.8.3. Метод $огі() 

Метод Аггау. зог!() сортирует элементы в исходном массиве и возвращает отсорти¬ 
рованный массив. Если метод зог1() вызывается без аргументов, сортировка вы¬ 
полняется в алфавитном порядке (для сравнения элементы временно преобразу¬ 
ются в строки, если это необходимо): 

ѵаг а = пе\ѵ АггауС'Ьапапа", "сИеггу". "арріе” ): 
а. зогі( ); 

ѵаг з = а.]оіп(", '); // з == "арріе, Ьапапа, сИеггу" 

Неопределенные элементы переносятся в конец массива. 

Для сортировки в каком-либо ином порядке, отличном от алфавитного, методу 
зог!() можно передать функцию сравнения в качестве аргумента. Эта функция ус¬ 
танавливает, какой из двух ее аргументов должен следовать раньше в отсортиро¬ 
ванном списке. Если первый аргумент должен предшествовать второму, функция 
сравнения должна возвращать отрицательное число. Если первый аргумент дол¬ 
жен следовать за вторым в отсортированном массиве, то функция должна возвра¬ 
щать число больше нуля. Л если два значения эквивалентны (т. е. порядок их сле¬ 
дования не важен), функция сравнения должна возвращать 0. Поэтому, например, 
для сортировки элементов массива в числовом порядке можно сделать следующее: 

ѵаг а = [33, 4, 1111, 222]; 

а.зог1(); // Алфавитный порядок: 1111, 222, 33, 4 

а.зо гі: ( Гипс1:іоп (а.Ь) { // Числовой порядок: 4, 33, 222, 1111 
геіигп а-Ь; // Возвращает значение < 0. О или > О 

}); //в зависимости от порядка сортировки а и Ь 

а. зогі: ( Гипс1:іоп( а, Ь) {геіигп Ь-а}); // Обратный числовой порядок 

Обратите внимание, насколько удобно использовать в этом фрагменте неимено¬ 
ванную функцию. Функция сравнения используется только здесь, поэтому нет 
необходимости давать ей имя. 

В качестве еще одного примера сортировки элементов массива можно реализо¬ 
вать сортировку массива строк без учета регистра символов, передав функцию 
сравнения, преобразующую свои аргументы в нижний регистр (с помощью мето¬ 
да 1оІ_оѵ\югСазе( )) перед сравнением. 

а = ['ап!', 'Вид', 'саі', 'йод'] 

а.зогіО; // сортировка с учетом регистра символов: [ ‘ Вид ’, * йод', ' апі: ’, саі: ' ] 
а. зо гі: ( Гипсіііоп (з, 1) { // Сортировка без учета регистра символов 
ѵаг а = з. 1оІ_о\л/егСазе( ); 
ѵаг Ь = 1:. 1:оІоѵѵ/егСазе( ): 
іі (а < Ь) геіигп -1; 
іі (а > Ь) геіигп 1; 
геіигп 0; 

}); //=>[' апі ','Вид',' саі '.'йод'] 

7.8.4. Метод сопса!() 

Метод Аггау. сопсаіО создает и возвращает новый массив, содержащий элементы 
исходного массива, для которого был вызван метод сопса!(), и значения всех ар¬ 
гументов, переданных методу сопса!(). Если какой-либо из этих аргументов сам 
является массивом, его элементы добавляются в возвращаемый массив. Следует, 
однако, отметить, что рекурсивного превращения массива из массивов в одно- 
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мерный массив не происходит. Метод сопсаіО не изменяет исходный массив. Ни¬ 
же приводится несколько примеров: 

ѵаг а = [1,2,3]; 

3.0000311(4, 5) // Вернет [1,2,3,4,5] 

а. сопсаі: ([4,5]); // Вернет [1,2,3,4,5] 

а.сопса1:([4,5], [6.7]) // Вернет [1.2,3.4, 5,6,7] 

а.сопса1:(4, [5, [6,7]]) // Вернет [1,2,3,4, 5, [6,7]] 

7.8.5. Метод 5Іісе() 

Метод Аггау.зІісеО возвращает фрагмент , или подмассив, указанного массива. 
Два аргумента метода определяют начало и конец возвращаемого фрагмента. 
Возвращаемый массив содержит элемент, номер которого указан в первом аргу¬ 
менте, плюс все последующие элементы, вплоть до (но не включая) элемента, но¬ 
мер которого указан во втором аргументе. Если указан только один аргумент, 
возвращаемый массив содержит все элементы от начальной позиции до конца 
массива. Если какой-либо из аргументов имеет отрицательное значение, он опре¬ 
деляет номер элемента относительно конца массива. Так, аргументу -1 соответст¬ 
вует последний элемент массива, а аргументу -3 - третий элемент массива с кон¬ 
ца. Вот несколько примеров: 

ѵаг а = [1,2,3,4,5]; 
а.5Іісе(0, 3); // Вернет [1,2,3] 

а.5Іісе(3); // Вернет [4,5] 

а.зіісе(і.-і); // Вернет [2,3,4] 
а.5Іісе(-3, -2); // Вернет [3] 

7.8.6. Метод 5рІісе() 

Метод Аггау.зрІісеО - это универсальный метод, выполняющий вставку или уда¬ 
ление элементов массива. В отличие от методов з1ісе() и сопса1;(), метод зр1ісе() 
изменяет исходный массив, относительно которого он был вызван. Обратите вни¬ 
мание, что методы зр1ісе() и з1ісе() имеют очень похожие имена, но выполняют 
совершенно разные операции. 

Метод зрІісеО может удалять элементы из массива, вставлять новые элементы 
или выполнять обе операции одновременно. Элементы массива при необходимо¬ 
сти смещаются, чтобы после вставки или удаления образовывалась непрерывная 
последовательность. Первый аргумент метода зрІісеО определяет позицию в мас¬ 
сиве, начиная с которой будет выполняться вставка и/или удаление. Второй аргу¬ 
мент определяет количество элементов, которые должны быть удалены (выреза¬ 
ны) из массива. Если второй аргумент опущен, удаляются все элементы массива 
от указанного до конца массива. Метод зр1ісе( ) возвращает массив удаленных эле¬ 
ментов или (если ни один из элементов не был удален) пустой массив. Например: 

ѵаг а = [1,2,3,4,5,6,7,8]; 

а.5р1ісе(4); // Вернет [5.6,7,8]; а = [1,2,3,4] 

а.5р1ісе(1, 2); // Вернет [2,3]; а = [1,4] 
а.зр1ісе(1, 1); // Вернет [4]; а = [1] 

Первые два аргумента метода зрІісеО определяют элементы массива, подлежа¬ 
щие удалению. За этими аргументами может следовать любое количество допол- 




7.8. Методы класса Аггау 


175 


нительных аргументов, определяющих элементы, которые будут вставлены в мас¬ 
сив, начиная с позиции, указанной в первомаргументе. Например: 

ѵаг а = [1,2,3,4,5]; 

а.зр1ісе(2,0.'а','Ь'); // Вернет []; а = [1,2,'а'. Ь'.3,4,5] 
а.вр1ісе(2.2.[1.2].3); // Вернет ['а'.Ь']; а = [1,2.[1.2],3.3,4,5] 

Обратите внимание, что, в отличие от сопсаШ, метод $р1ісе() вставляет массивы 
целиком, а не их элементы. 


7.8.7. Методы ри5Іі() и рор() 


Методы ризИ() и рор() позволяют работать с массивами как со стеками. Метод 
ризИ() добавляет один или несколько новых элементов в конец массива и возвра¬ 
щает его новую длину. Метод рор() выполняет обратную операцию - удаляет по¬ 
следний элемент массива, уменьшает длину массива и возвращает удаленное им 
значение. Обратите внимание, что оба эти метода изменяют исходный массив, 
а не создают его модифицированную копию. Комбинация ріі5Н()ирор() позволяет 
на основе массива реализовать стек с дисциплиной обслуживания «первым во¬ 
шел - последним вышел». Например: 


ѵаг зііаск = []; 
зііаск. ри8Іі( 1.2): 
зііаск. рор(); 
зііаск. ризИ(З); 
зіаск.рор(); 
зіаск. ріізй([4,5]); 
зііаск. рор() 
зііаск. рор(); 


// стек: [] 

// стек: [1,2] Вернет 2 

// стек: [1] Вернет 2 

// стек: [1,3] Вернет 2 

// стек: [1] Вернет 3 

// стек: [1,[4,5]] Вернет 2 

// стек: [1] Вернет [4,5] 

// стек: [] Вернет 1 


7.8.8. Методы ип5М{(() и $ЫЙ() 


Методы ипзМі'ПС ) и зИіІЧО ведут себя почти так же, как ріізИ() и рор(), за исключе¬ 
нием того, что они вставляют и удаляют элементы в начале массива, а не в конце. 
Метод ипзМі'Г1:( ) смещает существующие элементы в сторону больших индексов 
для освобождения места, добавляет элемент или элементы в начало массива и воз¬ 
вращает новую длину массива. Метод зііі^Ю удаляет и возвращает первый эле¬ 
мент массива, смещая все последующие элементы на одну позицию вниз, чтобы 
занять место, освободившееся в начале массива. Например: 


ѵаг а = []; 
а. ипзІіі1 : 1і( 1); 
а. и пзМ і 14(22); 
а. зПі^Іі (); 
а. ітзйШО, [4,5]); 
а. зИі’ГК ); 
а. 5ііі^( ); 
а. 8Ііі^( ); 


// а:[] 

// а:[1] Вернет: 1 

// а:[22,1] Вернет: 2 

// а:[1] Вернет: 22 

// а:[3,[4,5],1] Вернет: 3 

// а:[[4,5],1] Вернет: 3 

// а:[1] Вернет: [4,5] 

// а:[] Вернет: 1 


Обратите внимание на поведение метода ііпзііі^О при вызове с несколькими аргу¬ 
ментами. Аргументы вставляются не по одному, а все сразу (как в случае с мето¬ 
дом зрІісеО). Это значит, что в результирующем массиве они будут следовать 
в том же порядке, в котором были указаны в списке аргументов. Будучи встав¬ 
ленными по одному, они бы расположились в обратном порядке. 
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7.8.9. Методы *о5ігіпд() и ІоІ.осаІе51гіпд() 

Массивы, как и любые другие объекты в ЛѵаЗсгірі, имеют метод 1о5*гіпд(). Для 
массива этот метод преобразует каждый его элемент в строку (вызывая в случае 
необходимости методы *о8*гіпд( ) элементов массива) и выводит список этих строк 
через запятую. Примечательно, что результат не включает квадратные скобки 
или какие-либо другие разделители вокруг значений массива. Например: 

[1,2,3]. *о8*гіпд() //Получается '1,2,3' 

["а”, "Ь", "с "]. *о8*гіпд( ) // Получается а.Ь.с' 

[1, [2, с']]. *о8*гіпд( ) //Получается '1,2,с' 

Обратите внимание, что *о8*гіпд() возвращает ту же строку, что и метод ]оіп() 
при вызове его без аргументов. 

Метод *оІ.оса1е8*гіпд() - это локализованная версия *о8*гіпд(). Каждый элемент 
массива преобразуется в строку вызовом метода *оІ.оса1е8*гіпд() элемента, а за¬ 
тем полученные строки объединяются с использованием специфического для ре¬ 
гиона (и определяемого реализацией) разделителя. 

7.9. Методы класса Аггау, 
определяемые стандартом ЕСМАБсгірі 5 

Стандарт ЕСМАЗсгірі 5 определяет девять новых методов массивов, позволяю¬ 
щих выполнять итерации, отображение, фильтрацию, проверку, свертку и по¬ 
иск. Все эти методы описываются в следующих далее подразделах. 

Однако, прежде чем перейти к изучению особенностей, следует сделать некото¬ 
рые обобщения, касающиеся методов массивов в ЕСМАЗсгірі 5. Во-первых, боль¬ 
шинство описываемых ниже методов принимают функцию в первом аргументе 
и вызывают ее для каждого элемента (или нескольких элементов) массива. В слу¬ 
чае разреженных массивов указанная функция не будет вызываться для несуще¬ 
ствующих элементов. В большинстве случаев указанной функции передаются 
три аргумента: значение элемента массива, индекс элемента и сам массив. Чаще 
всего вам необходим будет только первый аргумент, а второй и третий аргументы 
можно просто игнорировать. Большинство методов массивов, введенных стан¬ 
дартом ЕСМА8сгірі 5, которые в первом аргументе принимают функцию, также 
принимают второй необязательный аргумент. Если он указан, функция будет 
вызываться, как если бы она была методом этого второго аргумента. То есть вто¬ 
рой аргумент будет доступен функции, как значение ключевого слова ІИіз. Значе¬ 
ние, возвращаемое функцией, играет важную роль, но разные методы обрабаты¬ 
вают его по-разному. Ни один из методов массивов, введенных стандартом ЕСМА- 
8сгірі 5, не изменяет исходный массив. Разумеется, функция, передаваемая этим 
методам, может модифицировать исходный массив. 

7.9.1. Метод 1огЕасИ() 

Метод ^огЕасІі() выполняет обход элементов массива и для каждого из них вызы¬ 
вает указанную функцию. Как уже говорилось выше, функция передается мето¬ 
ду ^огЕасІі() в первом аргументе. При вызове этой функции метод "ГогЕасМС ) будет 
передавать ей три аргумента: значение элемента массива, индекс элемента и сам 
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массив. Если вас интересует только значение элемента, можно написать функ¬ 
цию с одним параметром - дополнительные аргументы будут игнорироваться: 

ѵаг дата = [1,2,3,4,5]; // Массив, элементы которого будут суммироваться 
// Найти сумму элементов массива 

ѵаг зит =0; // Начальное значение суммы 0 

сІаТа. 1 : огЕасН(1 : ипс1:іоп(ѵа1ие) { зьт += ѵаіье; }); // Прибавить значение к зьт 
зит // => 15 

// Увеличить все элементы массива на 1 

Ьаііа. 1 : огЕасН(1 : ипс1:іоп(ѵ, і, а) { а[і] = ѵ + 1; }); 

ЬаНа // => [2,3,4,5,6] 

Обратите внимание, что метод 'ГогЕасИ() не позволяет прервать итерации, пока все 
элементы не будут переданы функции. То есть отсутствует эквивалент инструк¬ 
ции Ьгеак, которую можно использовать с обычным циклом І'ог. Если потребуется 
прервать итерации раньше, внутри функции можно возбуждать исключение, 
а вызов ^огЕасЬО помещать в блок Іігу. Ниже демонстрируется функция ^огеасЬО, 
вызывающая метод 1"огЕасЬ() внутри такого блока Іігу. Если функция, которая пе¬ 
редается функции ^огеасЬО, возбудит исключение ^огеасЬ.Ьгеак, цикл будет пре¬ 
рван преждевременно: 

^ьпсіііоп ^огеасЬ(а, X, 1) { 

*гу { а. ^огЕасЬ^, 1:); } 
са1:сЬ(е) { 

и (е === І'огеасЬ. Ьгеак) геііигп; 
еізе ХЬгоѵі е; 

} 

} 

1Ч)геасЬ.Ьгеак = пе\ѵ Еггог("5і:орІ1:егаіііоп"); 

7.9.2. Метод тар() 

Метод шарО передает указанной функции каждый элемент массива, относитель¬ 
но которого он вызван, и возвращает массив значений, возвращаемых этой функ¬ 
цией. Например: 

а = [1, 2, 3]; 

Ь = а.тарОипсИогКх) { ге^ьгп х*х; }); // Ь = [1, 4, 9] 

Метод тар() вызывает функцию точно так же, как и метод "ГогЕасИ(). Однако функ¬ 
ция, передаваемая методу тар(), должна возвращать значение. Обратите внима¬ 
ние, что тар() возвращает новый массив: он не изменяет исходный массив. Если 
исходный массив является разреженным, возвращаемый массив также будет 
разреженным: он будет иметь ту же самую длину и те же самые отсутствующие 
элементы. 

7.9.3. Метод Шег() 

Метод Ш1:ег() возвращает массив, содержащий подмножество элементов исход¬ 
ного массива. Передаваемая ему функция должна быть функцией-предикатом, 
т.е. должна возвращать значение Іігие или І'аізе. Метод Ш1:ег() вызывает функ¬ 
цию точно так же, как методы ^огЕасЬО и тар(). Если возвращается Іігие или зна¬ 
чение, которое может быть преобразовано в Іігие, переданный функции элемент 
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считается членом подмножества и добавляется в массив, возвращаемый методом. 
Например: # 

а = [5, 4, 3, 2, 1]; 

зтаііѵаіііез = а. Гі11:ег(Гііпс1:іоп(х) { геіигп х < 3 }); // [2, 1] 

еѵегуоГйег = а. Гі11:ег(Гііпс1:іоп(х, і) { геГіігп і%2==0 }); // [5, 3. 1] 

Обратите внимание, что метод Ті11;ег() пропускает отсутствующие элементы в раз¬ 
реженных массивах и всегда возвращает плотные массивы. Чтобы уплотнить раз¬ 
реженный массив, можно выполнить следующие действия: 

ѵаг сіепзе = зрагзе. ГШе г (ГііпсГіогК ) { геіііігп *ще; }); 

А чтобы уплотнить массив и удалить из него все элементы со значениями ыпсІеГіпесІ 
и гшП, можно использовать метод ГШег(), как показано ниже: 

а = а. Гі1Гег(ГипсГіоп(х) { геГіігп х !== ипсіеі'іпесі && х ! = гшіі; }); 

7.9.4. Методы еѵегу() и 5 оте() 

Методы еѵегу() и зоте() являются предикатами массива: они применяют указан¬ 
ную функцию-предикат к элементам массива и возвращают {ше или Гаізе. Метод 
еѵегу() напоминает математический квантор всеобщности V: он возвращает Ггие, 
только если переданная вами функция-предикат вернула Ггие для всех элементов 
массива: 

а = [1,2,3,4,5]; 

а.еѵегу(Гыпс1:іоп(х) { геГіігп х < 10; }) // => {гііе: все значения < 10. 

а.еѵегу(Гііпс1:іоп(х) { геГіігп х % 2 === 0; }) // => Гаізе: не все четные. 

Метод зогпеО напоминает математический квантор существования 3: он возвра¬ 
щает Іігие, если в массиве имеется хотя бы один элемент, для которого функция- 
предикат вернет Іігие, а значение Гаізе возвращается методом, только если функ¬ 
ция-предикат вернет Гаізе для всех элементов массива: 

а = [1,2,3,4,5]; 

а.зоте(Гітс1:іоп(х) { геііігп х%2===0; }) // => Гте: имеются четные числа, 
а. зоте(ізМаМ) // => Гаізе: нет нечисловых элементов. 

Обратите внимание, что оба метода, еѵегу( ) и зоше(), прекращают обход элементов 
массива, как только результат становится известен. Метод зоте() возвращает 
Ггие, как только функция-предикат вернет Іігие, и выполняет обход всех элемен¬ 
тов массива, только если функция-предикат всегда возвращает Гаізе. Метод 
еѵегу() является полной противоположностью: он возвращает Гаізе, как только 
функция-предикат вернет Гаізе, и выполняет обход всех элементов массива, толь¬ 
ко если функция-предикат всегда возвращает Іігие. Кроме того, отметьте, что в со¬ 
ответствии с правилами математики для пустого массива метод еѵегу( ) возвраща¬ 
ет Іігие, а метод зоше() возвращает Гаізе. 

7.9.5. Методы гесІисе() и гесіисеКідЫО 

Методы гес^сеО и гесіисеРідііГО объединяют элементы массива, используя ука¬ 
занную вами функцию, и возвращают единственное значение. Это типичная опе¬ 
рация в функциональном программировании, где она известна также под назва¬ 
нием «свертка». Примеры ниже помогут понять суть этой операции: 
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ѵаг а = [1,2,3,4,5] 

ѵаг зііт = а. герцсе^ітсіпоп^,у) { геіюгп х+у }, 0); // Сумма значений 

ѵаг ргорцс* = а. геРцсеС^цпсИопСх, у) { геТи гп х*у }, 1); // Произвед. значений 
ѵаг тах = а. гес!исе(І'ипсіііоп(х, у) { ге1:іігп (х>у)?х:у; }); // Наибольш. значение 

Метод гейіісе() принимает два аргумента. В первом передается функция, которая 
выполняет операцию свертки. Задача этой функции - объединить некоторым спо¬ 
собом или свернуть два значения в одно и вернуть свернутое значение. В приме¬ 
рах выше функции выполняют объединение двух значений, складывая их, умно¬ 
жая и выбирая наибольшее. Во втором (необязательном) аргументе передается 
начальное значение для функции. 

Функции, передаваемые методу гес!исе(), отличаются от функций, передаваемых 
методам РогЕасОО и тар(). Знакомые уже значение, индекс и массив передаются 
им во втором, третьем и четвертом аргументах. А в первом аргументе передается 
накопленный результат свертки. При первом вызове в первом аргументе функ¬ 
ции передается начальное значение, переданное методу гес!іісе() во втором аргу¬ 
менте. Во всех последующих вызовах передается значение, полученное в резуль¬ 
тате предыдущего вызова функции. В первом примере, из приведенных выше, 
функция свертки сначала будет вызвана с аргументами 0 и 1. Она сложит эти 
числа и вернет 1. Затем она будет вызвана с аргументами 1 и 2 и вернет 3. Затем 
она вычислит 3+3=6, затем 6+4=10 и, наконец, 10+5=15. Это последнее значение 
15 будет возвращено методом гес!исе(). 

Возможно, вы обратили внимание, что в третьем вызове, в примере выше, методу 
гесІіісе() передается единственный аргумент: здесь не указано начальное значе¬ 
ние. Когда метод гесіисе( ) вызывается без начального значения, как в данном слу¬ 
чае, в качестве начального значения используется первый элемент массива. Это 
означает, что при первом вызове функции свертки будут переданы первый и вто¬ 
рой элементы массива. В примерах вычисления суммы и произведения точно так 
же можно было бы опустить аргумент с начальным значением. 

Вызов метода гес!исе() с пустым массивом без начального значения вызывает ис¬ 
ключение ТуреЕггог. Если вызвать метод с единственным значением - с массивом, 
содержащим единственный элемент, и без начального значения или с пустым 
массивом и начальным значением - он просто вернет это единственное значение, 
не вызывая функцию свертки. 

Метод гесіисеРідІп1:( ) действует точно так же, как и метод гес!іісе(), за исключением 
того, что массив обрабатывается в обратном порядке, от больших индексов к мень¬ 
шим (справа налево). Это может потребоваться, если операция свертки имеет ас¬ 
социативность справа налево, например: 

ѵаг а = [2, 3, 4] 

// Вычислить 2~(3~4). Операция возведения в степень имеет ассоциативность справа налево 
ѵаг Ьід = а. геРцсеВідИ1:(1 : ипс1:іоп(ассити1а1:ог, ѵаіііе) { 

геітгп Ма1+.ро\л/(ѵа1ііе,ассілгш1а1:ог); 

}); 

Обратите внимание, что ни гес!исе(), ни гес!исеРід01:() не принимают необязатель¬ 
ный аргумент, определяющий значение 1+із внутри функции свертки. Его место 
занял необязательный аргумент с начальным значением. Если потребуется вы¬ 
зывать функцию свертки как метод конкретного объекта, можно воспользовать¬ 
ся методом РітсІіоп.ЬіпсК). 
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Следует отметить, что методы еѵегу() и зоте(), описанные выше, являются свое¬ 
образной разновидностью операции свертки массива. Однако они отличаются от 
гес!іісе() тем, что стремятся завершить обход массива как можно раньше и не все¬ 
гда проверяют значения всех его элементов. 

В примерах, представленных до сих пор, для простоты использовались числовые 
массивы, но методы гес!исе() и гесІіісеРідІгЕО могут использоваться не только для 
математических вычислений. Взгляните на функцию ііпіоп() в примере 6.2. Она 
вычисляет «объединение» двух объектов и возвращает новый объект, имеющий 
свойства обоих. Эта функция принимает два объекта и возвращает другой объ¬ 
ект, т.е. она действует как функция свертки, поэтому ее можно использовать 
с методом гес1исе() и обобщить операцию создания объединения произвольного 
числа объектов: 

ѵаг оЬ]ес1:з = [{х:1}, {у:2}, {г:3}]; 

ѵаг тегдеР = оЬ]ес1:5. геРисе(ітіоп); // => {х:1, у:2, 2:3} 

Напомню, что, когда два объекта имеют свойства с одинаковыми именами, функ¬ 
ция ыпіопО использует значение свойства второго аргумента, т.е. гес!исе() и гесіи- 
сеВідГі1;( ) могут давать разные результаты при использовании с функцией ііпіоп( ): 

ѵаг оЬіесІіз = [{х:1,а:1}, {у:2,а:2}, {г:3.а:3}]: 

ѵаг ІеІЧітіоп = оЬ]ес1:з. гесііісе(ипіоп); // {х:1, у:2, 2:3, а:3} 

ѵаг гідйішпіоп = оЬ]ес1:5. геРіісеПідйКітіоп); // {х: 1. у:2. 2:3, а:1} 

7.9.6. Методы іпс!ехО{() и Іа5ІІпсІехО{() 

Методы іпсІехО^О и Іаз^ІпсіехОІЧ) отыскивают в массиве элемент с указанным зна¬ 
чением и возвращают индекс первого найденного элемента или -1, если элемент 
с таким значением отсутствует. Метод іпсІехОГО выполняет поиск от начала мас¬ 
сива к концу, а метод 1аз1:ІпсіехОГ() - от конца к началу. 

а = [0,1,2,1.0]: 

а. іпс1ех0Г( 1) // => 1: а[1] = 1 

а. 1аз1:Іпс1ех0Г( 1) // => 3: а[3] = 1 

а. іпс1ех0Г( 3) // => -1: нет элемента со значением 3 

В отличие от других методов, описанных в этом разделе, методы іпсІехОІЧ) и Іазі- 
ІпсІехОГО не принимают функцию в виде аргумента. В первом аргументе им пере¬ 
дается искомое значение. Второй аргумент является необязательным: он опреде¬ 
ляет индекс массива, с которого следует начинать поиск. Если опустить этот ар¬ 
гумент, метод іпсІехОГО начнет поиск с начала массива, а метод ІазІІпсІехО^О - 
с конца. Во втором аргументе допускается передавать отрицательные значения, 
которые интерпретируются как смещение относительно конца массива, как в ме¬ 
тоде зр1ісе( ): значение -1, например, соответствует последнему элементу массива. 

Следующая функция отыскивает заданное значение в массиве и возвращает мас¬ 
сив всех индексов, где было найдено совпадение. Здесь демонстрируется, как 
можно использовать второй аргумент метода іпРехОЮ для поиска совпадений по¬ 
сле первого. 


// Отыскивает все вхождения значения х в массив и возвращает 
// массив индексов найденных совпадений 
^псііоп ^іпРаІИа. х) { 
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} 


ѵаг гезцііз = [], 

Іеп = а. 1епд1:1п. 
роз = 0; 

\л/Рі1е(роз < Іеп) { 

роз = а. іпйехОІЧх, роз); 
ІТ (роз === -1) Ьгеак; 
гези11:з. рцзКроз); 
роз = роз + 1; 

} 

геііігп гезиіііз; 


// Возвращаемый массив индексов 
// Длина массива, где выполняется поиск 
// Начальная позиция поиска 
// Пока остались непроверенные элементы... 

// Искать 

// Если ничего не найдено, поиск завершен. 

// Иначе - сохранить индекс в массиве 

// И продолжить поиск со следующего элемента 

// Вернуть массив индексов 


Обратите внимание, что строки также имеют методы іпс!ехОТ() и 1аз1:Іпс1ехОТ(), ко¬ 
торые действуют подобно методам массивов. 


7.10. Тип Аггау 

На протяжении этой главы мы не раз имели возможность убедиться, что массивы 
являются объектами, обладающими особыми чертами поведения. Получая неиз¬ 
вестный объект, иногда бывает полезно проверить, является он массивом или нет. 
Сделать это в реализации ЕСМАЗсгірі 5 можно с помощью функции Аггау. ізАггау( ): 

Аггау. ізАггау([ ]) // => 1:гие 
Аггау. ізАггау({} ) // => Шзе 

Однако до выхода стандарта ЕСМА8сгірі 5 отличить массивы от других объектов 
было удивительно сложно. Оператор Іурео^ никак не помогает в этом: для масси¬ 
вов он возвращает строку «оЪіесІ» (и для всех других объектов, кроме функций). 
В простых случаях можно использовать оператор іпзіапсеоі 1 : 

[] іпзіапсеоі 1 Аггау // => ігце 
({}) іпзіапсеоі 1 Аггау // => Шзе 

Проблема применения оператора іпзіапсео^ состоит в том, что в веб-броузерах мо¬ 
жет быть открыто несколько окон или фреймов. Каждое окно или фрейм имеет соб¬ 
ственное окружение ЛѵаЗсгірІ, с собственным глобальным объектом. А каждый 
глобальный объект имеет собственное множество функций-конструкторов. По¬ 
этому объект из одного фрейма никогда не будет определяться как экземпляр кон¬ 
структора в другом фрейме. Даже при том, что путаница между фреймами возни¬ 
кает довольно редко, тем не менее этого вполне достаточно, чтобы считать опера¬ 
тор іпзіапсеоі 1 ненадежным средством определения принадлежности к массивам. 

Решение заключается в том, чтобы выполнить проверку атрибута сіазз (раз¬ 
дел 6.8.2) объекта. Для массивов этот атрибут всегда будет иметь значение 
♦Аггау», благодаря чему в реализации ЕСМАЗсгірі 3 функцию ізАггауО можно 
определить так: 

ѵаг ізАггау = Рііпсііоп.ізАггау || ^ііпсііопСо) { 
геііігп іуреоі 1 о === "оЦес*" && 

0Ь]есі. ргоіоіуре. іоЗіігіпд. саіі(о) === "[оЬіесІ: Аггау]"; 

}; 

Фактически именно такая проверка атрибута сіазз выполняется в функции Аггау. 
ізАггауО, определяемой стандартом ЕСМАЗсгірі 5. Прием определения класса 
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объекта с помощью ОЬ^есІ:. рго*о*уре.*о8*гіпд() был описан в разделе 6.8.2 и проде¬ 
монстрирован в примере 6.4. 

* 

7.11. Объекты, подобные массивам 

Как мы уже видели, массивы в языке ЛѵаЗсгірі обладают некоторыми особенно¬ 
стями, отсутствующими в других объектах: 

• Добавление нового элемента вызывает автоматическое обновление свойства 

ІепдІЬ. 

• Уменьшение значения свойства ІепдІЬ вызывает усечение массива. 

• Массивы наследуют множество удобных методов от Аггау. ргойЛуре. 

• Атрибут с1а$$ массивов имеет значение «Аггау». 

Все эти характеристики отличают массивы в языке ЛѵаЗсгірі от других объек¬ 
тов. Но они не главное, что определяет массив. Часто бывает удобно организовать 
работу с произвольным объектом, как со своего рода массивом - через свойство 
ІепдіЬ и соответствующие неотрицательные целочисленные свойства. 

Такие объекты, «подобные массивам», иногда используются для решения прак¬ 
тических задач, и хотя с ними нельзя работать через методы массивов или ожи¬ 
дать специфического поведения свойства ІепдІЬ, все же можно организовать пере¬ 
бор свойств объекта теми же программными конструкциями, которые использу¬ 
ются при работе с настоящими массивами. Оказывается, что значительное число 
алгоритмов для работы с массивами вполне пригодно для работы с объектами, 
подобными массивам. Это особенно верно, если используемые алгоритмы не из¬ 
меняют массивы или хотя бы не затрагивают его свойство ІепдІіМ. 

В следующем фрагменте создается обычный объект и к нему добавляются допол¬ 
нительные свойства, которые превращают его в объект, подобный массиву, после 
чего производится перебор «элементов» получившегося псевдомассива: 

ѵаг а = {}; // Для начала создать обычный пустой объект 

// Добавить свойства, которые сделают его похожим на массив 
ѵаг і = 0; 

\ѵГ»і1е(і < 10) { 
а[і] = і * і; 
і++; 

} 

а.1епд1:Іі = і; 

// Теперь можно обойти свойства объекта, как если бы он был настоящим массивом 
ѵаг Іоіаі = 0; 

І'огСѵаг і = 0; і < а.іепдіііі; ]++) 

*о*а1 += а[Я; 

Объект Агдитепіз, который описывается в разделе 8.3.2, является объектом, по¬ 
добным массиву. В клиентском языке ^ѵаЗсгірІ такие объекты возвращаются 
многими методами объектной модели документа (БОМ), такими как метод сіосы- 
теп*.де*Е1егпеп*зВуТадМагпе(). Следующая функция проверяет, является ли объект 
подобным массиву: 
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// Определяет, является ли о объектом, подобным массиву. Строки и функции имеют 
// числовое свойство ІепдТІт, но они исключаются проверкой ТуреоГ 
// В клиентском ОаѵаЗсгірІ: текстовые узлы йОМ имеют числовое свойство ІепдТИ 
// и, возможно, должны быть исключены дополнительной проверкой о.побеТуре != 3. 
ТііпсТіоп ізАггауІлке(о) { 

і? (о && // о не пііП, не ііпРе^іпеб и т. д. 

Туреоі 1 о === "оЬ^есТ" && //о - объект 

ізРіпіТе(о. ІепдТІі) && // о.ІепдТІі - конечное число 

о.іепдііі >= 0 && // о.ІепдіГі - положительное 

о. 1епдТН===МаТН. Ноог(о. ІепдТІт ) && // о.ІепдТН - целое 
о.ІепдТІі < 4294967296) // о.ІепдТН < 2~32 


геТцгп Ігііе; 

еізе 

геііігп Таізе; 

} 


// Значит, объект о подобен массиву 
// Иначе - нет 


В разделе 7.12 будет показано, что строки в ЕСМАЗсгірі 5 ведут себя подобно мас¬ 
сивам (и некоторые броузеры обеспечивали возможность обращения к символам 
в строке по индексам еще до выхода ЕСМАЗсгірі 5). Однако проверки на подобие 
массивам, такие как приведенная выше, для строк обычно возвращают Шве - 
с ними лучше работать как со строками, чем как с массивами. 

Методы массивов в языке ЛѵаЗсгірі преднамеренно были сделаны достаточно 
универсальными, чтобы их можно было использовать не только с настоящими 
массивами, но и с объектами, подобными массивам. В ЕСМАВсгірІ 5 все методы 
массивов являются универсальными. В ЕСМАЗсгірі 3 универсальными также 
являются все методы, за исключением 1о81гіпд() и 1оІ_оса1е8ігіпд(). (К исключе¬ 
ниям также относится метод сопса!(): несмотря на то что его можно применять 
к объектам, подобным массивам, он некорректно разворачивает объекты в воз¬ 
вращаемый массив.) Поскольку объекты, подобные массивам, не наследуют свой¬ 
ства от Аггау. ргоііоііуре, к ним нельзя напрямую применить методы массивов. Од¬ 
нако их можно вызывать косвенно, с помощью метода Рипс*іоп.са11(): 

ѵаг а = {"О":"а”, *' 1 ”:"Ь”, ”2":"с", Іепд^Іі :3}; // Объект, подобный массиву 
Аггау.рго*о*уре. ;)оіп.са11(а, "+") // => "а+Ь+с" 

Аггау.рго*о*уре. зіісе. са11(а, 0) // => ['а"."Ь","с"]: копия, настоящий массив 
Аггау.рго*о*уре.тар.са11(а, ^цпсііоп(х) { 
геііігп х. ІоОррегСазеС ); 

}) // => ["АѴВѴС"]: 

Мы уже встречались с таким использованием метода са11() в разделе 7.10, где 
описывался метод ізАггау(). Метод са11() объектов класса Рыпсіііоп детально рас¬ 
сматривается в разделе 8.7.3. 

Методы массивов, определяемые в ЕСМАЗсгірі 5, были введены в Еігеіох 1.5. По¬ 
скольку они имели универсальную реализацию, в Еігеіох также были введены 
версии этих методов в виде функций, объявленных непосредственно в конструк¬ 
торе Аггау. Если использовать эти версии методов, примеры выше можно перепи¬ 
сать так: 


ѵаг а = {"О":"а", "1 ’:"Ь”, "2":"с", 1епдІН:3}; // Объект, подобный массиву 
Аггау. ]оіп(а, "+") 

Аггау. з1ісе(а, 0) 

Аггау.тар(а, ^цпс*іоп(х) { геіцгп х. ІоУррегСазеС ); }) 
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Эти статические версии методов массивов чрезвычайно удобны при работе с объ¬ 
ектами, подобными массивам, но, так как они не стандартизованы, нельзя рас¬ 
считывать, что они будут определены во всех броузерах. В своих программах вь* 
можете использовать следующий программный код, который обеспечит доступ¬ 
ность функций перед их использованием: 

Аггау. іоіп = Аггау. іоіп || ^ипс*іоп(а, зер) { 
гѳіііігп Аггау. ргоіоіуре.іоіп.са11(а, зер); 

}; 

Аггау. зіісе = Аггау. зіісе || ГііпсІііопСа, Ітот, Іо) { 
геііігп Аггау. рго*о*уре.зіісе. саіі(а, Ітот, Іо); 

}; 

Аггау. тар = Аггау. тар || ^ііпс*іоп(а, "СГіізАгд) { 

ге*іігп Аггау. ргоіоіуре. тар. са11(а, Т, ІіГіізАгд); 

} 


7.12. Строки как массивы 


В ЕСМАВсгірІ 5 (и во многих последних версиях броузеров, включая ІЕ8, появив¬ 
шихся до выхода стандарта ЕСМАВсгірІ 5) строки своим поведением напоминают 
массивы, доступные только для чтения. Вместо метода сЬагАШ для обращения 
к отдельным символам можно использовать квадратные скобки: 


ѵаг з = Іезі; 
з.сИагА*(0) // => "I" 

з[1] // => "е" 


Оператор ІіуреоГ для строк все так же возвращает «зігіп^», а если строку передать 
методу Аггау. ізАггауО, он вернет Гаізе. 

Основное преимущество, которое дает поддержка индексирования строк, - это 
возможность заменить вызов метода сйагАШ квадратными скобками и получить 
более краткий, удобочитаемый и, возможно, более эффективный программный 
код. Однако тот факт, что строки своим поведением напоминают массивы, озна¬ 
чает также, что к ним могут применяться универсальные методы массивов. На¬ 
пример: 


з = ’^аѵаЗсгірі" 

Аггау. ргоіоіуре.]оіп.са11(з, " ") 
Аггау. ргоіоіуре. ГШег. са11(з, 
Гііпс1:іоп(х) { 

гѳіііігп х.та1:сЬ(/[''аеіои]/); 
}).]0ІП("") 


// => '^ а ѵ а 8 с г і р I" 

// Фильтровать символы строки 

// Совпадение только с согласными 
// => ’^уЗсгрІ:" 


Имейте в виду, что строки являются неизменяемыми значениями, поэтому при 
работе с ними как с массивами их следует интерпретировать как массивы, дос¬ 
тупные только для чтения. Такие методы массивов, как ризМ(), зог1:(), геѵегзеО 
и зрІісеО, изменяют исходный массив и не будут работать со строками. Однако 
попытка изменить строку с помощью метода массива не вызовет ошибку: строка 
просто не изменится. 




8 

Функции 


Функция - это блок программного кода на языке ЛѵаЗсгірі, который определяет¬ 
ся один раз и может выполняться, или вызываться , многократно. Возможно, вы 
уже знакомы с понятием «функция» под другим названием, таким как подпро¬ 
грамма, или процедура . Функции могут иметь параметры: определение функции 
может включать список идентификаторов, которые называются параметрами 
и играют роль локальных переменных в теле функции. При вызове функций им 
могут передаваться значения, или аргументы , соответствующие их параметрам. 
Функции часто используют свои аргументы для вычисления возвращаемого зна¬ 
чения , которое является значением выражения вызова функции. В дополнение 
к аргументам при вызове любой функции ей передается еще одно значение, опре¬ 
деляющее контекст вызова - значение в ключевом слове іИіз. 

Если функция присваивается свойству объекта, она называется методом объек¬ 
та. Когда функция вызывается посредством объекта , этот объект становится 
контекстом вызова, или значением ключевого слова *йіз. Функции, предназна¬ 
ченные для инициализации вновь созданных объектов, называются конструкто¬ 
рами . Конструкторы были описаны в разделе 6.1, и мы вернемся к ним в главе 9. 

Функции в языке ЛѵаЗсгірі являются объектами и могут использоваться разны¬ 
ми способами. Например, функции могут присваиваться переменным и переда¬ 
ваться другим функциям. Поскольку функции являются объектами, имеется 
возможность присваивать значения их свойствам и даже вызывать их методы. 

В ЛѵаЗсгірі допускается создавать определения функций, вложенные в другие 
функции, и такие функции будут иметь доступ ко всем переменным, присутствую¬ 
щим в области видимости определения. То есть функции в языке ^ѵабсгірі яв¬ 
ляются замыканиями , что позволяет использовать разнообразные мощные прие¬ 
мы программирования. 

8.1. Определение функций 

Определение функций выполняется с помощью ключевого слова "Гипсіііоп, кото¬ 
рое может использоваться в выражениях определения функций (раздел 4.3) или 
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в инструкциях объявления функций (раздел 5.3.2). В любом случае определение 
функции начинается с ключевого слова Гипсіііоп, за которым указываются сле¬ 
дующие компоненты: 

• Идентификатор, определяющий имя функции. Имя является обязательной 
частью инструкции объявления функции: оно будет использовано для созда¬ 
ния новой переменной, которой будет присвоен объект новой функции. В вы¬ 
ражениях определения функций имя может отсутствовать: при его наличии 
имя будет ссылаться на объект функции только в теле самой функции. 

• Пара круглых скобок вокруг списка из нуля или более идентификаторов, раз¬ 
деленных запятыми. Эти идентификаторы будут определять имена параметров 
функции и в теле функции могут использоваться как локальные переменные. 

• Пара фигурных скобок с нулем или более инструкций ЛаѵаЗсгірі внутри. Эти 
инструкции составляют тело функции: они выполняются при каждом вызове 
функции. 

В примере 8.1 показано несколько определений функций в виде инструкций 
и выражений. Обратите внимание, что определения функций в виде выражений 
удобно использовать, только если они являются частью более крупных выраже¬ 
ний, таких как присваивание или вызов функции, которые выполняют некото¬ 
рые действия с помощью вновь объявленной функции. 


Именование функций 

В качестве имени функции может использоваться любой допустимый иден¬ 
тификатор. Старайтесь выбирать функциям достаточно описательные, но 
не длинные имена. Искусство сохранения баланса между краткостью и ин¬ 
формативностью приходит с опытом. Правильно подобранные имена функ¬ 
ций могут существенно повысить удобочитаемость (а значит, и простоту со¬ 
провождения) ваших программ. 

Чаще всего в качестве имен функций выбираются глаголы или фразы, на¬ 
чинающиеся с глаголов. По общепринятому соглашению имена функций 
начинаются со строчной буквы. Если имя состоит из нескольких слов, в со¬ 
ответствии с одним из соглашений они отделяются друг от друга символом 
подчеркивания, примерно так: Пке_Ш$(), по другому соглашению все сло¬ 
ва, кроме первого, начинаются с прописной буквы, примерно так: 1ікеТГііз( ). 
Имена функций, которые, как предполагается, реализуют внутреннюю, 
скрытую от посторонних глаз функциональность, иногда начинаются с сим¬ 
вола подчеркивания. 

В некоторых стилях программирования или в четко определенных про¬ 
граммных платформах бывает полезно давать наиболее часто используе¬ 
мым функциям очень короткие имена. Примером может служить библио¬ 
тека і(}иегу клиентского ЛаѵаЗсгірі (описываемая в главе 19), в которой 
широко используется функция с именем $() (да-да, просто знак доллара). 
(В разделе 2.4 уже говорилось, что в идентификаторах ЛаѵаВсгірі помимо 
алфавитно-цифровых символов допускается использовать знаки доллара 
и подчеркивания.) 
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Пример 8.1. Определения ^ ѵаЗсгірІ-функций 

// Выводит имена и значения всех свойств объекта о. Возвращает ііпРеНпей. 

І'ііпсііоп ргіп1:ргорз(о) { 

^ог(ѵаг р іп о) 

сопзоіе.1од(р + ": + о[р] + "\п"); 

} 

// Вычисляет Декартово расстояние между точками (хі.уі) и (х2,у2). 

^цпсіііоп Різ1:апсе(х1, уі. х2, у2) { 
ѵаг йх = х2 - хі; 
ѵаг Ру = у2 - уі; 
геіііігп Ма1:1і.зрг1:(Рх*Рх + Ру*Ру); 

} 

// Рекурсивная функция (вызывающая сама себя), вычисляющая факториал 

// Напомню, что х! - это произведение х и всех положительных целых чисел, меньше х. 

^цпсііоп ^асіогіаі(х) { 

ІТ (х <= 1) геііігп 1; 
геіііігп х * ^ас1:огіа1(х-1); 

} 

// Следующее выражение определяет функцию, вычисляющую квадрат аргумента. 

// Обратите внимание, что она присваивается переменной 
ѵаг зцііаге = ^ипсііоп(х) { геіііігп х*х; } 

// Выражения определения функций могут иметь имена, что позволяет 
// производить рекурсивные вызовы. 

ѵаг Т = ?цпс*іоп ?ас*(х) { (х <= 1) геііігп 1; еізе геііігп х*^асІ(х-1); }; 

// Выражения определения функций могут также использоваться в качестве 
// аргументов других выражений: 

Раіа.зогК^ііпсІіопСа, Ь) { геііігп а-Ь: }): 

// Выражения определения функций иногда могут тут же вызываться: 
ѵаг ІіепзрііагеР = (^цпсіііопСх) {геіііігп х*х;}(10)); 

Обратите внимание, что в выражениях определения функций имя функции мо¬ 
жет отсутствовать. Инструкция объявления функции фактически объявляет пе¬ 
ременную и присваивает ей объект функции. Выражение определения функции, 
напротив, не объявляет переменную. Однако в выражениях определения допус¬ 
кается указывать имя функции, как в функции вычисления факториала выше, 
которое может потребоваться в теле функции для вызова себя самой. Если выра¬ 
жение определения функции включает имя, данное имя будет ссылаться на объ¬ 
ект функции в области видимости этой функции. Фактически имя функции ста¬ 
новится локальной переменной, доступной только в теле функции. В большинст¬ 
ве случаев имя функции не требуется указывать в выражениях определения, что 
делает определения более компактными. Особенно удобно использовать выраже¬ 
ния для определения однократно используемых функций, как в последних двух 
примерах выше. 

Как описывалось в разделе 5.3.2, инструкции объявления функций «поднима¬ 
ются» в начало сценария или вмещающей их функции, благодаря чему объяв¬ 
ленные таким способом функции могут вызываться в программном коде выше 
объявления. Это не относится к функциям, которые определяются в виде выра¬ 
жений: чтобы вызвать функцию, необходимо иметь возможность сослаться на 
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нее, однако нельзя сослаться на функцию, которая определяется с помощью вы¬ 
ражения, пока она не будет присвоена переменной. Объявления переменных так¬ 
же поднимаются вверх (раздел 3.10.1), но операции присваивания значений этим 
переменным не поднимаются, поэтому функции, определяемые в виде выраже¬ 
ний, не могут вызываться до того, как они будут определены. 

Обратите внимание, что большинство (но не все) функций в примере 8.1 содержат 
инструкцию геГигп (раздел 5.6.4). Инструкция геГигп завершает выполнение функ¬ 
ции и выполняет возврат значения своего выражения (если указано) вызываю¬ 
щей программе. Если выражение в инструкции геііигп отсутствует, она возвраща¬ 
ет значение ипсІеГіпесі. Если инструкция геііигп отсутствует в функции, интерпре¬ 
татор просто выполнит все инструкции в теле функции и вернет вызывающей 
программе значение ипсІеГіпесі. 

Большинство функций в примере 8.1 вычисляют некоторое значение, и в них ин¬ 
струкция геГигп используется для возврата этого значения вызывающей про¬ 
грамме. Функция ргіпГргорзО несколько отличается в этом смысле: ее работа за¬ 
ключается в том, чтобы вывести имена свойств объекта. Ей не нужно возвращать 
какое-либо значение, поэтому в функции отсутствует инструкция геГигп. Функ¬ 
ция ргіпГргорзО всегда будет возвращать значение ипсІеГіпесі. (Функции, не имею¬ 
щие возвращаемого значения, иногда называются процедурами .) 

8.1.1. Вложенные функции 

В ЛаѵаЗсгірі допускается вложение определений функций в другие функции. На¬ 
пример: 

ГііпсГіоп йуроГепизеСа, Ь) { 

ГипсГіоп здиаге(х) { геГигп х*х; } 
геііігп МаГЬ.здг1:(здиаге(а) + здііаге(Ь)); 

} 

Особый интерес во вложенных функциях представляют правила видимости пе¬ 
ременных: они могут обращаться к параметрам и переменным, объявленным во 
вмещающей функции (или функциях). Например, в определении выше внутрен¬ 
няя функция здиагеО может читать и изменять параметры а и Ь, объявленные во 
внешней функции ЬуроГепизе(). Эти правила видимости, действующие для вло¬ 
женных функций, играют важную роль, и мы еще вернемся к ним в разделе 8.6. 

Как отмечалось в разделе 5.3.2, инструкции объявления функций в действитель¬ 
ности не являются настоящими инструкциями, и спецификация ЕСМА8сгірі до¬ 
пускает использовать их только в программном коде верхнего уровня. Они могут 
появляться в глобальном программном коде или внутри других функций, но они 
не могут находиться внутри циклов, условных инструкций, инструкций Ггу/ 
саГсЬ/ГіпаІІу или ѵѵіГЬ. 1 Обратите внимание, что эти ограничения распространя¬ 
ются только на объявления функций в виде инструкции ГипсГіоп. Выражения 
определения функций могут присутствовать в любом месте в программе на языке 
Лаѵа8сгірі. 


1 Некоторые реализации ^ѵаВсгірі могут иметь менее строгие требования. Например, 
в броузере РігеГох допускается наличие «условных определений функций» внутри ин¬ 
струкций іГ. 
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Программный код, образующий тело функции, выполняется не в момент опреде¬ 
ления функции, а в момент ее вызова. Функции в языке Лаѵа8сгірІ могут вызы¬ 
ваться четырьмя способами: 

• как функции, 

• как методы, 

• как конструкторы и 

• косвенно, с помощью их методов са11() и арр1у(). 

8.2.1. Вызов функций 

Вызов функций как функций или как методов, выполняется с помощью выраже¬ 
ния вызова (раздел 4.5). Выражение вызова состоит из выражения обращения 
к функции, которое возвращает объект функции, и следующими за ним круглы¬ 
ми скобками со списком из нуля или более выражений-аргументов, разделенных 
запятыми, внутри. Если выражение обращения к функции является выражени¬ 
ем обращения к свойству - если функция является свойством объекта или эле¬ 
ментом массива - тогда выражение вызова является выражением вызова метода. 
Этот случай будет описан ниже. В следующем фрагменте демонстрируется не¬ 
сколько примеров выражений вызова обычных функций: 

ргіп1:ргорз({х:1}); 

ѵаг ІоШ = бізІапсеСО.0, 2, 1) + с1і5І:апсе(2.1,3,5); 
ѵаг ргоЬаЫШу = ^ас1:огіа1(5)/1 : ас1:огіа1( 13); 

При вызове функции вычисляются все выражения-аргументы (указанные меж¬ 
ду скобками), и полученные значения используются в качестве аргументов функ¬ 
ции. Эти значения присваиваются параметрам, имена которых перечислены 
в определении функции. В теле функции выражения обращений к параметрам 
возвращают значения соответствующих аргументов. 

При вызове обычной функции возвращаемое функцией значение становится зна¬ 
чением выражения вызова. Если возврат из функции происходит по достижении 
ее конца интерпретатором, возвращается значение ипсІе'ГіпесІ. Если возврат из 
функции происходит в результате выполнения инструкции геііигп, возвращается 
значение выражения, следующего за инструкцией геііигп, или ипсІе'ГіпесІ, если ин¬ 
струкция геііигп не имеет выражения. 

При вызове функции в ЕСМА8сгірі 3 и в нестрогом режиме ЕСМА8сгірі 5 кон¬ 
текстом вызова (значением ІіИіз) является глобальный объект. Однако в строгом 
режиме контекстом вызова является значение ипсІе'ГіпесІ. 

Функции, которые предназначались для использования в виде простых функ¬ 
ций, обычно вообще не используют ключевое слово ІіОіз. Впрочем, его можно ис¬ 
пользовать, чтобы определить, не выполняется ли функция в строгом режиме: 

// Определение и вызов функции, которая выясняет действующий режим работы, 
ѵаг з*гісІ = ( Гипс1:іоп( ) { геііигп !ІіГііз; }()); 
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Составление цепочек вызовов методов 

Когда методы возвращают объекты, появляется возможность использо¬ 
вать значение, возвращаемое одним методом, как часть последующих вы¬ 
зовов. Это позволяет создавать последовательности («цепочки», или «кас¬ 
кады») вызовов методов в одном выражении. При работе с библиотекой 
І(}иегу (глава 19), например, часто можно встретить такие инструкции: 

// Отыскать все заголовки, отобразить их в значения атрибутов іб, 

// преобразовать в массив и отсортировать 

$(" :Ііеабег").тар(1 : ііпс1:іоп() { геіьгп Шз. іб }).де*().зог*(); 

Если вы пишете метод, не имеющий собственного возвращаемого значе¬ 
ния, подумайте о возможности возвращать из него значение іііііз. Если не¬ 
уклонно следовать этому правилу при разработке своего АРІ, появится воз¬ 
можность использовать стиль программирования, известный как состав¬ 
ление цепочек из методов ,* когда обращение к имени метода выполняется 
один раз, а затем может следовать множество вызовов его методов: 

зЬаре. зе1:Х( 100). зе1:Ѵ( 100). зе1:8і2е(50) . зеЮііШпеС' гесГ). зе*РШ( "Ыііе"). бгам( ); 

Не путайте цепочки вызовов методов с цепочками конструкторов, которые 
описываются в разделе 9.7.2. 


8.2.2. Вызов методов 

Метод - это не что иное, как функция, которая хранится в виде свойства объек¬ 
та. Если имеется функция ? и объект о, то можно определить метод объекта о 
с именем т, как показано ниже: 

о.т = 

После этого можно вызвать метод т() объекта о: 

о.т(); 

Или, если метод т() принимает два аргумента, его можно вызвать так: 

о.ш(х, у); 

Строка выше является выражением вызова: она включает выражение обращения 
к функции о.т и два выражения-аргумента, х и у. Выражение обращения к функ¬ 
ции в свою очередь является выражением обращения к свойству (раздел 4.4), 
а это означает, что функция вызывается как метод, а не как обычная функция. 

Аргументы и возвращаемое значение при вызове метода обрабатываются точно 
так же, как при вызове обычной функции. Однако вызов метода имеет одно важ¬ 
ное отличие: контекст вызова. Выражение обращения к свойству состоит из двух 
частей: объекта (в данном случае о) и имени свойства (т). В подобных выражениях 


1 Термин был введен Мартином Фаулером (Магііп Голѵіег). См. кіір://тагііп[оіѵІег.сот/ 
с ізІіѵір/МеікойСкаіпіпё.кітІ . 





8.2. Вызов функций 


191 


вызова методов объект о становится контекстом вызова, и тело функции получа¬ 
ет возможность ссылаться на этот объект с помощью ключевого слова Шз. На¬ 
пример: 

ѵаг саісціаііог = { // Литерал объекта 
орегапсЛ: 1, 
орегапб2: 1, 
асМ: ІцпсІіопО { 

// Обратите внимание, что для ссылки на этот объект используется 
// ключевое слово ІМз. 

Шз. гезыИ: = Шз.орегапсЛ + Шз.орегапсі2; 

} 

}; 

саісиіаііог.асісК); // Вызвать метод, чтобы вычислить 1+1. 
саісыіаііог. гезыИ: // => 2 

Чаще всего при вызове методов используется форма обращения к свойствам с по¬ 
мощью оператора точки, однако точно так же можно использовать форму обраще¬ 
ния к свойствам с помощью квадратных скобок. Например, оба следующих выра¬ 
жения являются выражениями вызова методов: 

о["т"](х,у); // Другой способ записать это выражение: о.т(х.у). 

а[0](г) // Тоже вызов метода (предполагается, что а[0] - это функция). 

Выражения вызова методов могут включать более сложные выражения обраще¬ 
ния к свойствам: 

сызІіотег.зигпате.ІіоиррегСазеО: // Вызвать метод объекта сцзііотег. зцгпате 
Т().т(); // Вызвать метод т() возвращаемого значения функции Т() 

Методы и ключевое слово Шз занимают центральное место в парадигме объект¬ 
но-ориентированного программирования. Любая функция, используемая как 
метод, фактически получает неявный аргумент - объект, относительно которого 
она была вызвана. Как правило, методы выполняют некоторые действия с объек¬ 
том, и синтаксис вызова метода наглядно отражает тот факт, что функция опери¬ 
рует объектом. Сравните следующие две строки: 

гее*. зеШгеСмісЛііі, ііеідііі:); 
зе 1 :Вес 1 : 8 і 2 е(гес 1 :, місЛііі, ііеідііі:); 

Гипотетически функции, вызывающиеся в этих двух строках, могут производить 
абсолютно идентичные действия над объектом гесі (гипотетическим), но синтак¬ 
сис вызова метода в первой строке более наглядно демонстрирует, что в центре 
внимания находится объект гесі. 

Обратите внимание: Шз - это именно ключевое слово, а не имя переменной или 
свойства. Синтаксис ЛѵаЗсгірі не допускает возможность присваивания значе¬ 
ний элементу Шз. 

В отличие от переменных, ключевое слово Шз не имеет области видимости, 
и вложенные функции не наследуют значение Шз от вызывающей функции. Ес¬ 
ли вложенная функция вызывается как метод, значением Шз является объект, 
относительно которого был сделан вызов. Если вложенная функция вызывается 
как функция, то значением Шз будет либо глобальный объект (в нестрогом ре¬ 
жиме), либо ипсіеііпесі (в строгом режиме). Распространенная ошибка полагать. 
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что во вложенной функции, которая вызывается как функция, можно использо¬ 
вать 1:Иіз для получения доступа к контексту внешней функции. Если во вложен¬ 
ной функции необходимо иметь доступ к значению Шз внешней функции, это 
значение следует сохранить в переменной, находящейся в области видимости 
внутренней функции. Для этой цели часто используется переменная с именем 
зеІГ. Например: 


ѵаг о = { 

т: Гцпс1:іоп() { 

ѵаг зеІГ = Шз; 
сопзоіе. 1од(Шз === о); 

Ю\ 

ГцпсГіоп 1=0 { 

сопзоіе. 1од(Шз === о); 
сопзоіе. 1од(зе1Г === о); 

} 

} 

}; 

о.т(); 


// Объект о. 

// Метод т объекта. 

// Сохранить значение Гіііз в переменной. 

// Выведет "Ггце": Гіііз - это объект о. 

// Вызвать вспомогательную ф-цию Г(). 

// Вложенная функция Г 

// "Гаізе": Гіііз - глоб. об. или цпсіеГіпесІ 

// "Ггііе": зеІГ - знач. ГИіз внеш. ф-ции. 


// Вызвать метод т объекта о. 


В примере 8.5 (раздел 8.7.4) демонстрируется более практичный способ использо¬ 
вания идиомы ѵаг $е1Г=Ш$. 


8.2.3. Вызов конструкторов 

Если вызову функции или метода предшествует ключевое слово пем, следователь¬ 
но, это вызов конструктора. (Вызовы конструкторов обсуждались в разделах 4.6 
и 6.1.2, а более подробно конструкторы будут рассматриваться в главе 9.) Вызов 
конструктора отличается от вызова обычной функции или метода особенностями 
обработки аргументов, контекстом вызова и возвращаемым значением. 

Если вызов конструктора включает список аргументов в скобках, эти выраже¬ 
ния-аргументы вычисляются и передаются конструктору точно так же, как лю¬ 
бой другой функции или методу. Но если конструктор не имеет параметров, син¬ 
таксис вызова конструктора в языке ЛѵаЗсгірі позволяет вообще опустить скоб¬ 
ки и список аргументов. При вызове конструктора всегда можно опустить пару 
пустых скобок. Например, следующие две строки полностью эквивалентны: 

ѵаг о = пем О^есГО; 
ѵаг о = пем О^есГ; 

Вызов конструктора создает новый пустой объект, наследующий свойство ргоГо- 
Гуре конструктора. Назначение функции-конструктора - инициализировать объ¬ 
ект, и этот вновь созданный объект передается конструктору как контекст вызо¬ 
ва, благодаря чему функция-конструктор может ссылаться на него с помощью 
ключевого слова ГГііз. Обратите внимание, что вновь созданный объект передает¬ 
ся как контекст вызова, даже если вызов конструктора выглядит как вызов мето¬ 
да. То есть в выражении пем о.ш() контекстом вызова будет вновь созданный объ¬ 
ект, а не объект о. 

Как правило, в функциях-конструкторах не используется инструкция геіигп. 
Обычно они выполняют инициализацию нового объекта и неявно возвращают 
его, по достижении своего конца. В этом случае значением выражения вызова 
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конструктора становится новый объект. Однако если конструктор явно вернет 
объект с помощью инструкции геііигп, то значением выражения вызова конструк¬ 
тора станет этот объект. Если конструктор выполнит инструкцию геііигп без зна-, 
чения или вернет с ее помощью простое значение, это возвращаемое значение бу¬ 
дет проигнорировано и в качестве результата вызова будет использован новый 
объект. 

8.2.4. Косвенный вызов 

Функции в языке ЛѵаЗсгірі являются объектами и подобно другим объектам 
имеют свои методы. В их числе есть два метода, са11() и арр1у(), выполняющие 
косвенный вызов функции. Оба метода позволяют явно определить значение ІіНіз 
для вызываемой функции, что дает возможность вызывать любую функцию как 
метод любого объекта, даже если фактически она не является методом этого объ¬ 
екта. Кроме того, обоим методам можно передать аргументы вызова. Метод са11() 
позволяет передавать аргументы для вызываемой функции в своем собственном 
списке аргументов, а метод аррІуО принимает массив значений, которые будут 
использованы как аргументы. Подробнее о методах са11() и аррІуО рассказывает¬ 
ся в разделе 8.7.3. 

8.3. Аргументы и параметры функций 

В языке ЛѵаЗсгірі, в определениях функций не указываются типы параметров, 
а при вызове функций не выполняется никаких проверок типов передаваемых 
значений аргументов. Фактически при вызове функций в языке ЛѵаЗсгірі не 
проверяется даже количество аргументов. В подразделах ниже описывается, что 
происходит, если число аргументов в вызове функции меньше или больше числа 
объявленных параметров. В них также демонстрируется, как можно явно прове¬ 
рить типы аргументов функции, если необходимо гарантировать, что функция не 
будет вызвана с некорректными аргументами. 

8.3.1. Необязательные аргументы 

Когда число аргументов в вызове функции меньше числа объявленных парамет¬ 
ров, недостающие аргументы получают значение ипсіе'Гіпес!. Часто бывает удоб¬ 
ным писать функции так, чтобы некоторые аргументы были необязательными 
и могли опускаться при вызове функции. В этом случае желательно предусмот¬ 
реть возможность присваивания достаточно разумных значений по умолчанию 
параметрам, которые могут быть опущены. Например: 

// Добавить в массив а перечислимые имена свойств объекта о и вернуть его. 

// Если аргумент а не не был передан, создать и вернуть новый массив. 

^ііпсіііоп де1:Ргорегі:уМате5(о, /* необязательный */ а) { 

іГ (а === ііпсіеі'іпесі) а = []; // Если массив не определен, создать новый 
^ог(ѵаг ргорегіу іп о) а.ризИ( ргорегііу ); 
геііигп а; 

} 

// Эта функция может вызываться с 1 или 2 аргументами: 

ѵаг а = де1:Ргорег1:уЫатез(о); // Получить свойства объекта о в новом массиве 

де1:Ргорегі:уМатез(р, а); // добавить свойства объекта р в этот массив 
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Вместо инструкции і Г в первой строке этой функции можно использовать опера¬ 
тор 11 следующим образом: 

а = а 11 []; 

В разделе 4.10.2 говорилось, что оператор 11 возвращает первый аргумент, если он 
имеет истинное значение, и в противном случае возвращает второй аргумент. 
В данном примере, если во втором аргументе будет передан какой-либо объект, 
функция будет использовать его. Но если второй аргумент отсутствует (или в нем 
будет передано значение пиіі), будет использоваться вновь созданный массив. 

Обратите внимание, что при объявлении функций необязательные аргументы 
должны завершать список аргументов, чтобы их можно было опустить. Програм¬ 
мист, который будет писать обращение к вашей функции, не сможет передать 
второй аргумент и при этом опустить первый: он будет вынужден явно передать 
в первом аргументе значение ипсіеГіпесі. Обратите также внимание на коммента¬ 
рий /* необязательный */ в определении функции, который подчеркивает тот факт, 
что параметр является необязательным. 

8.3.2. Списки аргументов переменной длины: 
объект Агдитеп(5 

Если число аргументов в вызове функции превышает число имен параметров, 
функция лишается возможности напрямую обращаться к неименованным значе¬ 
ниям. Решение этой проблемы предоставляет объект Агдитепііз. В теле функции 
идентификатор агдитепііз ссылается на объект Агдитепііз, присутствующий в вызо¬ 
ве. Объект Агдитепііз - это объект, подобный массиву (раздел 7.11), позволяющий 
извлекать переданные функции значения по их номерам, а не по именам. 

Предположим, что была определена функция Г, которая требует один аргумент, х. 
Если вызвать эту функцию с двумя аргументами, то первый будет доступен внут¬ 
ри функции по имени параметра х или как агдитеп1із[0]. Второй аргумент будет 
доступен только как агдитеп1із[1]. Кроме того, подобно настоящим массивам, агди¬ 
тепііз имеет свойство Іепдіііі, определяющее количество содержащихся элементов. 
То есть в теле функции Г, вызываемой с двумя аргументами, агдитепііз. ІепдІН име¬ 
ет значение 2. 

Объект Агдитепііз может использоваться с самыми разными целями. Следующий 
пример показывает, как с его помощью проверить, была ли функция вызвана 
с правильным числом аргументов, - ведь ЛаѵаЗсгірі этого за вас не сделает: 

^ііпсііоп ^(х, у, г) 

{ 

// Сначала проверяется, правильное ли количество аргументов передано 
Н (агдитепііз.ІепдІіП != 3) { 

{Игом пем Еггог("функция Т вызвана с " + агдитепііз. ІепдІіИ + 

"аргументами, а требуется 3."); 

} 

// А теперь сам код функции... 

} 

Обратите внимание, что зачастую нет необходимости проверять количество аргу¬ 
ментов, как в данном примере. Поведение по умолчанию интерпретатора Лаѵа- 
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Зсгірі отлично подходит для большинства случаев: отсутствующие аргументы 
замещаются значением ипсІеТіпесі, а лишние аргументы просто игнорируются. 

Объект Агдитепііз иллюстрирует важную возможность ЛѵаЗсгірі-функций: они 
могут быть написаны таким образом, чтобы работать с любым количеством аргу¬ 
ментов. Следующая функция принимает любое число аргументов и возвращает 
значение самого большого из них (аналогично ведет себя встроенная функция 
МаѣИ.тахО): 

^ипсіііоп тах(/*... */) 

{ 

ѵаг т = МитЬег. ЫЕОАТІѴЕ_ІЫРІЫІТУ ; 

// Цикл по всем аргументам, поиск и сохранение наибольшего из них 
І : ог(ѵаг і = 0; і < агдитепііз. ІепдІіП; і++) 

(агдіітеп1:5[і] > тах) тах = агдитеп1і5[і]; 

// Вернуть наибольшее значение 
геіюгп тах; 

} 

ѵаг Іагдезі: = тах(1, 10, 100, 2, 3, 1000, 4, 5, 10000, 6); // => 10000 

Функции, подобные этой и способные принимать произвольное число аргумен¬ 
тов, называются функциями с переменным числом аргументов (ѵагіайіс іипс- 
ііопз , ѵагіаЫе агііу / ипсііопз или ѵагагёз / ипсііопз ). Этот термин возник вместе 
с появлением языка программирования С. 

Обратите внимание, что функции с переменным числом аргументов не должны 
допускать возможность вызова с пустым списком аргументов. Будет вполне ра¬ 
зумным использовать объект агдитепІізП при написании функции, ожидающей 
получить фиксированное число обязательных именованных аргументов, за кото¬ 
рыми может следовать произвольное число необязательных неименованных ар¬ 
гументов. 

Не следует забывать, что агдитепііз фактически не является массивом - это объект 
Агдитепііз. В каждом объекте Агдитепііз имеются пронумерованные элементы мас¬ 
сива и свойство ІепдІіН, но с технической точки зрения это не массив. Лучше рас¬ 
сматривать его как объект, имеющий некоторые пронумерованные свойства. 
Подробнее об объектах, подобных массивам, рассказывается в разделе 7.11. 

У объекта Агдитепііз есть одна очень необычная особенность. Когда у функции 
имеются именованные параметры, элементы массива объекта Агдитепііз при вы¬ 
полнении в нестрогом режиме являются синонимами параметров, содержащих 
аргументы функции. Массив агдитепііз[] и имена параметров - это два разных 
средства обращения к одним и тем же переменным. Изменение значения аргу¬ 
мента через имя аргумента меняет значение, извлекаемое через массив агдитеп1із[ ]. 
Изменение значения аргумента через массив агдитеп1із[] меняет значение, извле¬ 
каемое по имени аргумента. Например: 

Гііпсіііоп Т(х) { 

сопзоіе. 1од(х); // Выведет начальное значение аргумента 

агдитеп1:з[0] = піііі; // При изменении элемента массива изменяется х! 
сопзоіе. 1од(х); // Теперь выведет "пиіі ' 

} 
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Определенно, это не совсем то поведение, которое можно было бы ожидать от на¬ 
стоящего массива. В этом случае агдитеп1і$[0] и х могли бы ссылаться на одно и то 
же значение, но изменение одной ссылки не должно оказывать влияния на другую* 

Эта особенность в поведении объекта Агдитепііз была ликвидирована в строгом ре¬ 
жиме, предусматриваемом стандартом ЕСМАЗсгірі 5. Кроме того, в строгом режи¬ 
ме имеется еще несколько отличий. В нестрогом режиме агдитепііз - это всего лишь 
обычный ^ѵаЗсгірі-идентификатор, а не зарезервированное слово. В строгом 
режиме не допускается использовать имя агдитепііз в качестве имени параметра 
или локальной переменной функции и отсутствует возможность присваивать 
значения элементам агдитепііз. 

8.З.2.1. Свойства саііее и саііег 

Помимо элементов своего массива объект Агдитепііз определяет свойства саііее 
и саііег. При попытке изменить значения этих свойств в строгом режиме ЕСМА- 
Зсгірі 5 гарантированно возбуждается исключение ТуреЕггог. Однако в нестрогом 
режиме стандарт ЕСМАЗсгірі утверждает, что свойство саііее ссылается на вы¬ 
полняемую в данный момент функцию. Свойство саііег не является стандарт¬ 
ным, но оно присутствует во многих реализациях и ссылается на функцию, вы¬ 
звавшую текущую. Свойство саііег можно использовать для доступа к стеку вы¬ 
зовов, а свойство саііее особенно удобно использовать для рекурсивного вызова 
неименованных функций: 

ѵаг ^асіогіаі = Гипс1;іоп( х) { 

ІГ (х <= 1) геііи гп 1; 

геіііігп х * агдитепііз.саііее(х-і); 

}; 

8.3.3. Использование свойств объекта 
в качестве аргументов 

Когда функция имеет более трех параметров, становится трудно запоминать пра¬ 
вильный порядок их следования. Чтобы предотвратить ошибки и избавить про¬ 
граммиста от необходимости заглядывать в документацию всякий раз, когда он 
намеревается вставить в программу вызов такой функции, можно предусмотреть 
возможность передачи аргументов в виде пар имя/значение в произвольном по¬ 
рядке. Чтобы реализовать такую возможность, при определении функции следу¬ 
ет предусмотреть передачу объекта в качестве единственного аргумента. Благо¬ 
даря такому стилю пользователи функции смогут передавать функции объект, 
в котором будут определяться необходимые пары имя/значение. В следующем 
фрагменте приводится пример такой функции, а также демонстрируется воз¬ 
можность определения значений по умолчанию для опущенных аргументов: 

// Скопировать ІепдІП элементов из массива Ітот в массив ѣо. 

// Копирование начинается с элемента Ггот_з1:аг1: в массиве Ітот 

// и выполняется в элементы, начиная с ±о_з±агі; в массиве Іо. 

// Запомнить порядок следования аргументов такой функции довольно сложно. 

^цпсіііоп аггаусору(/* массив */ Ітот, /* индекс */ 1гот_з1:агі;, 

/* массив */ Іо, /* индекс */ *о_зІагі, 

/* целое */ ІепдІП) 

{ 
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// здесь находится реализация функции 

} 

// Эта версия функции чуть менее эффективная, но не требует запоминать порядок следования* 
// аргументов, а аргументы Ггот_з1:агі: и То_зТаг1: по умолчанию принимают значение 0. 
^цпсіііоп еазусору(агдз) { 
аггаусору(агдз. Ітот, 

агдз. Ггот_зі:агі: || 0, // Обратите внимание, как назначаются 
агдз.{о, // значения по умолчанию 

агдз.То_зТагі: || 0, 
агдз. ІепдТМ); 

} 

// Далее следует пример вызова функции еазусору(): 

ѵаг а = [1,2, 3,4], Ь = []; 

еазусору({Ггогл: а, То: Ь, ІепдТіі: 4}); 

8.3.4. Типы аргументов 

В языке ЛѵаЗсгірі параметры функций объявляются без указания их типов, а во 
время передачи значений функциям не производится никакой проверки их ти¬ 
пов. Вы можете сделать свой программный код самодокументируемым, выбирая 
описательные имена для параметров функций и включая описание типов аргу¬ 
ментов в комментарии, как это сделано в только что рассмотренном примере 
функции аггаусору(). Для необязательных аргументов в комментарий можно до¬ 
бавлять слово «необязательный» («орііопаі»). А если функция может принимать 
произвольное число аргументов, можно использовать многоточие: 

Гііпсіііоп тах(/* число... */) { /* тело функции */ } 

Как отмечалось в разделе 3.8, при необходимости ЛѵаЗсгірі выполняет преобра¬ 
зование типов. Таким образом, если определить функцию, которая ожидает по¬ 
лучить строковый аргумент, а затем вызвать ее с аргументом какого-нибудь дру¬ 
гого типа, значение аргумента просто будет преобразовано в строку, когда функ¬ 
ция пытается обратиться к нему как к строке. В строку может быть преобразова¬ 
но любое простое значение, и все объекты имеют методы ІоЗігіпдО (правда, не 
всегда полезные); тем самым устраняется вероятность появления ошибки. 

Однако такой подход может использоваться не всегда. Вернемся к методу аггау- 
сору(), продемонстрированному выше. Он ожидает получить массив в первом ар¬ 
гументе. Любое обращение к функции окажется неудачным, если первым аргу¬ 
ментом будет не массив (или, возможно, объект, подобный массиву). Если функ¬ 
ция должна вызываться чаще, чем один-два раза, следует добавить в нее проверку 
соответствия типов аргументов. Гораздо лучше сразу же прервать вызов функции 
в случае передачи аргументов ошибочных типов, чем продолжать выполнение, 
которое потерпит неудачу с сообщением об ошибке, запутывающим ситуацию. 
Ниже приводится пример функции, выполняющей проверку типов. Обратите 
внимание, что она использует функцию ізАггауИкеО из раздела 7.11: 

// Возвращает сумму элементов массива (или объекта, подобного массиву) а. 

// Все элементы массива должны быть числовыми, при этом значения піііі 
// и цпбеГіпесІ игнорируются. 

^цпсіііоп 5цгл(а) { 

іГ (ізАггауИке(а)) { 
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ѵаг Іоіаі = 0; 

1ог(ѵаг і = 0; і < а.ІепдІН; і++) { // Цикл по всем элементам 
ѵаг еіетепі = а[і]; 

іі (еіетепі: == пціі) сопііпце; // Пропустить пціі и цпсіеііпесі 

іі (ізРіпііе(еІетепІ)) Іоіаі += еіетепі:; 

еізе ІНго ѵі пем Еггог("зііт(): все элементы должны быть числами"); 

} 

геіцгп Іоіаі; 

} 

еізе ІНго ѵі п еѵі Еггог("зііт(): аргумент должен быть массивом"); 

} 

Этот метод $ит() весьма строго относится к проверке типов входных аргументов 
и генерирует исключения с достаточно информативными сообщениями, если ти¬ 
пы входных аргументов не соответствуют ожидаемым. Тем не менее он остается 
достаточно гибким, обслуживая наряду с настоящими массивами объекты, по¬ 
добные массивам, и игнорируя элементы, имеющие значения пиіі и ипсіеГіпесі. 

ЛѵаЗсгірі - чрезвычайно гибкий и к тому же слабо типизированный язык, бла¬ 
годаря чему можно писать функции, которые достаточно терпимо относятся к ко¬ 
личеству и типам входных аргументов. Далее приводится метод ГІехзитО, реали¬ 
зующий такой подход (и, вероятно, являющийся примером другой крайности). 
Например, он принимает любое число входных аргументов и рекурсивно обраба¬ 
тывает те из них, которые являются массивами. Вследствие этого он может при¬ 
нимать переменное число аргументов или массив аргументов. Кроме того, он при¬ 
лагает максимум усилий, чтобы преобразовать нечисловые аргументы в числа, 
прежде чем сгенерировать исключение: 

Іцпсііоп Ііехізцт(а) { 
ѵаг іоіаі = 0; 

Гог(ѵаг і = 0; і < агдцтепіз. ІепдІН; і++) { 
ѵаг еіетепі = агдіітепІ5[і], п; 

іі (еіетепі == пціі) сопііпііе; // Игнорировать пьН и цпсіеііпесі 
іі (ізАггау(еІетепІ)) // Если аргумент - массив 

п = Иехізшп.арр1у(1Піз, еіетепі); // вычислить сумму рекурсивно 
еізе іі (Іуреоі еіетепі === "Іцпсііоп") // Иначе, если это функция... 

п = МцтЬег(е1етеп1()); // вызвать и преобразовать, 

еізе п = МцтЬег(еІетепІ); // Иначе попробовать преобразовать 

іі (із№М(п)) // Если не удалось преобразовать в число, возбудить искл. 

Ііігом Еггог("11ехізцт(): невозможно преобразовать " + еіетепі + 

в число"); 

Іоіаі += п; // Иначе прибавить п к Іоіаі 

} 

геііігп Іоіаі; 

} 

8.4. Функции как данные 

Самые важные особенности функций заключаются в том, что они могут опреде¬ 
ляться и вызываться. Определение и вызов функции - это синтаксические сред¬ 
ства ЛаѵаЗсгірі и большинства других языков программирования. Однако в Ла- 
ѵаЗсгірі функции - это не только синтаксические конструкции, но и данные, 
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а это означает, что они могут присваиваться переменным, храниться в свойствах 
объектов или элементах массивов, передаваться как аргументы функциями и т. д. 1 

Чтобы понять, как функции в ЛѵаЗсгірі могут быть одновременно синтаксиче¬ 
скими конструкциями и данными, рассмотрим следующее определение функции: 

^цпсіііоп здііаге(х) { геішгп х*х; } 

Это определение создает новый объект функции и присваивает его переменной 
зриаге. Имя функции действительно нематериально - это просто имя перемен¬ 
ной, которая ссылается на объект функции. Функция может быть присвоена дру¬ 
гой переменной, и при этом работать так же, как и раньше: 

ѵаг з = здиаге; // Теперь з ссылается на ту же функцию, что и здыаге 
5дцаге(4); // => 16 

5(4); // => 16 

Функции могут быть также присвоены не только глобальным переменным, но 
и свойствам объектов. В этом случае их называют методами: 

ѵаг о = {здцаге: ^ипс1:іоп(х) { геішгп х*х; }}; // Литерал объекта 
ѵаг у = о. здцаге(іб); // у = 256 

Функции могут быть даже безымянными, например, в случае присваивания их 
элементам массива: 

ѵаг а = [Тцпс^іоп(х) { геіюгп х*х; }, 20]; // Литерал объекта 

а[0](а[1]); // => 400 

Синтаксис вызова функции в последнем примере выглядит необычно, однако это 
вполне допустимый вариант применения выражения вызова! 

В примере 8.2 демонстрируется, что можно делать, когда функции выступают 
в качестве данных. Хотя пример может показаться вам несколько сложным, ком¬ 
ментарии объясняют, что происходит. 

Пример 8.2. Использование функций как данных 

// Определения нескольких простых функций 
^цпсіііоп асІсКх.у) { геішгп х + у; } 

^цпсіііоп зыМігасКх, у) { геТыгп х - у; } 

^цпсіііоп тиШр1у(х, у) { геітгп х * у; } 

^цпсііоп сЛѵіРе(х,у) { геітгп х / у; } 

// Эта функция принимает одну из предыдущих функций 
// в качестве аргумента и вызывает ее с двумя операндами 
^ьпсіііоп орега1:е(орега1:ог, орегапсіі, орегапс!2) 

{ 

геііи гп орегаііо г (орегапсіі , орегапР2); 

} 

// Так можно вызвать эту функцию для вычисления выражения (2+3)+(4*5): 
ѵаг і = орега1:е(ас1с1, орега1:е(ас1с1, 2, 3), орегаІ^ггшШрІу, 4, 5)); 


1 Это может показаться не столь интересным, если вы не знакомы с такими языками, 
как ^ѵа, в которых функции являются частью программы, но не могут управляться 
программой. 
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// Ради примера реализуем эти функции снова, на этот раз 
// с помощью литералов функций внутри литерала объекта, 
ѵаг орегаіогз = { 

асМ: ^цпсіііопСх, у) { геіііігп х+у; }, 

зііМігасІ:: Гцпс1:іоп(х, у) { геішгп х-у; }, 

тііШрІу: 1 : цпс1:іоп(х І у) { геіііігп х*у; }, 

сііѵісіе: Гипсііоп(х.у) { геітгп х/у; }, 

ром: Ма'Ытром // Можно использовать даже предопределенные функции 

}; 


// Эта функция принимает имя оператора, отыскивает оператор в объекте, 

// а затем вызывает его с указанными операндами. 

// Обратите внимание на синтаксис вызова функции оператора. 

Гііпсіііоп орега1:е2(орега1:іоп, орегапсЛ, орегапс!2) 

{ 

іГ (ІуреоГ орега1:огз[орега1:іоп] === "■РипсНоп") 

геішгп орега1:огз[орега1:іоп](орегапсЛ, орегапй2); 
еізе ХЬгоѵі "неизвестный оператор"; 

} 

// Вычислить значение ("Гіеііо" + " " + "могІсГ): 

ѵаг ] = орега1:е2("асісГ, "Иеііо", 0рега1:е2("асісГ, " ", "могісі")); 

// Использовать предопределенную функцию Маіііі.ром(): 
ѵаг к = орега1:е2("ро\л/", 10, 2); 

В качестве еще одного примера использования функций как значений рассмот¬ 
рим метод Аггау.зог1;(). Он сортирует элементы массива. Существует много воз¬ 
можных порядков сортировки (числовой, алфавитный, по датам, по возрастанию, 
по убыванию и т. д.), поэтому метод зогіО принимает в качестве необязательного 
аргумента функцию, которая сообщает о том, как выполнять сортировку. Эта 
функция делает простую работу: получает два значения, сравнивает их и возвра¬ 
щает результат, указывающий, какой из элементов должен быть первым. Этот ар¬ 
гумент-функция делает метод Аггау. зог1;() совершенно универсальным и бесконеч¬ 
но гибким - он может сортировать любой тип данных в любом мыслимом поряд¬ 
ке. Примеры использования функции Аггау. зогіО представлены в разделе 7.8.3. 

8.4.1. Определение собственных свойств функций 

Функции в языке ^ѵаЗсгірі являются не простыми значениями, а особой разно¬ 
видностью объектов, благодаря чему функции могут иметь свойства. Когда функ¬ 
ции требуется «статическая» переменная, значение которой должно сохраняться 
между ее вызовами, часто оказывается удобным использовать свойство объекта 
функции, позволяющее не занимать пространство имен определениями глобаль¬ 
ных переменных. Например, предположим, что надо написать функцию, возвра¬ 
щающую уникальное целое число при каждом своем вызове. Функция никогда 
не должна возвращать одно и то же значение дважды. Чтобы обеспечить это, 
функция должна запоминать последнее возвращенное значение и сохранять его 
между ее вызовами. Эту информацию можно было бы хранить в глобальной пере¬ 
менной, но это было бы нежелательно, потому что данная информация использу¬ 
ется только этой функцией. Лучше сохранять ее в свойстве объекта Рипсіііоп. Вот 
пример функции, которая возвращает уникальное целое значение при каждом 
вызове: 
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// Инициализировать свойство соцпііег объекта функции. Объявления функций 

// поднимаются вверх, поэтому мы можем выполнить это присваивание до объявления функции. 

цпідцеіпііедег. соцпііег = 0; 

// Эта функция возвращает разные целые числа при каждом вызове. 

// Для сохранения следующего возвращаемого значения она использует собственное свойство. 

^цпсіііоп цпідиеІп1:едег( ) { 

геіцгп цпідцеіпііедег.соипііег++; // Увеличить и вернуть свойство сошлет 

> 

Еще один пример, взгляните на следующую функцию ^асІогіаІО, которая ис¬ 
пользует собственные свойства (интерпретируя себя как массив) для сохранения 
результатов предыдущих вычислений: 

// Вычисляет факториалы и сохраняет результаты в собственных свойствах. 

^цпсіііоп ^ас*огіа1(п) { 

і? (ізРіпі1:е(п) && п>0 && п==Маі:М. гоцпсі(п)) { // Только конечные положительные целые 
(!(п іп ^асТогіаІ)) // Если не сохранялось ранее 

^асіогіа1[п] = п * ^асіогіаі(п-і); // Вычислить и сохранить 
геіцгп ^асТогіа1[п]; // Вернуть сохр. результат 

> 

еізе геіцгп №М; // Для ошибочного аргумента 

} 

^асіогіаЦ 1 ] = 1; // Инициализировать кэш базовым случаем. 

8.5. Функции как пространства имен 

В разделе 3.10.1 говорилось, что в языке ЛѵаВсгірі существует такое понятие, 
как область видимости функции: переменные, объявленные внутри функции, 
видимы в любой точке функции (включая и вложенные функции), но они сущест¬ 
вуют только в пределах функции. Переменные, объявленные за пределами функ¬ 
ции, являются глобальными переменными и видимы в любой точке ^ѵаВсгірі- 
программы. В языке ^ѵаВсгірі отсутствует возможность объявлять переменные, 
доступные только внутри отдельно расположенного блока программного кода, 
и по этой причине иногда бывает удобно определять функции, которые играют 
роль временного пространства имен, где можно объявлять переменные, не засо¬ 
ряя глобальное пространство имен. 

Предположим, например, что имеется модуль ^ѵаВсгірі, который можно исполь¬ 
зовать в различных ^ѵаВсгірі-программах (или, если говорить на языке клиент¬ 
ского ^ѵаВсгірі, в различных веб-страницах). Допустим, что в программном ко¬ 
де этого модуля, как в практически любом другом программном коде, объявля¬ 
ются переменные для хранения промежуточных результатов вычислений. Про¬ 
блема состоит в том, что модуль будет использоваться множеством различных 
программ, и поэтому заранее неизвестно, будут ли возникать конфликты между 
переменными, создаваемыми модулем, и переменными, используемыми в про¬ 
граммах, импортирующих этот модуль. Решение состоит в том, чтобы поместить 
программный код модуля в функцию и затем вызывать эту функцию. При таком 
подходе переменные модуля из глобальных превратятся в локальные переменные 
функции: 

^цпсііоп тутосМеО { 

// Здесь находится реализация модуля. 
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// Любые переменные, используемые модулем, превратятся в локальные 
// переменные этой функции и не будут засорять глобальное пространство имен. 

> 

тутосШеО; // Но не забудьте вызвать функцию! 

Данный программный код объявляет единственную глобальную переменную: 
имя функции «тутосіиіе». Если даже единственное имя это слишком много, мож¬ 
но определить и вызвать анонимную функцию в одном выражении: 

( І'ипсіііоп () { // функция тутосШе переписана как неименованное выражение 
// Здесь находится реализация модуля. 

}()); // конец литерала функции и ее вызов. 

Такой способ определения и вызова функции в одном выражении настолько часто 
используется в практике, что превратился в типичный прием. Обратите внимание 
на использование круглых скобок в этом примере. Открывающая скобка перед 
ключевым словом Гипсііоп является обязательной, потому что без нее ключевое 
слово Гипсііоп будет интерпретироваться как инструкция объявления функции. 
Скобки позволят интерпретатору распознать этот фрагмент как выражение опре¬ 
деления функции. Это обычный способ - заключение в скобки, даже когда они не 
требуются, определения функции, которая должна быть вызвана сразу же после 
ее определения. 

Практическое применение приема создания пространства имен демонстрируется 
в примере 8.3. Здесь определяется анонимная функция, возвращающая функцию 
ех1;епс1(), подобную той, что была представлена в примере 6.2. Анонимная функция 
проверяет наличие хорошо известной ошибки в Іпіегпеі Ехріогег и возвращает 
исправленную версию функции, если это необходимо. Помимо этого, анонимная 
функция играет роль пространства имен, скрывающего массив с именами свойств. 

Пример 8.3. Функция ехіепй( ), исправленная , если это необходимо 

// Определяет функцию ехіепсі, которая копирует свойства второго и последующих аргументов 
// в первый аргумент. Здесь реализован обход ошибки в ІЕ: во многих версиях ІЕ цикл •Гог/іп 
// не перечисляет перечислимые свойства объекта о, если одноименное свойство 
// его прототипа является неперечислимым. Это означает, что такие свойства, 

// как *о5*гіпд, обрабатываются некорректно, если явно не проверять их. 
ѵаг ехіепсі = (^цпсіііопС ) { // Присвоить значение, возвращаемое этой функцией 
// Сначала проверить наличие ошибки, прежде чем исправлять ее. 

^ог(ѵаг р іп {*о5*гіпд:піі11} ) { 

// Если мы оказались здесь, значит, цикл ^ог/іп работает корректно 
// и можно вернуть простую версию функции ехІепсіО 
ге^цгп ^цпсіііоп ех*епсІ(о) { 

І'огСѵаг і = 1; і < агдцтепіз. ІепдІП; і++) { 
ѵаг зоцгсе = агдитепі:з[і]; 

^ог(ѵаг ргор іп зоцгсе) о[ргор] = зоцгсе[ргор]; 

> 

геіцгп о; 

>; 

> 

// Если мы оказались здесь, следовательно, цикл Гог/іп не перечислил 

// свойство ІоЗігіпд тестового объекта. Поэтому необходимо вернуть версию ехІепсК), 

// которая явно проверяет неперечислимость свойств прототипа ОЬіесІ:.ргоіоіуре. 

// Список свойств, которые необходимо проверить 
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ѵаг ргоіоргорз = ["ІоЗігіпд", "ѵаІиеОГ', "сопз^гисЩг", "МазОѵу/пРгорегіу", 

"ізРгоІоІіуреОГ', "ргорегІуІзЕпитегаЫе", "1:о1.оса1еЗі:гіпд"]; 

геіцгп ^цпсііоп раісМесі_ех1:епсі(о) { 

І'огСѵаг і = 1; і < агдшпепіз. ІепдІР; і++) { 
ѵаг зоцгсе = агдитепі:з[і]; 

// Скопировать все перечислимые свойства 
^ог(ѵаг ргор іп зоигсе) о[ргор] = зоигсе[ргор]; 

// А теперь проверить специальные случаи свойств 
1"ог(ѵаг ^ = 0; ^ < ргоіоргорз.ІепдІМ; і++) { 
ргор = ргоІоргорзШ; 

і? (зоцгсе. йазОмпРгорегі:у(ргор)) о[ргор] = зоцгсе[ргор]; 

> 

> 

ге^цгп о; 

}; 

> 0 ); 

8.6. Замыкания 

Как и в большинстве языков программирования, в ЛѵаЗсгірі используются лек¬ 
сические области видимости . Это означает, что при выполнении функций дейст¬ 
вуют области видимости переменных, которые имелись на момент их определе¬ 
ния, а не на момент вызова. Для реализации лексической области видимости 
внутренняя информация о состоянии объекта функции в языке ЛѵаВсгірі долж¬ 
на включать не только программный код функции, но еще и ссылку на текущую 
цепочку областей видимости. (Прежде чем продолжить чтение этого раздела, 
вам, возможно, следует повторно прочитать сведения об областях видимости пе¬ 
ременных и цепочках областей видимости в разделах 3.10 и 3.10.3.) Такая комби¬ 
нация объекта функции и области видимости (множества связанных перемен¬ 
ных), в которой находятся переменные, используемые вызываемой функцией, 
в литературе по информационным технологиям называется замыканием } 

Технически все функции в языке ^ѵаЗсгірі образуют замыкания: они являются 
объектами и имеют ассоциированные с ними цепочки областей видимости. Боль¬ 
шинство функций вызываются внутри той же цепочки областей видимости, ко¬ 
торая действовала на момент определения функции, и в этой ситуации факт обра¬ 
зования замыкания не имеет никакого значения. Интересные особенности замы¬ 
каний начинают проявляться, когда их вызов производится в другой цепочке 
областей видимости, отличной от той, что действовала на момент определения. 
Чаще всего это происходит, когда объект вложенной функции возвращается 
функцией, вмещающей ее определение. Существует множество мощных приемов 
программирования, вовлекающих такого рода вложенные функции-замыкания, 
и их использование довольно широко распространено в программировании на 
языке ^ѵаЗсгірі. Замыкания могут выглядеть малопонятными при первом зна¬ 
комстве, однако вам необходимо хорошо понимать их, чтобы чувствовать себя 
уверенно при их использовании. 


1 Это старый термин, который отражает тот факт, что переменные функции привязаны 
к цепочке областей видимости, вследствие чего функция образует «замыкание» по сво¬ 
им переменным. 
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Первый шаг к пониманию замыканий - знакомство с правилами лексической об¬ 
ласти видимости, действующими для вложенных функций. Взгляните на сле¬ 
дующий пример (который напоминает пример в разделе 3.10): 

ѵаг зсоре = "дІоЬаІ зсоре”; // Глобальная переменная 

І'ипсііоп сМескзсореО { 

ѵаг зсоре = "Іосаі зсоре"; // Локальная переменная 

ГьпсИоп !=() { геііигп зсоре; } // Вернет значение локальной переменной зсоре 
геііігп ^(); 

> 

сЬескзсоре() // => "Іосаі зсоре" 


Реализация замыканий 

Понять суть замыканий будет совсем несложно, если усвоить правило лек¬ 
сической области видимости: во время выполнения функции используется 
цепочка областей видимости, которая действовала в момент ее определе¬ 
ния. Однако некоторые программисты испытывают сложности при освое¬ 
нии замыканий, потому что не до конца понимают особенности реализа¬ 
ции. Известно, думают они, что локальные переменные, объявленные во 
внешней функции, прекращают свое существование после выхода из внеш¬ 
ней функции, но тогда как вложенная функция может использовать цепоч¬ 
ку областей видимости, которая больше не существует? Если вы задавали 
себе такой вопрос, значит, у вас наверняка есть опыт работы с низкоуров¬ 
невыми языками программирования, такими как С, и аппаратными архи¬ 
тектурами, использующими стек: если локальные переменные размещать 
на стеке, они действительно прекращают свое существование после завер¬ 
шения функции. 

Но вспомните определение цепочки областей видимости из раздела 3.10.3. 
Там она описывалась как список объектов, а не стек. Каждый раз, когда 
интерпретатор ^ѵаВсгірі вызывает функцию, он создает новый объект для 
хранения локальных переменных этой функции, и этот объект добавляет¬ 
ся в цепочку областей видимости. Когда функция возвращает управление, 
этот объект удаляется из цепочки. Если в программе нет вложенных функ¬ 
ций и нет ссылок на этот объект, он будет утилизирован сборщиком мусо¬ 
ра. Если в программе имеются вложенные функции, тогда каждая из этих 
функций будет владеть ссылкой на свою цепочку областей видимости, а це¬ 
почка будет ссылаться на объекты с локальными переменными. Если объ¬ 
екты вложенных функций существуют только в пределах своих внешних 
функций, они сами будут утилизированы сборщиком мусора, а вместе 
с ними будут утилизированы и объекты с локальными переменными, на 
которые они ссылались. Но если функция определяет вложенную функ¬ 
цию и возвращает ее или сохраняет в свойстве какого-либо объекта, то об¬ 
разуется внешняя ссылка на вложенную функцию. Такой объект вложен¬ 
ной функции не будет утилизирован сборщиком мусора, и точно так же не 
будет утилизирован объект с локальными переменными, на который она 
ссылается. 
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Функция с!іескзсоре( ) объявляет локальную переменную и вызывает функцию, 
возвращающую значение этой переменной. Должно быть совершенно понятно, 
почему вызов сйескзсореО возвращает строку «Іосаі зсоре». Теперь немного изме* 
ним пример. Сможете ли вы сказать, какое значение вернет этот фрагмент? 

ѵаг зсоре = "дІоЬаІ зсоре"; // Глобальная переменная 

Гцпсііоп сМескзсореО { 

ѵаг зсоре = "Іосаі зсоре"; // Локальная переменная 

Гцпсііоп Г() { геіцгп зсоре; } // Вернет значение локальной переменной зсоре 
геіцгп Г; 

} 

сМескзсоре()() // Какое значение вернет этот вызов? 

В этой версии пара круглых скобок была перемещена из тела функции сРескзсоре() 
за ее пределы. Вместо вызова вложенной функции и возврата ее результата сГіеск- 
зсоре() теперь просто возвращает сам объект вложенной функции. Что произой¬ 
дет, если вызвать вложенную функцию (добавив вторую пару скобок в последней 
строке примера) из-за пределов функции, в которой она определена? 

Напомню главное правило лексической области видимости: при выполнении 
функции в языке ЛѵаВсгірі используется цепочка областей видимости, действо¬ 
вавшая на момент ее определения. Вложенная функция Г() была определена в це¬ 
почке видимости, где переменная зсоре связана со значением «Іосаі зсоре». Эта 
связь остается действовать и при выполнении функции Г, независимо от того, от¬ 
куда был произведен ее вызов. Поэтому последняя строка в примере выше вернет 
«Іосаі зсоре», а не «&1оЪа1 зсоре». Проще говоря, эта особенность является самой 
удивительной и мощной чертой замыканий: они сохраняют связь с локальными 
переменными (и параметрами) внешней функции, где они были определены. 

В разделе 8.4.1 был приведен пример функции ипідиеІпіедегО, в которой исполь¬ 
зуется свойство самой функции для сохранения следующего возвращаемого зна¬ 
чения. Недостаток такого решения состоит в том, что ошибочный или злонаме¬ 
ренный программный код может сбросить значение счетчика или записать в него 
нечисловое значение, вынудив функцию ипідиеІпіедег() нарушить обязательство 
возвращать «уникальное» или «целочисленное» значение. Замыкания запирают 
локальные переменные в объекте вызова функции и могут использовать эти пере¬ 
менные для хранения частной информации. Ниже показано, как можно реализо¬ 
вать функцию ипідиеІпІіедегО с использованием замыкания: 

ѵаг ііпідііеіпіедег = (Гііпс1:іоп( ) { // Определение и вызов 

ѵаг соііпіег = 0; // Частное значение для функции ниже 
геіцгп ГііпсІіопО { геііігп соіт1:ег++; }; 

}()); 

Внимательно изучите этот пример, чтобы понять, как он действует. На первый 
взгляд, первая строка выглядит как инструкция присваивания функции пере¬ 
менной ипідиеіпііедег. Фактически же это определение и вызов функции (как под¬ 
сказывает открывающая круглая скобка в первой строке), поэтому в действитель¬ 
ности переменной ипідиеіпііедег присваивается значение, возвращаемое функци¬ 
ей. Если теперь обратить внимание на тело функции, можно увидеть, что она воз¬ 
вращает другую функцию. Именно этот объект вложенной функции 
и присваивается переменной ипідиеіпііедег. Вложенная функция имеет доступ 
к переменным в ее области видимости и может использовать переменную соипііег, 



206 


Глава 8. Функции 


объявленную во внешней функции. После возврата из внешней функции ника¬ 
кой другой программный код не будет иметь доступа к переменной соипіег: вло¬ 
женная функция будет обладать исключительным правом доступа к ней. 

Скрытые переменные, такие как соипіег, не являются исключительной собствен¬ 
ностью единственного замыкания: в одной и той же внешней функции вполне 
возможно определить две или более вложенных функций, которые будут совме¬ 
стно использовать одну цепочку областей видимости. Рассмотрим следующий 
пример: 

*ііпс1:іоп соііпіегО { 
ѵаг п = 0; 
ге*цгп { 

соцп*: *ипс*іоп() { ге*цгп п++; }, 
тезе*: *ипс*іоп() { п = 0; } 

>; 

> 


ѵаг с = соітіегО, 

гі = соипІегО; // 

с.соцп1:() 

// 

СІ. соцп*() 

// 

с.гезе*() 

// 


// 

с.соцп*() 

// 

сі. соипі; () 

// 


Создать два счетчика 
=> 0 

=> 0: они действуют независимо 
методы тезе* () и соцпі:() совместно 
используют одну переменную 
=> 0: сброс счетчика с 
=> 1: не оказывает влияния на счетчик сі 


Функция соип1;ег() возвращает объект «счетчика». Этот объект имеет два метода: 
соипШ, возвращающий следующее целое число, и гезеШ, сбрасывающий счет¬ 
чик в начальное состояние. В первую очередь следует запомнить, что два метода 
совместно используют одну и ту же частную переменную п. Во-вторых, каждый 
вызов функции соипІегО создает новую цепочку областей видимости и новую 
скрытую переменную. То есть, если вызвать функцию соип1:ег() дважды, она вер¬ 
нет два объекта-счетчика с различными скрытыми переменными. Вызов методов 
соип1;() и гезе1:() одного объекта-счетчика не оказывает влияния на другой. 

Важно отметить, что описанный прием образования замыканий можно исполь¬ 
зовать в комбинации с приемом определения свойств с методами доступа. Сле¬ 
дующая версия функции соип1:ег() является вариацией примера, представленно¬ 
го в разделе 6.6, но здесь для хранения скрытой информации вместо обычного 
свойства объекта используются замыкания: 

Гііпсіііоп соііпі:ег(п) { // Аргумент п функции - скрытая переменная 
геіііігп { 

// Метод чтения свойства возвращает и увеличивает переменную счетчика, 
де* соцпі: () { геііігп п++; }, 

// Метод записи в свойство не позволяет уменьшать значение п 
зе* соцп1:(т) { 

і* (т >= п) п = т; 

еізе ІМгоѵу/ Еггог("значение счетчика нельзя уменьшить "); 

} 

}; 

> 

ѵаг с = соип*ег(1000); 

с.соіт* // => 1000 
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с.соцпі: // => 1001 

с.соцпі: = 2000 

с.соцпі: // => 2000 

с.соцпі: = 2000 // => Ошибка! 

Обратите внимание, что эта версия функции соипі:ег() не объявляет локальную 
переменную. Для сохранения информации она просто использует параметр п, 
доступный обоим методам доступа к свойству. Это позволяет программе, вызы¬ 
вающей соип1:ег(), определять начальное значение скрытой переменной. 

В примере 8.4 демонстрируется обобщение приема совместного использования 
скрытой информации в замыканиях. Этот пример определяет функцию асісіРгіѵа- 
ІеРгорегІуО, которая в свою очередь определяет скрытую переменную и две вло¬ 
женные функции для чтения и записи значения этой переменной. Она добавляет 
эти вложенные функции как методы указанного вами объекта: 

Пример 8.4 . Реализация методов доступа к частному свойству 
с использованием замыканий 

И Эта функция добавляет методы доступа к свойству с заданным именем объекта о. 

// Методы получают имена вида деКпате> и 5еІ<пате>. Если дополнительно предоставляется 
// функция проверки, метод записи будет использовать ее для проверки значения 
// перед сохранением. Если функция проверки возвращает ^аізе, 

// метод записи генерирует исключение. 

// 

// Необычность такого подхода заключается в том, что значение свойства, 

// доступного методам, сохраняется не в виде свойства объекта о, а в виде 
// локальной переменной этой функции. Кроме того, методы доступа также определяются 
// внутри этой функции и потому получают доступ к этой локальной переменной. 

// Это означает, что значение доступно только этим двум методам и не может быть 
// установлено или изменено иначе, как методом записи. 

^цпсііоп асІсІРгіѵаІеРгорегіуСо, пате, ргесіісаіе) { 
ѵаг ѵаіце; // Это значение свойства 

// Метод чтения просто возвращает значение. 
о[ "деі" + пате] = ?цпсІіоп() { геіцгп ѵаіце; }; 

// Метод записи сохраняет значение или возбуждает исключение, 

// если функция проверки отвергает это значение. 
о[ "зеі:" + пате] = ^цпсііопСѵ) { 

(ргебісаіе && ! ргес!іса1:е(ѵ)) 

ІМгоѵу/ ЕггогСзе!" + пате + недопустимое значение + ѵ); 

еізе 

ѵаіце = ѵ; 

>; 

> 

// Следующий фрагмент демонстрирует работу метода асІсІРгіѵаІеРгорегІуО. 
ѵаг о = {}; // Пустой объект 

// Добавить к свойству методы доступа с именами деІМатеО и зеІМатеО 
// Обеспечить допустимость только строковых значений 

асІсІРгіѵаІеРгорегІуСо, "Мате", ^цпс^іоп(х) { геіцгп Іуреоі" х == "зігіпд"; }); 

о. зеІМатеСТгапк"); // Установить значение свойства 

сопзоіе.1од(о.деІМатеС)); // Получить значение свойства 

о.зе1:Мате(0); // Попробовать установить значение свойства неверного типа 
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Мы увидели несколько примеров, когда замыкания определяются в одной и той 
же цепочке областей видимости и совместно используют одну локальную пере¬ 
менную или переменные. Важно знать и уметь пользоваться этим приемом, но но 
менее важно уметь распознавать ситуации, когда замыкания получают перемен¬ 
ную в совместное использование по ошибке. Рассмотрим следующий пример: 

// Эта функция возвращает функцию, которая всегда возвращает ѵ 

^цпсіііоп сопзІ^ипсСѵ) { ге^цгп ^цпсііопО { геііігп ѵ; }; } 

// Создать массив функций-констант: 

ѵаг ^цпсз = []; 

І'огСѵаг і = 0; і < 10; і++) Гцпсз[і] = сопзіГцпсСі); 

// Функция в элементе массива с индексом 5 возвращает 5. 

^цпсзЕбК) // => 5 

При создании подобного программного кода, который создает множество замы¬ 
каний в цикле, часто допускают ошибку, помещая цикл внутрь функции, кото¬ 
рая определяет замыкания. Например, взгляните на следующий фрагмент: 

// Возвращает массив функций, возвращающих значения 0-9 

Гцпсііоп сопз^цпсзС) { 
ѵаг ^ііпсз = []; 

Гог(ѵаг і = 0; і < 10; і++) 

^ьпсзСі] = ^цпсНопО { геіцгп і; }; 
геіцгп ^ьпсз; 

} 

ѵаг Гііпсз = сопз^цпсзС ); 

Гітсз[5]() // Что вернет этот вызов? 

Функция выше создает 10 замыканий и сохраняет их в массиве. Замыкания об¬ 
разуются в одном и том же вызове функции, поэтому все они получат доступ к пе¬ 
ременной і. Когда сопзІГііпсзО вернет управление, переменная і будет иметь зна¬ 
чение 10, и все 10 замыканий будут совместно использовать это значение. Таким 
образом, все функции в возвращаемом массиве будут возвращать одно и то же 
значение, что совсем не то, чего мы пытались добиться. Важно помнить, что це¬ 
почка областей видимости, связанная с замыканием, не фиксируется. Вложен¬ 
ные функции не создают частные копии области видимости и не фиксируют зна¬ 
чения переменных. 

Кроме того, при создании замыканий следует помнить, что Іііііз - это ключевое 
слово, а не переменная. Как отмечалось выше, каждый вызов функции получает 
свое значение іііііз, и замыкание не имеет доступа к значению ІІііз внешней функ¬ 
ции, если внешняя функция не сохранит его в переменной: 

ѵаг зеІГ = ІМіз; // Сохранить значение ІМіз в переменной для использования 

// во вложенной функции. 

То же относится и к объекту агдитепііз. Это не ключевое слово, но он автоматиче¬ 
ски создается при каждом вызове функции. Поскольку замыкания при вызове 
получают собственный объект агдитепііб, они не могут обращаться к массиву ар¬ 
гументов внешней функции, если внешняя функция не сохранит этот массив 
в переменной с другим именем: 

ѵаг оііІегАгдшпепІз = агдшпепіз; // Сохранить для использования во вложенных функциях 
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В примере 8.5, далее в этой главе, определяется замыкание, использующее эти 
приемы для получения доступа к значениям Ш$ и агдитепіз внешней функции. 

* 

8.7. Свойства и методы функций 
и конструктор Рипсііоп 

Мы видели, что в ЛѵаВсгірі-программах функции могут использоваться как зна¬ 
чения. Оператор ТуреоТ возвращает для функций строку «Ліпсііоп», однако в дей¬ 
ствительности функции в языке ^ѵаВсгірі - это особого рода объекты. А раз 
функции являются объектами, то они имеют свойства и методы, как любые дру¬ 
гие объекты. Существует даже конструктор РипсТіопО, который создает новые 
объекты функций. В следующих подразделах описываются свойства и методы 
функций, а также конструктор Рипс1:іоп( ). Кроме того, информация обо всем этом 
приводится в справочном разделе. 

8.7.1. Свойство ІепдіН 

В теле функции свойство агдитепііз.Іепдіііі определяет количество аргументов, пе¬ 
реданных функции. Однако свойство ІепдІіМ самой функции имеет иной смысл. 
Это свойство, доступное только для чтения, возвращает количество аргументов, 
которое функция ожидает получить, - число объявленных параметров. 

В следующем фрагменте определяется функция с именем сМеск(), получающая 
массив аргументов агдитепТз от другой функции. Она сравнивает свойство агди- 
тепІіБ.ІепдІіМ (число фактически переданных аргументов) со свойством агдитепііз. 
саііее. ІепдІіМ (число ожидаемых аргументов), чтобы определить, передано ли 
функции столько аргументов, сколько она ожидает. Если значения не совпадают, 
генерируется исключение. За функцией с!іеск( ) следует тестовая функция Т(), де¬ 
монстрирующая порядок использования функции сНеск(): 

// Эта функция использует агдшпепіз.саііее, поэтому она 
// не будет работать в строгом режиме, 
рцпсііоп сНеск(агдз) { 

ѵаг асіііаі = агдз. ІепдіН; // Фактическое число аргументов 

ѵаг ехресіесі = агдз. саііее.ІепдіН; // Ожидаемое число аргументов 
і? (асіііаі !== ехресіесі) // Если не совпадают, генерируется исключение 

{Игом пеѵѵ Еггог("ожидается: " + ехресіесі + получено " + асіііаі); 

} 

^цпсііоп Цх, у, г) { 

// Проверить число ожидаемых и фактически переданных аргументов. 
сНеск(агдіітеп1:5); 

// Теперь выполнить оставшуюся часть функции как обычно 
геііігп х + у + г\ 

) 

8.7.2. Свойство ргоіоіуре 

Любая функция имеет свойство ргоІюТуре, ссылающееся на объект, известный 
как объект прототипа . Каждая функция имеет свой объект прототипа. Когда 
функция используется в роли конструктора, вновь созданный объект наследует 
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свойства этого объекта прототипа. Прототипы и свойство ргоіоіуре обсуждались 
в разделе 6.1.3, и мы еще раз вернемся к этим понятиям в главе 9. 

8.7.3. Методы саІІ() и аррІу() 

Методы са11() и арр1у() позволяют выполнять косвенный вызов функции (раз¬ 
дел 8.2.4), как если бы она была методом некоторого другого объекта. (Мы уже ис¬ 
пользовали метод са11() в примере 6.4 для вызова 0Ь]ес1.рго1:о1:уре.1:о31:гіпд относи¬ 
тельно объекта, класс которого необходимо было определить.) Первым аргументом 
обоим методам, са11() и арр1у(), передается объект, относительно которого вызыва¬ 
ется функция; этот аргумент определяет контекст вызова и становится значением 
ключевого слова Ш$ в теле функции. Чтобы вызвать функцию Г() (без аргументов) 
как метод объекта о, можно использовать любой из методов, са11() или арр1у(): 

Г.саіі(о); 

Г. арріу(о) ; 

Любой из этих способов вызова эквивалентен следующему фрагменту (где пред¬ 
полагается, что объект о не имеет свойства с именем т): 

о.т = Г; // Временно сделать Г методом о. 
о.т(); // Вызывать его без аргументов, 

сіеіеіе о.т; // Удалить временный метод. 

В строгом режиме ЕСМАВсгірі 5 первый аргумент методов са11() и арр1у() стано¬ 
вится значением ІІііз, даже если это простое значение, пиіі или ипсіеГіпесі. В ЕСМА¬ 
Всгірі; 3 и в нестрогом режиме значения пиіі и ипсіеГіпесі замещаются глобальным 
объектом, а простое значение - соответствующим объектом-оберткой. 

Все остальные аргументы метода са11(), следующие за первым аргументом, опре¬ 
деляющим контекст вызова, передаются вызываемой функции. Например, ниже 
показано, как можно передать функции Г() два числа и вызвать ее, как если бы 
она была методом объекта о: 

1\са11(о, 1, 2); 

Метод арр1у() действует подобно методу са11(), за исключением того, что аргумен¬ 
ты для функции передаются в виде массива: 

Г.арр1у(о, [1.2]); 

Если функция способна обрабатывать произвольное число аргументов, метод 
арр1у() может использоваться для вызова такой функции в контексте массива 
произвольной длины. Например, чтобы отыскать наибольшее число в массиве чи¬ 
сел, для передачи элементов массива функции МаІІі.тахО можно было бы исполь¬ 
зовать метод арр1у(): 

ѵаг Ьіддезі: = МаІМ. тах.арр1у(МаИГ», аггау.оІ^піітЬегз); 

Обратите внимание, что метод арр1у() может работать не только с настоящими 
массивами, но и с объектами, подобными массивам. В частности, вы можете вы¬ 
звать функцию с теми же аргументами, что и текущую функцию, передав массив 
с аргументами непосредственно методу арр1у(). Этот прием демонстрируется ниже: 

// Замещает метод т объекта о версией метода, которая регистрирует 
// сообщения до и после вызова оригинального метода. 
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^цпсііоп ігасе(о, т) { 

ѵаг огідіпаі = о[т]; // Сохранить оригинальный метод в замыкании. 

о[т] = ^цпсііопО { // Определить новый метод. 

сопзоіе.1од(пеи Оаіе(), ‘ Еп1;егіпд:", ш); // Записать сообщение, 

ѵаг гезіЛі: = огідіпаі.арр1у(1:Иіз, агдшпепіз); // Вызвать оригинал, 
сопзоіе. 1од(пеѵѵ Оаіе(), "ЕхШпд:", т); // Записать сообщение, 

геіцгп гезіЛі; // Вернуть результат. 

>; 

> 

Эта функция 1гасе() принимает объект и имя метода. Она замещает указанный 
метод новым методом, который «обертывает» оригинальный метод дополнитель¬ 
ной функциональностью. Такой прием динамического изменения существую¬ 
щих методов иногда называется «обезьяньей заплатой» («шопкеу-раісЬіп^»). 

8.7.4. Метод Ьіпсі() 

Метод ЬіпсК ) впервые появился в ЕСМА8сгірі 5, но его легко имитировать в ЕСМА- 
8сгірі 3. Как следует из его имени, основное назначение метода Ьіпсі () состоит 
в том, чтобы связать (Ьіпсі) функцию с объектом. Если вызвать метод ЬіпсК ) функ¬ 
ции Т и передать ему объект о, он вернет новую функцию. Вызов новой функции 
(как обычной функции) выполнит вызов оригинальной функции Т как метода объ¬ 
екта о. Любые аргументы, переданные новой функции, будут переданы оригиналь¬ 
ной функции. Например: 

^цпсііоп ?(у) { геіцгп іЬіз.х + у; } // Функция, которую требуется привязать 
ѵаг о = { х : 1 }; // Объект, к которому выполняется привязка 

ѵаг д = М)іпсі(о); // Вызов д(х) вызовет о.ІЧх) 

9(2) // => 3 

Такой способ связывания легко реализовать в ЕСМАЗсгірі 3, как показано ниже: 

// Возвращает функцию, которая вызывает Т как метод объекта о 
// и передает ей все свои аргументы. 

^цпсііоп ЬіпсК о) { 

іТ (I 1 . Ьіпсі) геіцгп ГЬіпгі(о); // Использовать метод Ьіпсі, если имеется 

еізе геіцгп ^цпсііопО { // Иначе связать, как показано ниже 

геіцгп Гарр1у(о, агдшпепіз); 

}; 

> 

Метод Ьіпс1() в ЕСМА8сгірі 5 не просто связывает функцию с объектом. Он также 
выполняет частичное применение: помимо значения 1Ы§ связаны будут все аргу¬ 
менты, переданные методу ЬіпсК) после первого его аргумента. Частичное приме¬ 
нение - распространенный прием в функциональном программировании и ино¬ 
гда называется каррингом ( сиггуіпд ). Ниже приводится несколько примеров ис¬ 
пользования метода ЬіпсК ) для частичного применения: 

ѵаг зцш = ^цпсііопСх, у) { геіцгп х + у }; // Возвращает сумму 2 аргументов 

// Создать новую функцию, подобную зцт, но со связанным значением піііі 
// ключевого слова іЬіз и со связанным значением первого аргумента, равным 1. 

// Новая функция принимает всего один аргумент, 
ѵаг зцсс = зцт. Ьіпс1(пціі , 1); 

зцсс(2) // => 3: аргумент х связан со значением 1, а 2 передается в арг. у 




212 


Глава 8. Функции 


іцпсііоп Г(у.г) { геіцгп {Ыз.х + у + г }; // Еще одна функция сложения 

ѵаг д = Г.Ыпс1({х:1}, 2); // Связать іНіз и у 

9(3) // => 6: Шз.х - связан с 1, у - связан с 2, а 3 передается в г 

В ЕСМАВсгірі 3 также возможно связывать значение ІіЬіз и выполнять частичное 
применение. Стандартный метод ЬіпсК) можно имитировать программным ко¬ 
дом, который приводится в примере 8.5. Обратите внимание, что этот метод со¬ 
храняется как ЕипсІіоп.ргоІоІіуре.ЬіпЬ, благодаря чему все функции наследуют 
его. Данный прием подробно рассматривается в разделе 9.4. 

Пример 8.5. Метод Рипсііоп.Ыпд( ) для ЕСМАВсгірі 3 

іГ (! Рцпсііоп. ргоіоіуре. Ьіпсі) { 

Рцпсііоп.ргоіоіуре.Ыпсі = Гипс1:іоп(о /*, аргументы */) { 

// Сохранить іНіз и агдшпеп1:5 в переменных, чтобы их можно было 
// использовать во вложенной функции ниже, 
ѵаг зеІГ = 1;Г»із , ЬоцпсІАгдз = агдцтепі:з; 

// Возвращаемое значение метода Ыпс1() - функция 
геіцгп РцпсііопО { 

// Сконструировать список аргументов, начиная со второго аргумента 
// метода Ыпсі, и передать все эти аргументы указанной функции, 
ѵаг агдз = [], і; 

Гог(і = 1; і < ЬоцпсІАгдз.ІепдііИ; і++) агдз.рцзЬ(Ьоцпс1Агдз[і]); 

Гог(і = 0; і < агдцтеп1:з.ІепдііЬ; і++) агдз.рцзІі(агдитеп1:з[і]); 

// Теперь вызвать зеІГ как метод объекта о со всеми аргументами 
геіцгп зе1Г.арр1у(о, агдз); 

>; 

>; 

> 

Обратите внимание, что функция, возвращаемая этим методом ЬіпсК), является 
замыканием, использующим переменные зеІГ и ЬоипЬАгдз, объявленные во внеш¬ 
ней функции, которые остаются доступными вложенной функции даже после то¬ 
го, как она будет возвращена внешней функцией и вызвана из-за пределов внеш¬ 
ней функции. 

Метод ЬіпсК), определяемый стандартом ЕСМАВсгірі 5, имеет некоторые особен¬ 
ности, которые невозможно реализовать в ЕСМАВсгірі 3. Прежде всего, настоя¬ 
щий метод Ыпс1() возвращает объект функции, свойство ІепдіЬ которой установ¬ 
лено в соответствии с количеством параметров связываемой функции, минус ко¬ 
личество связанных аргументов (но не меньше нуля). Во-вторых, метод ЬіпсК) 
в ЕСМАВсгірі 5 может использоваться для частичного применения функций-кон¬ 
структоров. Если функцию, возвращаемую методом ЬіпсК ), использовать как кон¬ 
структор, значение іЬіз, переданное методу ЬіпсК ), игнорируется, и оригинальная 
функция будет вызвана как конструктор, с уже связанными аргументами, если 
они были определены. Функции, возвращаемые методом ЬіпсК ), не имеют свойст¬ 
ва ргоіоіуре (свойство ргоіоіуре обычных функций нельзя удалить), и объекты, 
созданные связанными функциями-конструкторами, наследуют свойство ргоіо- 
іуре оригинального, несвязанного конструктора. Кроме того, с точки зрения опе¬ 
ратора іпзіапсеоі связанные конструкторы действуют точно так же, как несвя¬ 
занные конструкторы. 
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8.7.5. Метод Іо$йгіпд() 

Подобно другим объектам в языке ЛѵаВсгірі, функции имеют метод 1о5і:гіпд()« 
Спецификация ЕСМАЗсгірі требует, чтобы этот метод возвращал строку, сле¬ 
дующую синтаксису инструкции объявления функции. На практике большинст¬ 
во (но не все) реализаций метода *о8*гіпд() возвращают полный исходный текст 
функции. Для встроенных функций обычно возвращается строка, содержащая 
вместо тела функции текст «[паііѵе сосіе]» или аналогичный. 

8.7.6. Конструктор РипсІіоп() 

Функции обычно определяются с помощью ключевого слова РыпсИоп либо в фор¬ 
ме инструкции объявления функции, либо в форме выражения-литерала. Одна¬ 
ко функции могут также определяться с помощью конструктора Рыпс1:іоп(). На¬ 
пример: 

ѵаг Т = пей Рьпс1:іоп("х", "у", "геііігп х*у;"); 

Эта строка создаст новую функцию, которая более или менее эквивалентна функ¬ 
ции, объявленной с помощью более привычного синтаксиса: 

ѵаг Т = ^ипс!іоп(х, у) { ге*игп х*у; } 

Конструктор РыпсІіопО принимает произвольное число строковых аргументов. 
Последний аргумент должен содержать текст с телом функции; он может вклю¬ 
чать произвольное число инструкций на языке ЛѵаВсгірі, разделенных точкой 
с запятой. Все остальные аргументы конструктора интерпретируются как имена 
параметров функции. Чтобы создать функцию, не имеющую аргументов, доста¬ 
точно передать конструктору всего одну строку - тело функции. 

Примечательно, что конструктору РыпсІіопО не передается никаких аргументов, 
определяющих имя создаваемой функции. Подобно литералам функций, конст¬ 
руктор Рипс1іоп() создает анонимные функции. 

Есть несколько моментов, связанных с конструктором Рипс1іоп(), о которых сле¬ 
дует упомянуть особо: 

• Конструктор Рипс1:іоп() позволяет динамически создавать и компилировать 
функции в процессе выполнения программы. 

• При каждом вызове конструктор Рипс*іоп() выполняет синтаксический ана¬ 
лиз тела функции и создает новый объект функции. Если вызов конструктора 
производится в теле цикла или часто вызываемой функции, это может отри¬ 
цательно сказаться на производительности программы. Напротив, вложен¬ 
ные функции и выражения определения функций внутри циклов не компили¬ 
руются повторно. 

• И последний, очень важный момент: когда функция создается с помощью кон¬ 
структора РипсІіопО, не учитывается лексическая область видимости - функ¬ 
ции всегда компилируются как глобальные функции, что наглядно демонст¬ 
рирует следующий фрагмент: 

ѵаг зсоре = "глобальная"; 

Рипсііоп соп5*гис1Рипс1:іоп() { 
ѵаг зсоре = "локальная"; 
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ге^цгп пей Рцпс1:іоп("ге1:игп зсоре”); // Здесь не используется 

// локальная область видимости! 

) • 

// Следующая строка вернет "глобальная", потому что функция, возвращаемая 
// конструктором РцпсІіопО, является глобальной, 
сопз! гис1:Рипс1;іоп()(); // => "глобальная" 

Точнее всего конструктор Рипс1іоп() соответствует глобальной версии еѵа1() (раз¬ 
дел 4.12.2), которая определяет новые переменные и функции в своей собствен¬ 
ной области видимости. Вам редко придется использовать этот конструктор в сво¬ 
их программах. 

8.7.7. Вызываемые объекты 

В разделе 7.11 мы узнали, что существуют объекты, «подобные массивам», кото¬ 
рые не являются настоящими массивами, но во многих случаях могут интерпре¬ 
тироваться как массивы. Аналогичная ситуация складывается с функциями. 
Вызываемый объект - это любой объект, который может быть вызван в выраже¬ 
нии вызова функции. Все функции являются вызываемыми объектами, но не все 
вызываемые объекты являются функциями. 

Вызываемые объекты, не являющиеся функциями, встречаются в современных 
реализациях ЛѵаВсгірі в двух ситуациях. Во-первых, веб-броузер ІБ (версии 8 
и ниже) реализует клиентские методы, такие как МіпсІом.аІегЬО и ОоситепІ.деІіЕІе- 
тепІзВуІсІО, используя вызываемые объекты, а не объекты класса РипсИоп. Эти 
методы действуют в ІЕ точно так же, как в других броузерах, но они не являются 
объектами Рипсіііоп. В ІЕ9 был выполнен переход на использование настоящих 
функций, поэтому со временем эта разновидность вызываемых объектов будет 
использоваться все меньше и меньше. 

Другой типичной разновидностью вызываемых объектов являются объекты 
ПедЕхр - во многих броузерах предоставляется возможность напрямую вызы¬ 
вать объект ПедЕхр, как более краткий способ вызова его метода ехес(). Эта воз¬ 
можность не предусматривается стандартом ЛѵаЗсгірі. В свое время она была 
реализована компанией Кеізсаре и подхвачена другими производителями для 
обеспечения совместимости. Старайтесь не писать программы, опирающиеся на 
возможность вызова объектов ПедЕхр: данная особенность, скорее всего, будет 
объявлена нерекомендуемой и будет ликвидирована в будущем. Оператор ІіуреоГ 
не во всех броузерах одинаково распознает вызываемые объекты ПедЕхр. В одних 
броузерах он возвращает строку «ілтсііоп», а в других - «оЬіесі». 

Если в программе потребуется определить, является ли объект настоящим объек¬ 
том функции (и обладает методами функций), сделать это можно, определив зна¬ 
чение атрибута сіазз (раздел 6.8.2), использовав прием, продемонстрированный 
в примере 6.4: 

РьпсИоп ізРцпс1:іоп(х) { 

ге^ьгп ОЬ^есІ;.ргоІсЦуре.*о8*гіпд.саіі(х) === "[оЬ^ес* Рцпсііоп]"; 

} 

Обратите внимание, насколько эта функция ізРипсІіопО похожа на функцию 
ізАггауО, представленную в разделе 7.10. 
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8.8. Функциональное программирование 

ЛѵаВсгірі не является языком функционального программирования, как Ывр 
или Навкеіі, но тот факт, что программы на языке ЛѵаЗсгірі могут манипулиро¬ 
вать функциями как объектами означает, что в ЛаѵаЗсгірі можно использовать 
приемы функционального программирования. Масса методов в БСМАЗсгірі 5, 
таких как тар() и гесіисе(), сами по себе способствуют использованию функцио¬ 
нального стиля программирования. В следующих разделах демонстрируются 
приемы функционального программирования на языке ЛѵаВсгірі. Их цель - не 
подтолкнуть вас к использованию этого замечательного стиля программирова¬ 
ния, а показать широту возможностей функций в языке ЛѵаВсгірі. 1 

8.8.1. Обработка массивов с помощью функций 

Представим, что у нас имеется массив чисел и нам необходимо найти среднее зна¬ 
чение и стандартное отклонение для этих значений. Эту задачу можно было бы 
решить без использования приемов функционального программирования, как 
показано ниже: 

ѵаг Ра1:а = [1.1,3.5,5]; // Массив чисел 

// Среднее - это сумма значений элементов, деленная на их количество 
ѵаг *о*а1 = 0; 

1 : ог(ѵаг і = 0; і < сіаіа. 1епді:Іі; і++) Іоіаі += йа*а[і]; 
ѵаг теап = *оі:а1/0а1:а. ІепдііИ; // Среднее значение равно 3 

// Чтобы найти стандартное отклонение, необходимо вычислить сумму квадратов 
// отклонений элементов от среднего. 

Іо*а1 = 0; 

І'огСѵаг і = 0; і < с!а1:а. ІепдіМ; і++) { 
ѵаг с!еѵіаі:іоп = с!а1:а[і] - теап; 

Іоіаі += с)еѵіа1:іоп * сіеѵіаііоп; 

} 

ѵаг 5І:с1с1еѵ = Ма1;И.здгі;(1о1;а1/(сіаіа. 1епді:Іі-1)); // Стандартное отклонение = 2 

Те же вычисления можно выполнить в более кратком функциональном стиле, за¬ 
действовав методы массивов тар() и гесіисе(), как показано ниже (краткое описа¬ 
ние этих методов приводится в разделе 7.9): 

// Для начала необходимо определить две простые функции 
ѵаг зьт = ^цпсііопСх, у) { геііігп х+у; }; 
ѵаг здцаге = ^ипс1:іоп(х) { ге^цгп х*х; }; 

// Затем использовать их совместно с методами класса Аггау для вычисления 

// среднего и стандартного отклонения 

ѵаг Ра1:а = [1,1.3,5.5]; 

ѵаг теап = с!а1:а. гес!исе( зит)/с!а1:а . ІепдІіМ; 

ѵаг сіеѵіаіііопз = Ра1:а.тар(1 : ипс1:іоп(х) {ге^цгп х-теап;}); 

ѵаг зіісісіеѵ = МаІИ. здг1:(с1еѵіа1:іопз. тар(здиаге). гес!исе(зит)/(сіаіа. 1епд1;И-1)); 


1 Если эта тема вам любопытна, вероятно, вас заинтересует возможность использования 
(или хотя бы знакомства) библиотеки Гипсііопаі ^ѵаЗсгірі Оливера Стила (Оііѵег 81е- 
еі), которую можно найти по адресу: Мір://о8ІееІе.сот/8оигсе8/іаѵа8Сгірі/{ипсІіопаІ/. 
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Л как быть, если в нашем распоряжении имеется только реализация ЕСМА- 
Всгірі 3, где отсутствуют эти новейшие методы массивов? Можно определить соб¬ 
ственные функции тар() и гейысеС), которые будут использовать встроенные мето* 
ды при их наличии: 

// Вызывает функцию Г для каждого элемента массива и возвращает массив результатов. 

// Использует метод Аггау.ргоТоТуре.тар, если он определен, 
ѵаг тар = Аггау. ргоіоіуре. тар 

? Гцпс1:іоп(а, Т) { геТьгп а.тар(Г); } // Если метод тар() доступен 
: Гітс1:іоп(а, Г) { // Иначе реализовать свою версию 

ѵаг гезьііз = []; 

І'огСѵаг і = 0, Іеп = а.ІепдіН; і < Іеп; і++) { 

іГ (і іп а) гезьНзШ = Г.са11(піЛ1, а[і], і, а); 

> 

ге^ьгп гезцііз; 

>; 


// Выполняет свертку массива в единственное значение, используя функцию Т 

// и необязательное начальное значение. Использует метод Аггау. ргоіоіуре. гебьсв. 

// если он определен. 

ѵаг гесіисе = Аггау. ргоіоіуре. герцсе 

? ГипсСіопСа, Г, іпШаІ) { // Если метод гес!исе() доступен. 

іГ (агдьтетз. ІепдіН > 2) 

геіьгп а.герцсе^, іпШаІ); // Если указано начальное значение, 
еізе ге^ьгп а. гесіисе (О; // Иначе без начального значения. 

> 


ГцпсІіопСа, Г, іпіііаі) { // Этот алгоритм взят из спецификации Е35 

ѵаг і = 0, Іеп = а.ІепдІИ, ассцтиіаіог; 


// Использовать указанное начальное значение или первый элемент а 
іТ (агдитепіз.ІепдіН > 2) асситиіаіог = іпШаІ; 
еізе { // Найти первый элемент массива с определенным значением 
іГ (Іеп == 0) ІНгои ТуреЕггог(); 
ѵѵНі1е(і < Іеп) { 
іГ (і іп а) { 

асситиіаіог = а[і++]; 

Ьгеак; 

> 

еізе і++; 

> 

іГ (і == Іеп) ХЪгоѵі ТуреЕггог(); 

> 

// Теперь вызвать Т для каждого оставшегося элемента массива 
ѵѵНі1е(і < Іеп) { 
іГ (і іп а) 

ассштшіаіог = ^.саЩьпсІеІчпесІ, асситьШог, а[і], і, а); 
і++; 


геіигп асситиіаіог; 

}; 

После определения этих функций тар() и гес!исе() вычисление среднего и стан¬ 
дартного отклонения будет выглядеть так: 
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ѵаг баіа = [1,1,3.5,5]; 

ѵаг зілп = Гцпс1:іоп(х,у) { геГигп х+у; }; 

ѵаг здьаге = *Гипсі:іоп(х) { геііігп х*х; }; 

ѵаг теап = гебисе(с1а1:а, зит)/да1:а. ІепдГН; 

ѵаг деѵіаііопз = тарСбаГа, Гьпс1:іоп(х) {геГцгп х-теап;}); 

ѵаг зісісіеѵ = МаІИ.8дгі:(гес!исе(тар(с1еѵіа1:іопз, здиаге), зит)/(сіаіа. 1епді;И-1)); 

8.8.2. Функции высшего порядка 

Функции высшего порядка - это функции, которые оперируют функциями, при¬ 
нимая одну или более функций и возвращая новую функцию. Например: 

// Эта функция высшего порядка возвращает новую функцию, которая передает свои аргументы 
// функции Г и возвращает логическое отрицание значения, возвращаемого функцией Г; 
ГипсГіоп поГ(Г) { 

геГьгп ГьпсПопО { // Возвращает новую функцию 

ѵаг гезьИ: = Г.аррІуСГМз, агдцтепГз); // вызов Г 
геГигп ! гезиіі:; // и инверсия результата. 

>; 

> 

ѵаг еѵеп = Гцпс1:іоп(х) { // Функция, определяющая четность числа 
ге^ьт х % 2 === 0; 

>; 


ѵаг осісі = по!(еѵеп); // Новая функция, выполняющая противоположную операцию 

[1,1.3,5,5].еѵегу(осШ); // => Ггье: все элементы массива нечетные 

Функция по1( ) в примере выше является функцией высшего порядка, потому что 
она принимает функцию в виде аргумента и возвращает новую функцию. В каче¬ 
стве еще одного примера рассмотрим функцию таррег(), представленную ниже. 
Она принимает функцию в виде аргумента и возвращает новую функцию, кото¬ 
рая отображает один массив в другой, применяя указанную функцию. Данная 
функция использует функцию тар(), которая была определена выше, и важно по¬ 
нимать, чем отличаются эти две функции: 

// Возвращает функцию, которая принимает массив в виде аргумента, применяет функцию Г 
// к каждому элементу и возвращает массив возвращаемых значений. 

// Эта функция отличается от функции шар(), представленной выше. 

ГьпсИоп шаррег(Г) { 

ге^ьт ГьпсИопСа) { геіьгп тар(а, Г); }; 

} 

ѵаг іпсгетепі: = ГьпсИопСх) { геіьгп х+1; }; 
ѵаг іпсгетепіег = таррег( іпсгетепі:); 
іпсгетеп1:ег([1,2,3]) // => [2,3,4] 

Ниже приводится пример еще одной, более универсальной функции, которая 
принимает две функции, Т и д, и возвращает новую функцию, которая возвраща¬ 
ет результат 1"(д()): 

// Возвращает новую функцию, которая вычисляет Г(д(...)). Возвращаемая функция М 
// передает все свои аргументы функции д, затем передает значение, полученное от д, 

// функции Т и возвращает результат вызова Г. Обе функции, Гид, 

// вызываются с тем же значением ГИіз, что и П. 

ГьпсГіоп сотрозе(Г.д) { 
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геіцгп ^цпсііопО { 

// Для вызова Г используется саіі, потому что ей передается 
// единственное значение, а для вызова д используется арріу, 

// потому что ей передается массив значений, 
геіигп Г.саЩіНіз, д.арр1у(ІіИіз. агдцтепіз)); 

>; 

> 

ѵаг здцаге = ^цпсііопСх) { геіигп х*х; }; 
ѵаг зілп = ГипсІіопСх,у) { геіцгп х+у; }; 
ѵаг здцагео^зип = сотрозе(здиаге, зит); 
здиагео1 : зит(2,3) // => 25 

Функции рагІіаІО и тетоііеО, которые определяются в следующем разделе, 
представляют собой еще две важные функции высшего порядка. 

8.8.3. Частичное применение функций 

Метод ЬіпсК) функции Г (раздел 8.7.4) возвращает новую функцию, которая вызы¬ 
вает Г в указанном контексте и с заданным набором аргументов. Можно сказать, 
что он связывает функцию с объектом контекста и частично применяет аргументы. 
Метод ЫпсІ() применяет аргументы слева, т.е. аргументы, которые передаются ме¬ 
тоду Ыпс)(), помещаются в начало списка аргументов, передаваемых оригинальной 
функции. Однако есть возможность частичного применения аргументов справа: 

// Вспомогательная функция преобразования объекта (или его части), 

// подобного массиву, в настоящий массив. Используется ниже 
// для преобразования объекта агдитеп1:з в настоящий массив. 

Гипсііоп аггау(а, п) { геіигп Аггау. ргоіоіуре.зіісе. са11(а, п || 0); } 

// Аргументы этой функции помещаются в начало списка 
^ипсііоп рагІіаНеГКІ 1 /*, ...*/) { 

ѵаг агдз = агдитепіз; // Сохранить внешний массив аргументов 

геіцгп ГцпсііопО { // И вернуть эту функцию 

ѵаг а = аггау(агдз, 1); // Начиная с элемента 1 во внеш. масс, 

а = а.сопса1:(аггау(агдитеп1:з)); // Добавить внутренний массив аргум. 
геіцгп Г.арр1у(1:Ыз, а); // Вызвать Г с этим списком аргументов 

>; 

> 

// Аргументы этой функции помещаются 
^цпсііоп рагЕіаІВідМКІ 1 /*, ...*/) { 
ѵаг агдз = агдитеп1:з; 
геіигп ГцпсііопО { 

ѵаг а = аггау(агдитеп1:з); 
а = а.сопсаі:(аггау(агдз, 1)); 
геіигп 1\аррІуСіЫз, а); 

>; 

> 

// Аргументы этой функции играют роль шаблона. Неопределенные значения 
// в списке аргументов заполняются значениями из внутреннего набора. 

І^псілоп рагЕіаІСІ 1 /*, ... */) { 

ѵаг агдз = агдцтепііз; // Сохранить внешний массив аргументов 

геіигп І'ипсііопО { 

ѵаг а = аггау(агдз, 1); 


в конец списка 

// Сохранить внешний массив аргументов 
// И вернуть эту функцию 
// Начинать с внутр. масс, аргументов 
// Добавить внешние арг., начиная с 1. 
// Вызвать { с этим списком аргументов 


// Начинать с внешнего массива аргументов 
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ѵаг і=0, з=0; 

// Цикл по этим аргументам, заменить значения ьпсІеГіпесІ значениями 

// из внутреннего списка аргументов * 

1Ч)г(; і < а.іепдій; і++) 

ІГ (а[і] === ітсіе^іпесі) а[і] = агдшпеп1:5[]++]; 

// Добавить оставшиеся внутренние аргументы в конец списка 
а = а.сопса1(аггау(агдитеп1:5, з)) 
геіцгп 1\ арр1у(1Ніз, а); 

>; 

> 

// Ниже приводится функция, принимающая три аргумента 
ѵаг Г = Гипс1:іоп(х,у, 2 ) { геіигп х * (у - 2 ); }; 

// Обратите внимание на отличия между следующими тремя частичными применениями 
раПіаНеМ:^, 2)(3,4) // => -2: Свяжет первый аргумент: 2 * (3 - 4) 

рагііаІВідНК^, 2)(3,4) // => 6: Свяжет последний аргумент: 3 * (4 - 2) 

рагі:іа1(Г, ьпсіе^іпесі, 2)(3,4) // => -6: Свяжет средний аргумент: 3 * (2 - 4) 

Эти функции частичного применения позволяют легко объявлять новые функ¬ 
ции на основе уже имеющихся функций. Например: 

ѵаг іпсгетепі: = рагііаІІ-еГКзит, 1); 
ѵаг сиЬегооі = рагііа1ВідН1(МаіІі. ром, 1/3); 

Зігіпд.ргоіоіуре.Нгзі = рагі:іа1(81:гіпд.рго1:о1:уре.сИагАІ:, 0); 

Зігіпд.ргоіоіуре.іазі: = рагіііаі(81:гіпд.ргоііоііуре.зиЬзііг, -1, 1); 

Прием частичного применения становится еще более интересным, когда он ис¬ 
пользуется в комбинации с функциями высшего порядка. Например, ниже демон¬ 
стрируется еще один способ определения функции поі( ), представленной выше, за 
счет совместного использования приемов композиции и частичного применения: 

ѵаг поі = рагііаНеМСсотрозе, І'ипсііоп(х) { ге^ьт !х; }); 

ѵаг еѵеп = ^цпсііоп(х) { ге^ьгп х % 2 === 0; }; 

ѵаг осісі = поі(еѵеп); 

ѵаг іеМьтЬег = по1(із№М) 

Прием композиции и частичного применения можно также использовать для вы¬ 
числения среднего значения и стандартного отклонения в крайне функциональ¬ 
ном стиле: 

ѵаг сіаіа = [1,1.3,5,5]; // Исходные данные 

ѵаг зііт = ^ііпсііопСх, у) { геііігп х+у; }; // Две элементарные функции 

ѵаг ргосіисі: = ^ипсііоп(х.у) { геіигп х*у; }; 

ѵаг пед = рагііаі(ргосіисі:, -1); // Определения других функций 

ѵаг зциаге = рагііаі(МаіИ. ром, цпйе^іпей, 2); 

ѵаг зцгі: = рагііаІСМаІІі. ром, ипсІеНпесІ, .5); 

ѵаг гесіргосаі = рагііаІСМаІИ.роѵѵ, цпйе^іпей, -1); 

// Вычислить среднее и стандартное отклонение. Далее используются только функции 
// без каких либо операторов, отчего программный код начинает напоминать 
// программный код на языке І_ізр! 

ѵаг теап = ргойисК гес!исе(с1а1:а, зит), гесіргосаі(сіаіа.ІепдіН)); 
ѵаг зісісіеѵ = зцгі:(ргосіисі(гес!исе(тар(сіа1:а, 

сотрозе(здиаге, 

рагііаІСзит, пед(теап)))), 

зьт), 

гесіргосаі (зитСсІаіа. ІепдіМ, -1)))); 
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8.8.4. Мемоизация 

В разделе 8.4.1 была определена функция нахождения факториала, которая со* 
храняет ранее вычисленные результаты. В функциональном программировании 
такого рода кэширование называется мемоизацией (тетогігаііоп). В следующем 
примере демонстрируется функция тетоігеО высшего порядка, которая прини¬ 
мает функцию в виде аргумента и возвращает ее мемоизованную версию: 

// Возвращает мемоизованную версию функции Т. Работает, только если все возможные 
// аргументы Т имеют отличающиеся строковые представления. 

^цпсііоп тетоі 2 е (0 { 

ѵаг сасНе = {}; // Кэш значений сохраняется в замыкании, 
геіцгп 1=ипс1;іоп () { 

// Создать строковую версию массива агдцтеп1:з для использования 
// в качестве ключа кэша. 

ѵаг кеу = агдцтепііз. ІепдііИ + Аггау.рго1:о1:уре. ;іоіп. саЩагдитепІз, ","); 

іТ (кеу іп сасііе) ге1:игп сасНе[кеу]; 

еізе геіцгп сасМе[кеу] = I 1 .арр1у(1:Ыз, агдцтеп1:з); 

>; 

} 

Функция тетоігеО создает новый объект для использования в качестве кэша 
и присваивает его локальной переменной, благодаря чему он остается доступным 
(через замыкание) только для возвращаемой функции. Возвращаемая функция 
преобразует свой массив агдитепііз в строку и использует ее как имя свойства объ- 
екта-кэша. Если значение присутствует в кэше, оно просто возвращается в каче¬ 
стве результата. В противном случае вызывается оригинальная функция, вычис¬ 
ляющая значение для заданной комбинации значений аргументов; полученное 
значение помещается в кэш и возвращается. Следующий фрагмент демонстриру¬ 
ет, как можно использовать функцию тетоігеО: 

// Возвращает наибольший общий делитель двух целых чисел, используя 
// алгоритм Эвклида: Ітііір ://еп. ѵѵікіресііа .о гд/ѵѵікі/Еис1іс!еап_а1догі1:Ітт 
^псііоп дссКа.Ь) { // Проверка типов а и Ь опущена 

ѵаг 1:; // Временная переменная для обмена 

іТ (а < Ь) *=Ь, Ь=а, а=1:; // Убедиться, что а >= Ь 

\л/Мі1е(Ь != 0) 1=Ь, Ь = а%Ь, а=*; // Это алгоритм Эвклида поиска НОД 
ге1:игп а: 

} 

ѵаг дссітето = тетоіге(дссі); 
дсс!тето(85, 187) // => 17 

// Обратите внимание, что при мемоизации рекурсивных функций желательно, 

// чтобы рекурсия выполнялась в мемоизованной версии, а не в оригинале, 
ѵаг Тасіогіаі = тетоігеСІ'ипсІіопСп) { 

геіцгп (п <= 1) ? 1 : п * ^ас*огіа1(п-1); 

>); 

ТасІогіа1(5) // => 120. Также поместит в кэш факториалы для чисел 4, 3, 2 и 1. 




Классы и модули 


Введение в ЛѵаЗсгірі-объекты было дано в главе 6, где каждый объект трактовал¬ 
ся как уникальный набор свойств, отличающих его от любых других объектов. 
Однако часто бывает полезнее определить класс объектов, обладающих общими 
свойствами. Члены, или экземпляры,, класса обладают собственными свойства¬ 
ми, определяющими их состояние, но они также обладают свойствами (обычно 
методами), определяющими их поведение. Эти особенности поведения определя¬ 
ются классом и являются общими для всех экземпляров. Например, можно объ¬ 
явить класс Сотріех для представления комплексных чисел и выполнения ариф¬ 
метических операций с ними. Экземпляр класса Сотріех мог бы обладать свойст¬ 
вами для хранения действительной и мнимой частей комплексного числа. А класс 
Сотріех мог бы определять методы, выполняющие операции сложения и умноже¬ 
ния (поведение) этих чисел. 

Классы в языке ЛѵаЗсгірі основаны на использовании механизма наследования 
прототипов. Если два объекта наследуют свойства от одного и того же объекта- 
прототипа, говорят, что они принадлежат одному классу. С прототипами и насле¬ 
дованием мы познакомились в разделах 6.1.3 и 6.2.2. Сведения из этих разделов 
вам обязательно потребуются для понимания того, о чем рассказывается в этой 
главе. В этой главе прототипы будут рассматриваться в разделе 9.1. 

Если два объекта наследуют один и тот же прототип, обычно (но не обязательно) 
это означает, что они были созданы и инициализированы с помощью одного кон¬ 
структора. С конструкторами мы познакомились в разделах 4.6, 6.1.2 и 8.2.3. До¬ 
полнительные сведения о них в этой главе приводятся в разделе 9.2. 

Те, кто знаком со строго типизированными объектно-ориентированными языка¬ 
ми программирования, такими как Лѵа или С++, могут заметить, что классы 
в языке ЛѵаЗсгірі совершенно не похожи на классы в этих языках. Конечно, есть 
некоторые синтаксические сходства, и имеется возможность имитировать многие 
особенности «классических» классов в ЛѵаЗсгірі. Но лучше будет с самого начала 
понять, что классы и механизм наследования на основе прототипов в языке Лѵа- 
Зсгірі существенно отличаются от классов и механизма наследования на основе 
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классов в языке Лѵа и подобных ему. В разделе 9.3 демонстрируются приемы 
имитации классических классов на языке ЛѵаЗсгірі. 

Еще одной важной особенностью классов в языке ЛѵаЗсгірі является возмож* 
ность динамического расширения. Эта особенность описывается в разделе 9.4. 
Классы можно также интерпретировать как типы данных, и в разделе 9.5 будет 
представлено несколько способов определения класса объекта. В этом разделе вы 
также познакомитесь с философией программирования, известной как «утиная 
типизация» («< 1 ііск-іуріп 2 »), которая во главу угла ставит не тип объекта, а его 
возможности. 

После знакомства со всеми этими основами объектно-ориентированного програм¬ 
мирования в ЛѵаЗсгірі мы перейдем в этой же главе к изучению более практиче¬ 
ского материала. В разделе 9.6 будут представлены два примера непростых клас¬ 
сов и продемонстрировано несколько практических объектно-ориентированных 
приемов расширения этих классов. В разделе 9.7 будет показано (на множестве 
примеров), как расширять или наследовать другие классы и как создавать иерар¬ 
хии классов в языке ЛѵаЗсгірі. В разделе 9.8 рассматриваются дополнительные 
приемы работы с классами с использованием новых возможностей, появившихся 
в ЕСМАЗсгірі 5. 

Определение классов - это один из способов создания модульного программного 
кода многократного использования. В последнем разделе этой главы мы в общих 
чертах поговорим о модулях в языке ЛѵаЗсгірі. 

9.1. Классы и прототипы 

В языке ЛѵаЗсгірі класс - это множество объектов, наследующих свойства от об¬ 
щего объекта-прототипа. Таким образом, объект-прототип является центральной 
особенностью класса. В примере 6.1 была определена функция іпІпегі1:(), возвра¬ 
щающая вновь созданный объект, наследующий указанный объект-прототип. 
Если определить объект-прототип и затем воспользоваться функцией іп1легіи() 
для создания объектов, наследующих его, фактически будет создан класс Лѵа- 
Зсгірі. Обычно экземпляры класса требуют дополнительной инициализации, по¬ 
этому обычно определяется функция, которая создает и инициализирует новые 
объекты. В примере 9.1 демонстрируется такая функция: она определяет объект- 
прототип класса, представляющего диапазон значений, а также «фабричную» 
функцию, которая создает и инициализирует новые экземпляры класса. 

Пример 9.1. Простой класс ^ ѵаЗсгірі 

// гапде.із: Класс, представляющий диапазон значений. 

// Это фабричная функция, которая возвращает новый объект гапде. 

І'ипсііоп гапде(1тот, Іо) { 

// Использует функцию іпІіегііО для создания объекта, наследующего объект-прототип, 
// определяемый ниже. Объект-прототип хранится как свойство данной функции 
// и определяет общие методы (поведение) для всех объектов гапде. 
ѵаг г = іпІіегі1:( гапде. теІИосІз); 

// Сохранить начальное и конечное значения в новом объекте гапде. 

// Это не унаследованные свойства, и они являются уникальными для данного объекта, 
г. -Ггот = Ігот; 
г. Іо = Іо; 
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// В заключение вернуть новый объект 
геіцгп г; 


// Ниже следует объект-прототип, определяющий методы, наследуемые всеми объектами гапде. 
гапде. теІИосІз = { 

// Возвращает ігію, если х - объект класса гапде, в противном случае возвращает Гаізе 
// Этот метод может работать не только с числовыми диапазонами, 

// но также с текстовыми диапазонами и с диапазонами дат Эаіе. 
іпсіисіез : Гцпс1:іоп(х) { геіцгп ІИіз.Ггот <= х && х <= ІНіз.Іо; }, 

// Вызывает Г для каждого целого числа в диапазоне. 

// Этот метод может работать только с числовыми диапазонами. 

Гогеасй: ?цпсиоп(П { 

Гог(ѵаг х = МаІИ.сеі1(1;Иіз.І'гот); х <= ІНіз.Іо; х++) Г(х); 


}, 

// Возвращает строковое представление диапазона 

ІоЗігіпд: Гцпс1:іоп() { геіцгп "(" + ІНіз.Ггот + + ІНіз.Іо + 


}; 


// Ниже приводится пример использования объекта гапде. 

ѵаг г = гапде(І.З); // Создать новый объект гапде 

г. іпс1цс)ез(2); // => Ігце: число 2 входит в диапазон 

г. Гогеасй(сопзо1е.Іод); // Выведет 1 2 3 

сопзоіе.1од(г); // Выведет (1...3) 


} 


В примере 9.1 есть несколько интересных моментов, которые следует отметить 
особо. Здесь определяется фабричная функция гапде(), которая используется для 
создания новых объектов гапде. Обратите внимание, что для хранения объекта- 
прототипа, определяющего класс, используется свойство гапде. теііі'іосіз функции 
гапде(). В таком способе хранения объекта-прототипа нет ничего необычного. Во- 
вторых, отметьте, что функция гапде() определяет свойства Ітот и {о для каждого 
объекта гапде. Эти не общие, не унаследованные свойства определяют уникаль¬ 
ную информацию для каждого отдельного объекта гапде. Наконец, обратите вни¬ 
мание, что все общие, унаследованные методы, определяемые свойством гапде. 
теііі'іосіз, используют свойства Ітот и *о и ссылаются на них с помощью ключевого 
слова Іііііз, указывающего на объект, относительно которого вызываются эти ме¬ 
тоды. Такой способ использования Іііііз является фундаментальной характери¬ 
стикой методов любого класса. 


9.2. Классы и конструкторы 

В примере 9.1 демонстрируется один из способов определения класса в языке Л- 
ѵаВсгірі. Однако это не самый типичный способ, потому что он не связан с оп¬ 
ределением конструктора. Конструктор - это функция, предназначенная для 
инициализации вновь созданных объектов. Как описывалось в разделе 8.2.3, кон¬ 
структоры вызываются с помощью ключевого слова пем. Применение ключевого 
слова п ем при вызове конструктора автоматически создает новый объект, поэтому 
конструктору остается только инициализировать свойства этого нового объекта. 
Важной особенностью вызова конструктора является использование свойства 
ргоіоіуре конструктора в качестве прототипа нового объекта. Это означает, что 
все объекты, созданные с помощью одного конструктора, наследуют один и тот 
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же объект-прототип и, соответственно, являются членами одного и того же клас¬ 
са. В примере 9.2 демонстрируется, как можно было бы реализовать класс гапде, 
представленный в примере 9.1, не с помощью фабричной функции, а с помощью 
функции конструктора: 

Пример 9.2. Реализация класса Яап§е с помощью конструктора 

// гапде2.^з: Еще один класс, представляющий диапазон значений. 

// Это функция-конструктор, которая инициализирует новые объекты Вапде. 

// Обратите внимание, что она не создает и не возвращает объект. 

// Она лишь инициализирует его. 

Іцпсііоп Вапде(1гот, іо) { 

// Сохранить начальное и конечное значения в новом объекте гапде. 

// Это не унаследованные свойства, и они являются уникальными для данного объекта. 
ІПіз.Ігогп = Ігот; 

ІПіз.Ю = Іо; 

} 

// Все объекты Вапде наследуют свойства этого объекта. 

// Обратите внимание, что свойство обязательно должно иметь имя ''ргоіоіуре". 

Вапде.ргоіоіуре = { 

// Возвращает ігие, если х - объект класса гапде, в противном случае возвращает Іаізе 
// Этот метод может работать не только с числовыми диапазонами, но также 
// с текстовыми диапазонами и с диапазонами дат Эаіе. 
іпсіцсіез: Іцпсііоп(х) { геіцгп ІПіз.Ігот <= х && х <= ІИіз.Іо; }, 

// Вызывает I для каждого целого числа в диапазоне. 

// Этот метод может работать только с числовыми диапазонами. 

ІогеасП: ІцпсІіопСП { 

Іог(ѵаг х = МаіІі.сеЩіПіз.Ігогп); х <= ІИіз.Іо; х++) 1(х); 

}, 

// Возвращает строковое представление диапазона 

ІоЗІгіпд: ІцпсІіопО { геіцгп "(" + ІПіз.Ігот + "..." + ІПіз.Іо + } 

}; 


// Ниже приводится пример использования объекта гапде. 

ѵаг г = пем Вапде(І.З); // Создать новый объект гапде 

г. іпс1цс)ез(2); // => Ігце: число 2 входит в диапазон 

г.ІогеасН(сопзо1е.Іод); // Выведет 1 2 3 

сопзоіе.1од(г); // Выведет (1...3) 


Имеет смысл детально сравнить примеры 9.1 и 9.2 и отметить различия между 
этими двумя способами определения классов. Во-первых, обратите внимание, 
что при преобразовании в конструктор фабричная функция гапде() была пере¬ 
именована в Папде(). Это обычное соглашение по оформлению: функции-конст¬ 
рукторы в некотором смысле определяют классы, а имена классов начинаются 
с заглавных символов. Имена обычных функций и методов начинаются со строч¬ 
ных символов. 

Далее отметьте, что конструктор Вапде() вызывается (в конце примера) с ключе¬ 
вым словом пем, тогда как фабричная функция гапде() вызывается без него. В при¬ 
мере 9.1 для создания нового объекта использовался вызов обычной функции 
(раздел 8.2.1), а в примере 9.2 - вызов конструктора (раздел 8.2.3). Поскольку 
конструктор Рапде() вызывается с ключевым словом пе\л/, отпадает необходимость 
вызывать функцию Іп1пегі1:() или предпринимать какие-либо другие действия по 
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созданию нового объекта. Новый объект создается автоматически перед вызовом 
конструктора и доступен в конструкторе как значение ■Шз. Конструктору Рапде() 
остается лишь инициализировать его. Конструкторы даже не должны возврат 
щать вновь созданный объект. Выражение вызова конструктора автоматически 
создает новый объект, вызывает конструктор как метод этого объекта и возвра¬ 
щает объект. Тот факт, что вызов конструктора настолько отличается от вызова 
обычной функции, является еще одной причиной, почему конструкторам приня¬ 
то давать имена, начинающиеся с заглавного символа. Конструкторы предназна¬ 
чены для вызова в виде конструкторов, с ключевым словом пем, и обычно при вы¬ 
зове в виде обычных функций они не способны корректно выполнять свою рабо¬ 
ту. Соглашение по именованию конструкторов, обеспечивающее визуальное от¬ 
личие имен конструкторов от имен обычных функций, помогает программистам 
не забывать использовать ключевое слово п еѵі. 

Еще одно важное отличие между примерами 9.1 и 9.2 заключается в способе име¬ 
нования объекта-прототипа. В первом примере прототипом было свойство гапде. 
теііі'іосіз. Это было удобное, описательное имя, но в значительной мере произволь¬ 
ное. Во втором примере прототипом является свойство Рапде.ргоііоііуре, и это имя 
является обязательным. Выражение вызова конструктора Рапде() автоматически 
использует свойство Рапде.ргоііоііуре как прототип нового объекта Рапде. 

Наконец, обратите также внимание на одинаковые фрагменты примеров 9.1 
и 9.2: в обоих классах методы объекта гапде определяются и вызываются одина¬ 
ковым способом. 

9.2.1. Конструкторы и идентификация класса 

Как видите, объект-прототип играет чрезвычайно важную роль в идентифика¬ 
ции класса: два объекта являются экземплярами одного класса, только если они 
наследуют один и тот же объект-прототип. Функция-конструктор, инициализи¬ 
рующая свойства нового объекта, не является определяющей: два конструктора 
могут иметь свойства ргоііоііуре, ссылающиеся на один объект-прототип. В этом 
случае оба конструктора будут создавать экземпляры одного и того же класса. 

Хотя конструкторы не играют такую же важную роль в идентификации класса, 
как прототипы, тем не менее конструкторы выступают в качестве фасада класса. 
Например, имя конструктора обычно используется в качестве имени класса. Так, 
принято говорить, что конструктор Рапде() создает объекты класса Рапде. Однако 
более важным применением конструкторов является их использование в опера¬ 
торе іпзііапсеоі" при проверке принадлежности объекта классу. Если имеется объ¬ 
ект г, и необходимо проверить, является ли он объектом класса Рапде, такую про¬ 
верку можно выполнить так: 

г іпзІіапсеоГ Рапде // вернет Ігііе, если г наследует Рапде. ргоіоіуре 

В действительности оператор іпзііапсеоі" не проверяет, был ли объект г инициали¬ 
зирован конструктором Рапде. Он проверяет, наследует ли этот объект свойство 
Рапде. ргоНоНуре. Как бы то ни было, синтаксис оператора іпзііапсеоі" закрепляет ис¬ 
пользование конструкторов в качестве идентификаторов классов. Мы еще встре¬ 
тимся с оператором іпзііапсеоі" далее в этой главе. 
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9.2.2. Свойство сопбігисіог 

В примере 9.2 свойству Рапде.ргоііоііуре присваивался новый объект, содержащий 
методы класса. Хотя было удобно определить методы как свойства единственного 
объекта-литерала, но при этом совершенно не было необходимости создавать но¬ 
вый объект. Роль конструктора в языке ЛѵаЗсгірі может играть любая функция, 
поскольку выражению вызова конструктора необходимо лишь свойство р гоноііуре. 
Следовательно, любая функция (кроме функций, возвращаемых методом Рипс- 
Ііоп.ЬіпРО в ЕСМАЗсгірІ 5) автоматически получает свойство ргоноііуре. Значени¬ 
ем этого свойства является объект, который имеет единственное неперечислимое 
свойство сопзіігисііог. Значением свойства сопзіігисііог является объект функции: 

ѵаг Р = ГипсІіопО {}; // Это объект функции. 

ѵаг р = Р. ргоііоііуре; // Это объект-прототип, связанный с ней. 

ѵаг с = р. сопзігіюіог; // Это функция, связанная с прототипом. 

с === Р // => 1;гие: Р. ргоіоіуре.сопзігіюіог === Р для всех функций 

Наличие предопределенного объекта-прототипа со свойством сопзіігисііог означа¬ 
ет, что объекты обычно наследуют свойство сопзіігисііог, которое ссылается на их 
конструкторы. Поскольку конструкторы играют роль идентификаторов классов, 
свойство сопзіігисііог определяет класс объекта: 

ѵаг о = пем Р(); // Создать объект класса Р 

о. сопзіігисііог === Р // => ігие: свойство сопзіігисііог определяет класс 

Эти взаимосвязи между функцией-конструктором, ее прототипом, обратной ссыл¬ 
кой из прототипа на конструктор и экземплярами, созданными с помощью кон¬ 
структора, иллюстрируются на рис. 9.1. 


Конструктор Прототип Экземпляры 



Рис. 9.1. Функция-конструктор , ее прототип и экземпляры 


Обратите внимание, что в качестве примера для рис. 9.1 был взят наш конструк¬ 
тор Рапде( ). Однако в действительности класс Рапде, определенный в примере 9.2, 
замещает предопределенный объект Рапде.ргоііоііуре своим собственным. А новый 
объект-прототип не имеет свойства сопзіігисііог. По этой причине экземпляры 
класса Рапде, как следует из определения, не имеют свойства сопзіігисііог. Решить 
эту проблему можно, явно добавив конструктор в прототип: 

Рапде. ргоіоііуре = { 

сопзіігисііог: Рапде, // Явно установить обратную ссылку на конструктор 
іпсіисіез: Гипсіііоп(х) { геііигп ІіІііз.Ггот <= х && х <= ІИіз.Ііо; }, 

ГогеасИ: ГипсІііоп(Г) { 

Гог(ѵаг х = МаІИ. сеЩИйз. Ггот); х <= Шз. Іо; х++) Г(х); 

}, 
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ІоЗігіпд: і^псііопО { геіьгп "(" + ТІііз.'Ггот + “..." + *Ьіз.*о + } 

>; 

Другой типичный способ заключается в том, чтобы использовать предопределен¬ 
ный объект-прототип, который уже имеет свойство сопзіігисііог, и добавлять мето¬ 
ды в него: 

// Здесь расширяется предопределенный объект Рапде. ргоіоіуре, 

// поэтому не требуется переопределять значение автоматически 
// создаваемого свойства Рапде. ргоіоіуре.сопзігіісіог. 

Рапде. ргоІоТуре. іпсіьсіез = і'ипсІіопСх) { геіигп ІПіз. ітот<=х && х<=ІИіз. Іо; }; 

Рапде.ргоіоіуре.і'огеасй = ТипсТіоп(Т) { 

іч)г(ѵаг х = Маій. сеЩіНіз. Ігот); х <= ІПіз.Іо; х++) Т(х); 

}; 

Рапде.ргоіоіуре.ТоЗТгіпд = ^ьпсТіопО { 
геТьт "Г + Ійіз.ітот + + ІПіз.Іо + 

}; 

9.3. Классы в стиле іаѵа 

Если вам приходилось программировать на языке Лѵа или других объектно-ори¬ 
ентированных языках со строгим контролем типов, вы, возможно, привыкли 
считать, что классы могут иметь четыре типа членов: 

Поля экземпляра 

Это свойства, или переменные экземпляра, хранящие информацию о кон¬ 
кретном объекте. 

Методы экземпляров 

Методы, общие для всех экземпляров класса, которые вызываются относи¬ 
тельно конкретного объекта. 

Поля класса 

Это свойства, или переменные, всего класса в целом, а не конкретного экземп¬ 
ляра. 

Методы класса 

Методы всего класса в целом, а не конкретного экземпляра. 

Одна из особенностей языка ЛѵаЗсгірі, отличающая его от языка Лѵа, состоит 
в том, что функции в ЛѵаЗсгірі являются значениями, и поэтому нет четкой гра¬ 
ницы между методами и полями. Если значением свойства является функция, 
это свойство определяется как метод. В противном случае это обычное свойство, 
или «поле». Но, несмотря на эти отличия, имеется возможность имитировать все 
четыре категории членов классов в языке ЛаѵаВсгірі. Определение любого класса 
в языке ЛѵаЗсгірі вовлекает три различных объекта (рис. 9.1), а свойства этих 
трех объектов действуют подобно различным категориям членов класса: 

Объект-конструктор 

Как уже было отмечено, функция-конструктор (объект) в языке ЛѵаЗсгірІ оп¬ 
ределяет имя класса. Свойства, добавляемые в этот объект конструктора, иг¬ 
рают роль полей класса и методов класса (в зависимости от того, является ли 
значение свойства функцией или нет). 
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Объект-прототип 

Свойства этого объекта наследуются всеми экземплярами класса, при этом 
свойства, значениями которых являются функции, играют роль методов э К 1 
земпляра класса. 

Объект экземпляра 

Каждый экземпляр класса - это самостоятельный объект, а свойства, опреде¬ 
ляемые непосредственно в экземпляре, не являются общими для других эк¬ 
земпляров. Свойства экземпляра, которые не являются функциями, играют 
роль полей экземпляра класса. 

Процесс определения класса в языке ЛѵаЗсгірі можно свести к трем этапам. Во- 
первых, написать функцию-конструктор, которая будет определять свойства эк¬ 
земпляра в новом объекте. Во-вторых, определить методы экземпляров в объек¬ 
те-прототипе конструктора. В-третьих, определить поля класса и свойства клас¬ 
са в самом конструкторе. Этот алгоритм можно упростить еще больше, определив 
простую функцию сІеГіпеС1азз(). (В ней используется функция ехІепсІО из приме¬ 
ра 6.2 с исправлениями из примера 8.3): 

// Простая функция для определения простых классов 

Гцпсііоп сІе^іпеСІаззСсопзІгисІог, // Функция, определяющая свойства экземпляра 

те1:Нос)з, // Методы экземпляров: копируются в прототип 
зіаіісз) // Свойства класса: копируются в конструктор 

{ 

іГ (теііюсіз) ехІіепсКсопзІгисІог. ргоіоііуре, теІНосІз); 
іГ (зіаіісз) ехіепсКсопзІгисІог, зіаіісз): 
геіигп сопзігіюіог; 

} 

// Простейший вариант нашего класса Напде 
ѵаг ЗітрІеНапде = 

сІеІ'іпеСІазз^ипсиоп^,*) { ІГііз. Г = Г; Шз.І = I; }, 

{ 

іпсіисіез: Гцпсііоп(х) { геЩгп ІИіз. Г<=х && х <= ІПіз.І:}, 

Іо$1:гіпд: ^цпсііопО { геіцгп іИіз.Г + + ІПіз.І: } 

}, 

{ иріо: Гипсііоп(і) { геіигп пеѵу/ 5ітр1еПапде(0, I): } }): 

В примере 9.3 приводится более длинное определение класса. В нем создается 
класс, представляющий комплексные числа, и демонстрируется, как имитиро¬ 
вать члены класса в стиле Лѵа. Здесь все делается «вручную» - без использова¬ 
ния функции сІеГіпеС1азз(), представленной выше. 

Пример 9.3. СотрІех.]з: Класс комплексных чисел 
/* 

* Сотріех^з: 

* В этом файле определяется класс Сотріех, представляющий комплексные числа. 

* Напомню, что комплексные числа представляют собой сумму вещественной и мнимой части, 

* где множитель і в мнимой части - это квадратный корень из -1. 

*/ 


Л 

* Функция-конструктор определяет поля экземпляра г и і 

* в каждом создаваемом экземпляре. 
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* Эти поля хранят значения вещественной 

* они хранят информацию, уникальную для 
*/ ’ 

І^псііоп Сотр1ех( геаі, ітадіпагу) { 

іТ (із№М(геа1) || із№М(ітадіпагу)) 
іНгом пем ТуреЕггог(); 

ІІ1ІЗ. г = геаі; 
іНіз.і = ітадіпагу; 

} 

Л 


и мнимой частей комплексного числа: 
каждого объекта. 


// Убедиться, что аргументы - числа. 
// Иначе возбудить исключение. 

// Вещественная часть числа. 

// Мнимая часть числа. 


* Методы экземпляров класса определяются как свойства-функции объекта-прототипа. 

* Методы, определяемые ниже, наследуются всеми экземплярами и обеспечивают общность 

* поведения класса. Обратите внимание, что методы экземпляров в ЭаѵаВсгірі 

* должны использовать ключевое слово іНіз для доступа к полям экземпляра. 

*/ 


// Складывает комплексное число ІНаі с текущим и возвращает сумму в виде нового объекта. 
Сотріех. ргоіоіуре.асіс) = ^цпсііопСіПаІ:) { 

геіцгп пем Сотр1ех(Шз. г + іНаі.г, іНіз.і + ІПаі.і); 

>; 


// Умножает текущее комплексное число на число {На* и возвращает произведение. 
Сотріех. ргоіоіуре.тіЛ = *ипс*іоп(*Ііа{) { 

геііігп пем Сотріех(1:Иіз. г * {Па*. г - {Ніз.і * {Наі.і, 

{Ніз.г * {Наі.і + {Ніз.і * {На*.г); 

>: 

// Возвращает вещественный модуль комплексного числа. Он определяется 
// как расстояние до числа на комплексной плоскости от точки (0.0). 

Сотріех. рго*о*уре.тад = *ііпс{іоп() { 

ге*іігп Ма*Н.здг{({Ніз.г*{Ніз.г + *Иіз.і**Ніз.і); 

}; 


// Возвращает комплексное число с противоположным знаком. 

Сотріех.рго*о*уре.пед = І^псііопО { ге*цгп пем Сотр1ех(-*Ніз.г, -{Ніз.і); }; 

// Преобразует объект Сотріех в строку в понятном формате. 

Сотріех. рго*о*уре.{о${гіпд = {ітс{іоп() { 
геііігп "{" + *Ніз.г + + {Ніз.і + 

}; 


// Проверяет равенство данного комплексного числа с заданным. 

Сотріех.ргоіоіуре.ециаіз = {цпс{іоп({На{) { 

геіигп {На* != піЛІ && // должно быть определено, не равно піЛІ 

{На*.сопз*гис*ог === Сотріех && // и быть экземпляром Сотріех 

{Ніз.г === {На*.г && {Ніз.і === *На*.і; // и иметь те же значения. 

>: 

Л 

* Поля класса (например, константы) и методы класса определяются как свойства 

* конструктора. Обратите внимание, что в методах класса вообще не используется 

* ключевое слово {Ніз: они выполняют операции только со своими аргументами. 

*/ 


// Ниже определяется несколько полей класса, хранящих предопределенные 
// комплексные числа. Их имена состоят исключительно из заглавных символов, 
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// чтобы показать, что они являются константами. 

// (В ЕСМАЗсгірі 5 эти свойства можно было бы сделать доступными только для чтения) 
Сотріех.2ЕР0 = пе\ѵ Сотр1ех(0,0); 

Сотріех. ОМЕ = пем СотрІех(І.О); 

СотрІех.І = пем Сотр1ех(0,1); 

// Следующий метод анализирует строку в формате, возвращаемом методом 

// экземпляра ІоЗІгіпд, и возвращает объект Сотріех или возбуждает исключение ТуреЕггог. 

Сотріех. рагзе = і^псііопСз) { 

Ігу { // Предполагается, что анализ пройдет успешно 

ѵаг т = Сотріех._І : огта1:.ехес(з); // Регулярное выражение 
геіигп пем Сотр1ех(рагзеР1оа1:(т[1]), рагзеР1оа1:(т[2])); 

} саісіл (х) { // Возбудить исключение в случае неудачи 

ІНгом пем ТуреЕггог("Строка + з + "' не может быть преобразована” + 

в комплексное число."); 

} 

}; 


// "Частное" поле класса, используемое методом Сотріех. рагзе(). 

// Символ подчеркивания в его имени указывает, что оно предназначено 

// для внутреннего использования и не является частью общедоступного АРІ класса. 

Сотріех._РогтаІ = /'ЛИГ. ]+),(["}]+)\}$/; 

Определение класса Сотріех, представленное в примере 9.3, позволяет использо¬ 
вать конструктор, поля экземпляра, методы экземпляров, поля класса и методы 
класса, как показано ниже: 

ѵаг с = пеѵу/ Сотр1ех(2,3); // Создать новый объект с помощью конструктора 

ѵаг с) = пе\ѵ Сотр1ех(с. і.с. г); // Использовать свойства экземпляра с 
с.ас)с)(с)).1:о$1:гіпд(); // => "{5.5}": использовать методы экземпляров 

// Более сложное выражение, в котором используются метод и поле класса 
Сотріех. рагзе(с. ІоЗІгіпдС )). // Преобразовать с в строку и обратно, 

ас)с](с.пед()). // сложить с числом с противоположным знаком, 

едиа1з(Сотр1ех.2ЕР0) // и результат всегда будет равен нулю 

Несмотря на то что язык ЛѵаЗсгірі позволяет имитировать члены классов в сти¬ 
ле языка Лѵа, тем не менее в Лѵа существует множество особенностей, которые 
не поддерживаются классами в языке ^ѵа8сгір1. Во-первых, в методах экземп¬ 
ляров классов в языке ^ѵа допускается использовать поля экземпляра, как если 
бы они были локальными переменными, - в Лѵа нет необходимости предварять 
их ссылкой 1:1л із. В языке ^ѵаВсгірі такая возможность не поддерживается, но 
похожего эффекта можно добиться с помощью инструкции ѵу/ііііп (хотя это и не ре¬ 
комендуется): 

Сотріех. ргоІоІуре.ІоЗігіпд = ^ьпсИопО { 

міІГКіНіз) { 

геііи гп + г + " + і + 

} 

}; 

В языке ^ѵа поддерживается возможность объявлять поля со спецификатором 
Гіпаі, чтобы показать, что они являются константами, и объявлять поля и мето¬ 
ды со спецификатором ргіѵаііе, чтобы показать, что они являются частными для 
реализации класса и недоступны пользователям класса. В языке ^ѵа8сгірі эти 
ключевые слова отсутствуют, поэтому, чтобы обозначить частные свойства (имена 
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которых начинаются с символа подчеркивания) и свойства, доступные только 
для чтения (имена которых содержат только заглавные символы), в примере 9.3 
используются соглашения по именованию. Мы еще вернемся к этим двум темами 
ниже в этой главе: частные свойства можно имитировать с помощью локальных 
переменных в замыканиях (раздел 9.6.6), а возможность определения свойств- 
констант поддерживается стандартом ЕСМАЗсгірі 5 (раздел 9.8.2). 

9.4. Наращивание возможностей классов 

Механизм наследования на основе прототипов, используемый в языке Лѵа8сгірі, 
имеет динамическую природу: объекты наследуют все свойства своих прототи¬ 
пов, даже если они были добавлены в прототипы уже после создания объектов. 
Это означает, что в ЛѵаЗсгірі имеется возможность наращивать возможности 
классов простым добавлением новых методов в объекты-прототипы. Ниже приво¬ 
дится фрагмент, который добавляет метод вычисления сопряженного комплекс¬ 
ного числа в класс Сотріех из примера 9.3: 

// Возвращает комплексное число, которое является сопряженным 
// по отношению к текущему. 

Сотріех. ргоііоііуре. соп^ = ^цпсИопО { геіюгп пе\ѵ Сотр1ех(1:Ьі5. г, -Шз.і); }; 

Объект-прототип встроенных классов Лѵа8сгірі также «открыт» для подобного 
наращивания, а это означает, что есть возможность добавлять новые методы 
к числам, строкам, массивам, функциям и т. д. Данная возможность уже исполь¬ 
зовалась в примере 8.5. Там мы добавляли метод Ьіпс1() к классу функций в реа¬ 
лизации ЕСМАЗсгірі 3, где он отсутствует: 

і? (! Рцпсіііоп. ргоііоііуре. ЬіпсІ) { 

Рипсіііоп.ргоііоііуре.ЬіпсІ = Рцпс1ііоп(о /*, аргументы */) { 

// Реализация метода ЬіпсІ... 

}; 

} 

Ниже приводятся несколько примеров расширения классов: 

// Вызывает функцию { в цикле, количество итераций равно самому числу; 

// при этом функции каждый раз передается номер итерации 
// Например, чтобы вывести "привет" 3 раза: 

// ѵаг п = 3; 

// п.'Ііте5(^цпсІіоп(п) { сопзоіе. 1од(п + " привет"); }); 

МілпЬег.ргоііоііуре.іітез = ^ипсі:іоп(^, сопііехі:) { 
ѵаг п = МцтЬег(Шз); 

^ог(ѵаг і = 0; і < п; і++) саіі(сопііехі:, і); 

}; 

// Определяет метод Е35 31: гіпд.ігіт(), если он отсутствует. 

// Этот метод удаляет пробельные символы в начале и в конце строки и возвращает ее. 

31: гіпд.ргоііоііуре.ігіт = 31: гіпд.ргоііоііуре.ігіт || ?цпс*іоп() { 

ІР (ИіЬіз) геітгп Шз; // Не изменять пустую строку 

геішгп ІіИіз. гер1асе(/''\з+ 1 \з+$/д, ""); // Регулярное выражение 

}; 

// Возвращает имя функции. Если функция имеет свойство пате (нестандартное), 

// возвращает его значение. Иначе преобразует функцию в строку и извлекает имя из нее. 
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// Для неименованных функций возвращает пустую строку. 

Рцпсіііоп.ргоііоііуре.де^ате = Гипсіііоп() { 

геііцгп Шз.пате || ІіГііз.ІіоЗі:гіпд().та1:сИ(/Гипс1:іоп\з*([ Л (]*)\(/)[1]; 

}; 

Методы можно также добавлять в ОЬ^есГ. ргоГоГуре, тем самым делая их доступны¬ 
ми для всех объектов. Однако делать это не рекомендуется, потому что в реализа¬ 
циях, появившихся до ЕСМАЗсгірі 5, отсутствует возможность сделать эти допол¬ 
нительные методы неперечислимыми. При добавлении новых свойств в ОУесГ. рго- 
ІюГуре они становятся доступны для перечисления в любом цикле Гог/іп. В разде¬ 
ле 9.8.1 приводится пример использования метода ОУесГ.йеПпеРгорегГуО, опреде¬ 
ляемого стандартом ЕСМАЗсгірі 5, для безопасного расширения ОЬ^есГ. ргоГоГуре. 

Возможность подобного расширения классов, определяемых средой выполнения 
(такой как веб-броузер), зависит от реализации самой среды. Во многих веб-бро- 
узерах, например, допускается добавлять методы в НТМІ_Е1етеп1і.рго1іо1іуре, и такие 
методы будут наследоваться объектами, представляющими теги НТМЬ в теку¬ 
щем документе. Однако данная возможность не поддерживается в текущей вер¬ 
сии МісгозоН Іпіегпеі Ехріогег, что сильно ограничивает практическую ценность 
этого приема в клиентских сценариях. 

9.5. Классы и типы 

В главе 3 уже говорилось, что в языке ЛѵаЗсгірі определяется небольшое количе¬ 
ство типов: пиіі, ипРеГіпей, логические значения, числа, строки, функции и объек¬ 
ты. Оператор ГуреоГ (раздел 4.13.2) позволяет отличать эти типы. Однако часто бы¬ 
вает желательно интерпретировать каждый класс как отдельный тип данных 
и иметь возможность отличать объекты разных классов. Отличать встроенные 
объекты базового языка ЛѵаЗсгірі (и объекты среды выполнения в большинстве 
реализаций клиентского ^ѵа8сгірі) можно по их атрибуту сіагг (раздел 6.8.2), 
используя прием, реализованный в функции с1аззоГ() из примера 6.4. Но когда 
класс определяется с помощью приемов, продемонстрированных в этой главе, эк¬ 
земпляры объектов всегда содержат в атрибуте сіазз значение «ОЪіесі», поэтому 
функция с1аззоГ() в данной ситуации оказывается бесполезной. 

В следующих подразделах описываются три приема определения класса произ¬ 
вольного объекта: оператор іпзІіапсеоГ, свойство сопзГгисГог и имя функции-конст¬ 
руктора. Однако ни один из этих приемов не дает полной гарантии, поэтому в раз¬ 
деле 9.5.4 мы обсудим прием грубого определения типа (биск-іурт#) - филосо¬ 
фии программирования, в которой центральное место отводится возможностям 
объекта (т. е. наличию тех или иных методов), а не его принадлежности к какому- 
либо классу. 

9.5.1. Оператор іпзіапсеоі 

Оператор іпзІіапсеоГ был описан в разделе 4.9.4. Слева от оператора должен нахо¬ 
диться объект, для которого выполняется проверка принадлежности к классу, 
а справа - имя функции-конструктора, представляющей класс. Выражение о Іп¬ 
зІіапсеоГ с возвращает Ггие, если объект о наследует с. ргоііоііуре. При этом наследова¬ 
ние необязательно может быть непосредственным. Если о наследует объект, кото¬ 
рый наследует объект, наследующий с. ргоііоііуре, выражение все равно вернет Ггие. 
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Как отмечалось выше в этой главе, конструкторы выступают в качестве наруж¬ 
ной вывески классов, а фундаментальная идентификация классов проводится 
прототипами. Несмотря на то что в операторе іпзіапсеоі 1 используется функция» 
конструктор, этот оператор в действительности проверяет прототип, наследуе¬ 
мый объектом, а не конструктор, с помощью которого он был создан. 

Если необходимо проверить, входит ли некоторый определенный прототип в це¬ 
почку прототипов объекта без использования функции-конструктора, как проме¬ 
жуточного звена, можно воспользоваться методом ізРго*о*уреОЮ- Например, ни¬ 
же показано, как проверить принадлежность объекта г к классу гапде, определен¬ 
ному в примере 9.1: 

гапде. теІіИосІз. ізРго1:о1:уреО^( г); // гапде. теІЬосіз - объект-прототип. 

Один из недостатков оператора іпзіапсеоі 1 и метода ізРгоІоІуреО^О состоит в том, 
что они не позволяют узнать класс объекта. Они лишь проверяют принадлеж¬ 
ность объекта указанному классу. Еще более серьезные проблемы начинают воз¬ 
никать в клиентских сценариях ЛѵаЗсгірі, когда веб-приложение использует не¬ 
сколько окон или фреймов. Каждое окно или фрейм имеет свой собственный кон¬ 
текст выполнения, и в каждом из них имеется свой глобальный объект со своим 
собственным набором функций-конструкторов. Два массива, созданные в двух 
разных фреймах, унаследуют идентичные, но разные объекты прототипов, и мас¬ 
сив, созданный в одном фрейме, не будет распознаваться оператором іпзІапсеоТ 1 
как экземпляр конструктора АггауО в другом фрейме. 

9.5.2. Свойство сопзігисіог 

Другой способ определения класса объекта заключается в использовании свойст¬ 
ва сопз1:гис1:ог. Поскольку конструкторы считаются именами классов, определе¬ 
ние класса выполняется очень просто. Например: 

^ипсіііоп 1:уреАпсІ\/а1ие( х) { 

Н (х == пиіі) геіигп // Значения пиіі и ипсіе^іпесі не имеют конструкт. 

5\ѵі1:сЬ(х.сопзігисііог) { 

сазе МілпЬег: геііігп ''МілпЬег: " + х; // Работает с простыми типами 

сазе Зіігіпд: ге1:іігп "Зіігіпд: + х + ; 

сазе Ьа1:е: геіигп 'Ьа1:е: " + х; // Со встроенными типами 

сазе РедЕхр: геііігп "Редехр: '' + х; 

сазе Сотріех: геѣіігп "Сотріех: + х; // И с пользовательскими типами 

} 

} 

Обратите внимание, что выражения в этом примере, следующие за ключевыми 
словами сазе, являются функциями. Если бы мы использовали оператор Іурео^ 
или извлекали значение атрибута сіазз объекта, они были бы строками. 

Для приема, основанного на использовании свойства сопзігисіог, характерны те 
же проблемы, что и для приема на основе оператора іпзіапсео^. Он не всегда будет 
работать при наличии нескольких контекстов выполнения (например, при нали¬ 
чии нескольких фреймов в окне броузера), совместно использующих общие зна¬ 
чения. Каждый фрейм имеет собственный набор функций-конструкторов: конст¬ 
руктор Аггау в одном фрейме не будет считаться идентичным конструктору Аггау 
в другом фрейме. 
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Кроме того, язык ЛѵаЗсгірі не требует, чтобы каждый объект имел свойство соп- 
зігисіог: это всего лишь соглашение, по которому по умолчанию объект-прототип 
создается для каждой функции, и очень просто по ошибке или преднамеренно 
опустить свойство сопзігіісіог в прототипе. Например, первые два класса в этой 
главе (в примерах 9.1 и 9.2) были определены так, что их экземпляры не имеют 
свойства сопз1:гис1:ог. 

9.5.3. Имя конструктора 

Основная проблема использования оператора іизіапсео^ или свойства сопзіігисііог 
для определения класса объекта проявляется при наличии нескольких контек¬ 
стов выполнения и, соответственно, при наличии нескольких копий функций- 
конструкторов. Эти функции могут быть совершенно идентичными, но разными 
объектами, как следствие, не равными друг другу. 

Одно из возможных решений проблемы заключается в том, чтобы использовать 
в качестве идентификатора класса имя функции-конструктора вместо самой 
функции. Конструктор Аггау в одном окне не будет равен конструктору Аггау в дру¬ 
гом окне, но их имена будут равны. Некоторые реализации ЛѵаЗсгірі обеспечи¬ 
вают доступ к имени функции через нестандартное свойство пате объекта функ¬ 
ции. Для реализаций, где свойство пате отсутствует, можно преобразовать функ¬ 
цию в строку и извлечь имя из нее. (Этот прием использовался в разделе 9.4, где 
демонстрировалось добавление в класс Рипсііоп метода де1:Мате().) 

В примере 9.4 определяется функция ІуреО, возвращающая тип объекта в виде 
строки. Простые значения и функции она обрабатывает с помощью оператора 
ІуреоР. Для объектов она возвращает либо значение атрибута сіазз, либо имя кон¬ 
структора. В своей работе функция ІуреО использует функцию сІаззоГО из при¬ 
мера 6.4 и метод Рипс1:іоп.де1:Мате() из раздела 9.4. Для простоты реализация этой 
функции и метода включена в пример. 

Пример 9.4. Функция іуре( ) для определения типа значения 
/ ** 

* Возвращает тип значения в виде строки: 

* -Если о - пііП, возвращает "пііП", если о - возвращает "пап”. 

* -Если ІуреоГ возвращает значение, отличное от "оЬ^есІ:", возвращает это значение. 

* (Обратите внимание, что некоторые реализации идентифицируют объекты 

* регулярных выражений как функции.) 

* -Если значение атрибута сіазз объекта о отличается от "ОЬ^есІ:", 

* возвращает это значение. 

* -Если о имеет свойство сопзігцсіог, а конструктор имеет имя, возвращает 

* имя конструктора. 

* -Иначе просто возвращает "ОЬ^есІ:". 

* */ 

^цпсИоп 1уре(о) { 

ѵаг 1:, с, п; // Іуре, сіазз, пате 

// Специальный случай для значения пціі: 

(о === пціі) геііігп "пціі"; 

// Другой специальный случай: - единственное значение, не равное самому себе: 

іР (о !== о) геііігп "пап"; 
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// Применять Туреоі 1 для любых значений, отличных от "оЬ^ес^". 

// Так идентифицируются простые значения и функции. 
і? ((Т = Турео^ о) !== "оЬ]есТ") геТигп Т; 

// Вернуть класс объекта, если это не "ОЬіесТ". 

// Так идентифицируется большинство встроенных объектов. 
іМ(с = сІаззо^Чо)) !== "ОЬіесТ") геішгп с; 

// Вернуть имя конструктора объекта, если имеется 

і? (о. сопзіігцсіог && ТуреоТ о.сопзТгцсТог === "^псТіоп" && 

(п = о.сопз1:гцс1:ог.де1:Мате())) геішгп п; 

// Не удалось определить конкретный тип, поэтому остается лишь 
// просто вернуть "0Ь]есТ" 
геішгп "0Ь]ес*"; 

} 

// Возвращает класс объекта. 

Ішпсіііоп с1аззо?(о) { 

геіш гп ОЬ іесі: . р гоіоіуре . То8Т гіпд . саіі (о). зіісе (8,-1); 

}; 

// Возвращает имя функции (может быть ') или пціі - для объектов, 

// не являющихся функциями 
Рипсіііоп .рго1:о1:уре. деІМаше = ІшпсІіопО { 
і? ("пате” іп ІіНіз) геішгп ІНіз.пате; 

геішгп Шз.пате = Шз. *о$*гіпд().та*сІі(Дцпс*іоп\5*([~( ]*)\(/)[1]; 

): 

Этот прием, основанный на использовании имени конструктора для идентифика- 
ции класса объекта, имеет ту же проблему, что и прием на основе использования 
свойства сопзігисіог: не все объекты имеют свойство сопзігисіог. Кроме того, не 
все функции имеют имена. Если определить конструктор, используя выражение 
определения неименованной функции, метод де*№те() будет возвращать пустую 
строку: 

// Этот конструктор не имеет имени 

ѵаг Сотріех = 1шпс1:іоп(х, у) { ІіПіз.г = х; ІіПіз.і = у; } 

// Этот конструктор имеет имя 

ѵаг Вапде = Ішпсііоп Рапде(*М:) { ІіЬіз.Ітот = ІіПіз.Ііо = 1:; } 

9.5.4. Грубое определение типа 

Ни один из приемов определения класса объекта, описанных выше, не свободен 
от проблем, по крайней мере, в клиентском ЛѵаЗсгірі. Альтернативный подход 
состоит в том, чтобы вместо вопроса «какому классу принадлежит объект?» за¬ 
дать вопрос «что может делать этот объект?». Этот подход является типичным 
в таких языках программирования, как РуіЬоп и КиЪу, и носит название грубое 
определение типа (< йиск-1уріп§ , или «утиная типизация») в честь высказывания 
(часто приписываемого поэту Джеймсу Уиткомбу Райли ^атез ДУЬіісотЬ Кііеу)): 

Когда я вижу птицу, которая ходит, как утка, плавает, как утка и крякает, как 
утка, я называю ее уткой. 

Для программистов на языке ЛѵаЗсгірі этот афоризм можно интерпретировать 
так: «Если объект может ходить, плавать и крякать как объект класса Биск, его 
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можно считать объектом класса Биск, даже если он не наследует объект-прото- 
тип класса Биск». 

Примером может служить класс Рапде из примера 9.2. Этот класс предназначен 
для представления диапазонов чисел. Однако обратите внимание, что конструк¬ 
тор Рапде() не проверяет типы аргументов, чтобы убедиться, что они являются 
числами. Аналогично метод іпс1ийез( ) использует оператор <=, но не делает ника¬ 
ких предположений о типах значений границ диапазона. Благодаря тому что 
класс не ограничивается определенным типом значений, его метод іпс1ис1ез( ) спо¬ 
собен обрабатывать значения границ любых типов, которые могут сравниваться 
с помощью операторов отношения: 

ѵаг Іомегсазе = пе\ѵ Рапде("а", "г ')\ 

ѵаг ШзѴеаг = пе\ѵ Рапде(пе\ѵ Ра1:е(2009, 0, 1), пе\л/ 0аі;е(2010, 0, 1)); 

Метод ГогеасИО класса Рапде также не проверяет типы значений границ, но он ис¬ 
пользует функцию МаІІі.сеіІО и оператор ++, вследствие чего может применяться 
только к числовым значениям границ диапазона. 

В качестве еще одного примера вспомним объекты, подобных массивам, обсуж¬ 
давшиеся в разделе 7.11. Во многих случаях нам не требуется знать, действитель¬ 
но ли объект является экземпляром класса Аггау: вполне достаточно знать, что он 
имеет свойство ІепдІІп с неотрицательным целочисленным значением. Если по¬ 
считать, что целочисленное свойство ІепдІзИ - это способ массивов «ходить», то мы 
могли бы сказать, что любой объект, который умеет «ходить» так же, можно (во 
многих случаях) отнести к массивам. 

Однако имейте в виду, что свойство ІепдІІп настоящих массивов обладает особым 
поведением: свойство ІепдІІп автоматически обновляется при добавлении нового 
элемента, а когда значение свойства ІепдІГі уменьшается, массив автоматически 
усекается. Можно было бы сказать, что эти две особенности описывают, как мас¬ 
сивы «плавают» и «крякают». Если вы пишете программу, где требуется, чтобы 
объект «плавал» и «крякал» как массив, вы не сможете использовать в ней объ¬ 
ект, который только «ходит» как массив. 

Примеры грубого определения типа, представленные выше, опираются на воз¬ 
можность сравнения объектов с помощью оператора < и на особенности поведения 
свойства Іепдііі. Однако чаще всего под грубым определением типа подразумева¬ 
ется проверка наличия в объекте одного или более методов. Строго типизирован¬ 
ная функция 1:гіаШоп() могла бы потребовать, чтобы ее аргумент был объектом 
класса ТгіАШеІіе. Альтернативная реализация, выполняющая грубую проверку 
типа, могла бы принимать любой объект, имеющий методы \л/а1к(), з\л/іт() и Ьіке(). 
Если говорить более конкретно, можно было бы переписать класс Рапде так, что¬ 
бы вместо операторов < и ++ он использовал бы методы сотрагеТо() и зисс() объек¬ 
тов значений границ. 

Можно подойти к определению типа либерально: просто предположить, что вход¬ 
ные объекты реализуют все необходимые методы, и не выполнять никаких прове¬ 
рок. Если предположение окажется ошибочным, при попытке вызвать несущест¬ 
вующий метод возникнет ошибка. Другой подход заключается в реализации про¬ 
верки входных объектов. Однако, вместо того чтобы проверять их принадлежность 
к определенному классу, можно проверить наличие методов с определенными 
именами. Это позволит отвергнуть входные объекты раньше и вернуть более ин¬ 
формативное сообщение об ошибке. 
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В примере 9.5 определяется функция диаскзО (более подходящим было бы имя 
«ітріетепіз» (реализует), но ітріетепіз является зарезервированным словом), ко¬ 
торая может пригодиться для грубого определения типа. Функция диаскзО про* 
веряет наличие в объекте (первый аргумент функции) методов, указанных в ос¬ 
тальных аргументах. Для каждого последующего аргумента, если аргумент яв¬ 
ляется строкой, проверяется наличие метода с этим именем. Если аргумент явля¬ 
ется объектом, проверяется наличие в первом объекте методов с теми же именами, 
что и во втором объекте. Если аргумент является функцией, предполагается, что 
она является конструктором, и в этом случае проверяется наличие в первом объ¬ 
екте методов с теми же именами, что и в объекте-прототипе. 

Пример 9.5. Функция грубой проверки типа 

// Возвращает Ігце, если о реализует методы, определяемые последующими аргументами. 

^ипсііоп дцаскз(о /*, ... */) { 

^ог(ѵаг і=1; Кагдцтепііз. Іепдіііі; і++) { // для каждого аргумента после о 

ѵаг агд = агдитеп1:5[і]; 

з\ѵі1:сИ(Іурео^ агд) { // Если агд - это: 

сазе ’зігіпд': // строка: проверить наличие метода с этим именем 

і? ({уреоі 1 о[агд] !== "І'ипсіііоп”) геіюгп І'аізе: 
сопііпце; 

сазе ' І'цпсііоп 1 : //функция: использовать объект-прототип 

// Если аргумент является функцией, использовать ее прототип 
агд = агд.рго*о*уре; 

// переход к следующему случаю сазе 
сазе оЬіесІ:': // объект: проверить наличие соотв. методов 

^ог(ѵаг т іп агд) { // Для каждого свойства объекта 

Н ( Іурео^ агд[т]! ==’* ^цпсіііоп **) сопіііпце; // Пропустить свойства, 

// не являющиеся методами 
іТ ( Іурео^ о[т] !== "^цпсіііоп") геііцгп ^аізе; 

} 

} 

} 

// Если мы попали сюда, значит, объект о реализует все, что требуется 

геіцгп 1: гие ; 

} 

Есть два важных момента, касающиеся функции диаскз(), которые нужно иметь 
в виду. Во-первых, она просто проверяет наличие в объекте одного или более ме¬ 
тодов с заданными именами. Присутствие этих свойств ничего не говорит ни 
о том, что делают эти функции, ни о том, сколько и какого типа аргументы они 
принимают. Однако это и есть сущность грубого определения типа. Определяя 
интерфейс, в котором вместо строгой проверки используется прием грубого опре¬ 
деления типа, вы получаете более гибкий прикладной интерфейс, но при этом 
перекладываете на пользователя всю ответственность за правильное его исполь¬ 
зование. Второй важный момент, касающийся функции диаскз(), заключается 
в том, что она не может работать со встроенными классами. Например, нельзя вы¬ 
полнить проверку диаскз(о, Аггау), чтобы убедиться, что объект о обладает всеми 
методами класса Аггау. Это обусловлено тем, что методы встроенных классов не¬ 
доступны для перечисления и цикл 'Гог/іп в диаскз() просто не заметит их. (Следу¬ 
ет отметить, что это ограничение можно преодолеть в ЕСМАбсгірі 5 с помощью 
функции ОЬіесІ:.де1:0ѵѵ/пРгорег1;у Матез().) 
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9.6. Приемы объектно-ориентированного 
программирования в ІаѵаБсгірІ 

До сих пор в этой главе мы рассматривали архитектурные основы классов в язы¬ 
ке ЛѵаЗсгірі: важную роль объектов-прототипов, связь классов с функциями- 
конструкторами, как действует оператор іпзіапсеоі 1 и т. д. В этом разделе мы про¬ 
демонстрируем несколько практических (пусть и не фундаментальных) приемов 
программирования на языке ЛѵаЗсгірі с применением классов. Начнем с двух 
нетривиальных примеров классов, которые не только интересны сами по себе, но 
также послужат отправной точкой для дальнейшего обсуждения. 

9.6.1. Пример: класс множества 

Множество - это структура данных, представляющая неупорядоченную кол¬ 
лекцию неповторяющихся значений. К фундаментальным операциям над мно¬ 
жествами относятся сложение множеств и проверка вхождения значения в мно¬ 
жество, и обычно множества реализуются так, чтобы эти операции имели макси¬ 
мальную скорость выполнения. Объекты в языке ЛѵаЗсгірі по сути являются 
множествами имен свойств, где с каждым именем связано некоторое значение. 
Таким образом, объекты легко можно использовать как множества строк. В при¬ 
мере 9.6 реализован более универсальный класс Зеі:. Он отображает любые значе¬ 
ния, допустимые в языке ЛѵаЗсгірі, в уникальные строки и использует их в ка¬ 
честве имен свойств. Объекты и функции не имеют достаточно краткого строко¬ 
вого представления, гарантирующего уникальность, поэтому класс Зеі: должен 
определить идентификационное свойство в любом объекте или функции, сохра¬ 
няемых в множестве. 

Пример 9.6.8е1.]з: произвольное множество значений 

^цпсііоп Зе1:() { // Это конструктор 

ІИіз.ѵаІцез = {}: // Свойства этого объекта составляют множество 

ІІііз.п = 0; // Количество значений в множестве 

ІіИіз.асісі.аррІуСііИіз. агдцтепіз); // Все аргументы являются значениями, 

} // добавляемыми в множество 

// Добавляет все аргументы в множество. 

Зеі:. ргоііоііуре. асісі = ^ыпсНопО { 

1 : ог(ѵаг і = 0; і < агдитепііз. ІепдІіИ; і++) { // Для каждого аргумента 
ѵаг ѵаі = агдіітеп1:5[і]; // Добавляемое значение 

ѵаг зііг = Зе1:._ѵ25(ѵа1); // Преобразовать в строку 

(! ІІііз. ѵаіцез. Иаз0\ѵпРгорег1:у(5І:г)) { // Если отсутствует в множ. 

1ПІ5.ѵа1ііез[з1 г] = ѵаі; // Отобразить строку в знач. 

1ПІ5.П++; // Увеличить размер множества 

} 

} 

геіцгп ІПіз; // Для поддержки цепочек вызовов методов 

}; 

// Удаляет все аргументы из множества. 

Зеі:.ргоііоііуре. гетоѵе = 1"ііпс1:іоп( ) { 

1"ог(ѵаг і = 0; і < агдіітепіз. ІепдІП; і++) { // Для каждого аргумента 
ѵаг зі:г = Зе1:._ѵ25(агдіітепі:5[і]); // Отобразить в строку 
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ІГ (Ш5.ѵа1ие5.Ьаз0ипРгорегТу($1:г)) { // Если присутствует в множ. 

сІеІеТе ІНіз.ѵа1цез[5І:г]; // Удалить 

ІНіз.п--; // Уменьшить размер множества 

> 

} 

геТьгп ІІііз; // Для поддержки цепочек вызовов методов 


// Возвращает Тгііе, если множество содержит ѵаіье; иначе возвращает Гаізе. 
ЗеТ.ргоТоТуре. сопТаіпз = Гцпс1:іоп(ѵа1ие) { 

геТьгп Шз. ѵаіьез. НазО\ѵпРгорег1:у(Зе1:._ѵ25(ѵа1ие)); 

}; 


// Возвращает размер множества. 

ЗеТ. ргоііоііуре.зіге = ГітсТіопО { геішгп {Ыз.п; }; 

// Вызывает функцию Т в указанном контексте для каждого элемента множества. 

Зе*. ргоТоІуре. ГогеасН = Гипсі:іоп(Г, сопТехТ) { 

Гог(ѵаг з іп ІМіз.ѵаІьез) // Для каждой строки в множестве 

іГ (ТЬі5.ѵа1це5.Ьа50мпРгорег1:у(5)) // Пропустить унаследов. свойства 
Г.саЩсопІехІ, ТПіз.ѵа1цез[з]); // Вызвать Г для значения 

}; 

// Функция для внутреннего использования. Отображает любые значения ^ѵаЗсгірІ: 

// в уникальные строки. 

ЗеТ._ѵ2з = Гцпс1:іоп(ѵа1) { 

5\ѵі1:сН(ѵа1) { 

сазе ьпсІеГіпесІ: геТіігп ЧГ; // Специальные простые значения 

сазе пьП: геіьгп ’п'; // отображаются в односимвольные строки. 

сазе Ігце: геіюгп Ч '; 

сазе Гаізе: геішгп Т; 

сІеГаиІІ:: 8\ѵі1:сІі(1:уреоГ ѵаі) { 

сазе 'пілпЬег’: геіюгп + ѵаі; // Числа получают префикс #. 

сазе ’зіігіпд': геіюгп '+ ѵаі; // Строки получают префикс ". 

сІеГацИ:: геіьгп + оЬіесііІсІ(ѵаІ); // Объекты и функции - @ 

} 

} 

// Для любого объекта возвращается строка. Для разных объектов эта функция 
// будет возвращать разные строки, а для одного и того же объекта всегда 
// будет возвращать одну и ту же строку. Для этого в объекте о создается свойство. 

// В Е35 это свойство можно сделать неперечислимым и доступным только для чтения. 
Гипсіііоп оЬ]ес1:ІсІ(о) { 

ѵаг ргор = "| **оЬ]ес1:ісІ** |"; // Имя частного идентификац. свойства 

іГ (!о.НазОмпР горе г1:у(р гор)) // Если объект не имеет этого свойства 

о[ргор] = Зе1._ѵ2з. пех1:++; // Присвоить ему след, доступ, значение 
геіьгп о[ргор]; // Вернуть идентификатор 

} 

}; 

Зеі . _ѵ2з . пехі = 100; // Начальное значение для идентификаторов объектов. 

9.6.2. Пример: типы-перечисления 

Перечислениями называются типы, которые могут принимать конечное коли¬ 
чество значений, объявляемых (или «перечисляемых») при определении типа. 
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В языке С и его производных типы-перечисления объявляются с помощью клю¬ 
чевого слова епит. В ЕСМАЗсгірі 5 епит - это зарезервированное (но не используе¬ 
мое) слово, оставленное на тот случай, если когда-нибудь в ЛѵаЗсгірі будут реа* 
лизованы встроенные типы-перечисления. А пока в примере 9.7 демонстрирует¬ 
ся, как можно определить собственный тип-перечисление на языке ЛѵаЗсгірі. 
Обратите внимание, что здесь используется функция іпМегі1;() из примера 6.1. 

Пример 9.7 содержит единственную функцию епитегаТіопО. Однако она не явля¬ 
ется конструктором: она не определяет класс с именем «епитег аііоп ». Но она яв¬ 
ляется фабричной функцией: при каждом вызове она создает и возвращает но¬ 
вый класс. Ниже показано, как ее можно использовать: 


// Создать новый класс Соіп с четырьмя возможными значениями: 

// Соіп.Реппу, Соіп.МіскеІ и т. д. 

ѵаг Соіп = епіітега1:іоп( {Реппу: 1, Міскеі :5, Эіте: 10. Оиагііег:25}): 
ѵаг с = Соіп.Ріте; // Это экземпляр нового класса 

с іпзІіапсеоГ Соіп // => ігііе: іпзіапсеоі 1 работает 

с.сопзігьсіог == Соіп // => ігце: свойство сопзігіісіог работает 

Соіп.ОьагІіег + 3*Соіп.Міскеі // => 40: значения преобразуются в числа 

Соіп.Эіте == 10 // => Хгие: еще одно преобразование в число 

Соіп.Эіте > Соіп.МіскеІ // => ігие: операторы отношения работают 

31:гіпд(Соіп.йіте) + + Соіп.йіте // => "0іте:10": преобразов, в строку 


Цель этого примера состоит в том, чтобы продемонстрировать, что классы в язы¬ 
ке ЛѵаЗсгірі являются более гибкими и динамичными, чем статические классы 
в таких языках, как С++ и ^ѵа. 


Пример 9.7. Типы-перечисления в ^ ѵаЗсгірі 

// Эта функция создает новый тип-перечисление. Объект в аргументе определяет 
// имена и значения каждого экземпляра класса. Возвращает функцию-конструктор, 

// идентифицирующую новый класс. Отметьте, однако, что конструктор возбуждает 
// исключение: его нельзя использовать для создания новых экземпляров типа. 

// Возвращаемый конструктор имеет свойства, которые отображают имена в значения, 
// а также массив значений ѵаіііез и функцию ^огеасЬО для выполнения итераций 
^ііпсііоп епцтегаІііопСпатезТоѴаІцез) { 

// Фиктивный конструктор, который будет использоваться как 

// возвращаемое значение. 

ѵаг епцтегаіііоп = ГітсііопО { іЬгом "Нельзя создать экземпляр класса” + 

Епшпегаііоп"; }; 

// Перечислимые значения наследуют объект іНіз. 

ѵаг ргоіо = епшпегаіііоп. ргоіоіуре = { 

сопзігцсіог: епцтегаііоп, // Идентификатор типа 

іоЗігіпд: ?цпс*іоп() { геііігп Шз.пате; }, // Возвращает имя 
ѵаІцеОГ: Гипсіііоп() { геіигп ІНІ5.ѵаіііе; }, // Возвращает значение 
іоЭЗОМ: Гипс1:іоп() { геііцгп ІіНіз.пате; } // Для сериализации 

}; 

епцтегаііоп.ѵаіцез = []; // Массив перечислимых объектов-значений 

// Теперь создать экземпляры нового типа. 

1 : ог(пате іп патезТоѴаІцез) { // Для каждого значения 

ѵаг е = іпПегі1:(рго1:о): // Создать объект для его представления 

е.пате = пате: // Дать ему имя 

е.ѵаіце = патезТоѴаІііезГпате]; // И значение 
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епітега1:іоп[пате] = е; // Сделать свойством конструктора 

епшпегаііоп. ѵаіцез. ризГі(е ); // И сохранить в массиве ѵаіцез 

} 

// Метод класса для обхода экземпляров класса в цикле 
епцтегаііоп. Гогеасіі = Гцпс1:іоп(Г, с) { 

Гог(ѵаг і = 0; і < іііііз. ѵаіиез. ІепдтИ; і++) Г.са11(с,ТГііз.ѵаІыезСі]); 

}; 


// Вернуть конструктор, идентифицирующий новый тип 
геішгп епцтегаііоп; 

} 

Типичным начальным примером использования типов-перечислений может слу¬ 
жить реализация перечисления для представления колоды игральных карт. 
Пример 9.8 использует функцию епитега1:іоп() именно для этого, а также опреде¬ 
ляет классы для представления карт и колод карт. 1 

Пример 9.8. Представление игральных карт в виде типов-перечислений 

// Определение класса для представления игральной карты 

ГцпсТіоп СагсКзціТ, гапк) { 

ііііз. зціі: = зціі; // Каждая карта имеет масть 
ІИіз. гапк = гапк; // и значение 

} 

// Следующие типы-перечисления определяют возможные масти и значения карт 

Сагсі.ЗціІ: = епцтегаііопИСІцЬз: 1, Оіатопсіз: 2, Неагііз :3, Зрасіез:4}); 

Сагсі.Вапк = епцтегаі:іоп({Т\л/о: 2, ТІігее: 3, Роцг: 4, Ріѵе: 5, Зіх: 6, 

Зеѵеп: 7, Еідііі:: 8, Иіпе: 9, Теп: 10, 

^ск: 11, Оцееп: 12, Кіпд: 13, Асе: 14}); 

// Определение текстового представления карты 

Саге). ргоіоіуре.іоЗігіпд = Гцпс1:іоп() { 

геіцгп Шз. гапк.ІоЗі:гіпд() + " " + Шз.зціТ.іоЗігіпдО; 

}; 

// Сравнивает значения двух карт в соответствии с правилами игры в покер 

Сагсі. ргоіоіуре.сотрагеТо = Гцпсиоп(ТИаТ) { 

ІГ (ТІііз. гапк < ТІіаТ.гапк) геіцгп -1; 
іГ (ТІііз. гапк > ТІіаТ.гапк) геТцгп 1; 
геіцгп 0; 

}; 


// Функция упорядочения карт в соответствии с правилами игры в покер 
Саге). огсіегВуВапк = Гцпс*іоп(а, Ь) { геіцгп а.сотрагеТо(Ь); }; 

// Функция упорядочения карт в соответствии с правилами игры в бридж 
Сагсі.огсіегВуЗіііІ: = ГцпсТіоп(а, Ь) { 

ІГ (а.зціі: < Ь.зціТ) геіцгп -1; 

ІГ (а.зціі: > Ь.зціТ) геіцгп 1; 
іГ (а.гапк < Ь.гапк) геТцгп -1; 

ІГ (а.гапк > Ь.гапк) геіцгп 1; 


1 Этот пример основан на примере для языка ^ѵа, написанном Джошуа Блохом (ЛозЪиа 
ВІосЪ) и доступном по адресу: Ыір://іср.огі/аЬоиЫаѵа/соттипііургосе88/І8г/и$ег/епит. 
Ыті. 
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геішгп 0; 

>: 


// Определение класса представления стандартной колоды карт 
Гцпсіііоп йескО { 

ѵаг сагбз = Ііііз. сагбз = []; // Колода - просто массив карт 

Саге). $ці*. Гогеасіі(Гцпс1:іоп(5) { // Инициализировать массив 

СагсІ . Вапк. ГогеасИ( Гипс1;іоп( г) { 

сагбз. рц5іі(пе\л/ СагсКз, г)); 

}); 


// Метод перемешивания: тасует колоду карт и возвращает ее 
Реек, ргоіоіуре.зііцГГІе = Гцпс1:іоп() { 

// Для каждого элемента массива: поменять местами 
// со случайно выбранным элементом ниже 
ѵаг беек = Шз. сагсіз, Іеп = беек. Іепдіііі; 

Гог(ѵаг і = 1еп-1; і > 0; і—) { 

ѵаг г = Маііі. Г1оог(Маі:іі. гапбот()*(і+1)), Іетр: // Случайное число 

1:етр = беск[і], беск[і] = беск[г], беск[г] = іетр: // Поменять 

} 

геііигп Іііііз; 


}; 


// Метод раздачи: возвращает массив карт 
йеск. ргоііоііуре.беаі = Гцпс1:іоп(п) { 

ІГ (ІНІ5.сагбз.Іепдіііі < п) і:ііго\л/ "Карт для выдачи не хватает": 
геішгп Шз.сагбз. зрНсе(Шз. сагбз.ІепдіН-п, п); 

}; 

// Создает новую колоду карт, тасует ее и раздает как в игре в бридж 

ѵаг беек = (пем 0еск()).зііцГІ : 1е(): 

ѵаг Папб = беек, беаі (13). зогі: (Сагб . огбегВуЗиіІ:): 

9.6.3. Стандартные методы преобразований 

В разделах 3.8.3 и 6.10 описываются важные методы, используемые для преобра¬ 
зования типа объектов, часть из которых автоматически вызывается интерпрета¬ 
тором ЛаѵаЗсгірі по мере необходимости. Вам не обязательно определять эти ме¬ 
тоды в каждом своем классе, но они играют важную роль, и если вы отказывае¬ 
тесь от их реализации в своих классах, это должен быть осознанный выбор, а не 
простая оплошность. 

Первым и наиболее важным является метод ІоЗІгіпдО. Назначение этого метода 
в том, чтобы возвращать строковое представление объекта. Интерпретатор Лаѵа- 
Зсгірі автоматически вызывает этот метод, когда объект используется там, где 
ожидается строка - в качестве имени свойства, например, или с оператором +, вы¬ 
полняющим конкатенацию строк. Если отказаться от реализации этого метода, 
ваш класс унаследует от ОЩесІ:. ргоіоіуре реализацию по умолчанию и будет пре¬ 
образовываться в довольно бесполезную строку «[оЪіесі ОЪіесі]». Метод іоЗігіпдО 
может возвращать более удобочитаемую строку, подходящую для отображения 
на экране перед конечным пользователем вашего приложения. Однако даже если 
в этом нет необходимости, часто бывает полезно определить свой метод *о5і:гіпд( ), 
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чтобы упростить отладку. Классы Папде и Сотріех, представленные в примерах 9.2 
и 9.3, имеют собственные реализации метода ІоЗігіпдО, как и типы-перечисле¬ 
ния, реализация которых приводится в примере 9.7. Ниже мы определим метод, 
ІоЗігіпдО для класса Зеі: из примера 9.6. 

С методом ТоЗТгіпдО тесно связан метод 1:оІ_оса1е31:гіпд(): он должен преобразовы¬ 
вать объект в строку с учетом региональных настроек. По умолчанию объекты 
наследуют метод ТоІ_оса1еЗі:гіпд(), который просто вызывает их метод 1:оЗі:гіпд(). 
Некоторые встроенные типы имеют более полезные реализации метода 1:оІ_оса1е- 
5і:гіпд(), которые возвращают строки с учетом региональных настроек. Если 
в реализации своего метода 1:оЗі:гіпд() вам придется преобразовывать в строки 
другие объекты, вы также должны определить свой метод 1:оІ_оса1еЗі:гіпд(), вы¬ 
полняющий те же преобразования вызовом метода 1:оІ_оса1еЗі:гіпд() объектов. Ни¬ 
же мы реализуем этот метод для класса Зеі:. 

Третьим методом является метод ѵаІиеОІЧ). Его цель- преобразовать объект 
в простое значение. Метод ѵаІиеОІЧ) вызывается автоматически, когда объект ис¬ 
пользуется в числовом контексте, например, с арифметическими операторами 
(отличными от +) и с операторами отношения. Большинство объектов не имеют 
сколько-нибудь осмысленного простого представления и потому не определяют 
этот метод. Однако типы-перечисления в примере 9.7 представляют случай, ко¬ 
гда метод ѵаІиеОІЧ ) имеет большое значение. 


Четвертый метод - 1:сиЗОМ() - вызывается автоматически функцией ^ОМ.зіхіпді- 
^у(). Формат Л80К предназначен для сериализации структур данных и может ис¬ 
пользоваться для представления простых значений, массивов и простых объек¬ 
тов. При преобразовании в этот формат не делается никаких предположений 
о классах, и при сериализации объекта игнорируются его прототип и конструк¬ 
тор. Если вызвать функцию ^(ЖзІгіпдіІ'уО для сериализации объекта Папде или 
Сотріех, например, она вернет строку вида {'Тгот":1, ”1:о":3} или {"г":1, Если 

передать такую строку функции ^ОПрагееО, она вернет простой объект со свой¬ 
ствами, соответствующими объекту Папде или Сотріех, но не наследующий мето¬ 
ды класса Папде или Сотріех. 


Такой формат сериализации вполне подходит для классов, таких как Папде и Сотр¬ 
іех, но для более сложных классов может потребоваться написать собственный 
метод Іс^30М(), чтобы определить иной формат сериализации. Если объект имеет 
метод {с^ЗСМО, функция ^(Ж$і:гіпді1 : у() не будет выполнять сериализацию само¬ 
го объекта, а вызовет метод 1:с^30М() и произведет сериализацию значения (про¬ 
стого значения или объекта), которое он вернет. Например, объекты йа1:е имеют 
собственный метод Іс^ЗОМО, возвращающий строковое представление даты. Ти¬ 
пы-перечисления в примере 9.7 делают то же самое: их метод 1:с^30М() возвраща¬ 
ет то же значение, что и метод 1:оЗі:гіпд(). Самым близким к представлению мно¬ 
жества в формате Л8СЖ является массив, поэтому ниже мы определим метод 
1:с^30М(), который будет преобразовывать объект Зеі: в массив значений. 

Класс Зеі:, представленный в примере 9.6, не определяет ни один из этих методов. 
Множество не может быть представлено простым значением, поэтому нет смысла 
определять метод ѵаІиеОІЧ), но было бы желательно определить в этом классе ме¬ 
тоды *о5*гіпд(), 1:оІ_оса1еЗі:гіпд() и 1:сиЗОМ(). Можно это сделать, как показано ни¬ 
же. Обратите внимание, что для добавления методов в Зеі:. ргоіо^уре используется 
функция ех1епсі() (пример 6.2): 
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// Добавить новые методы в объект-прототип класса Зеі:. 

ехіепс)(8еі. ргоіоіуре, { 

// Преобразует множество в строку 
ІюЗігіпд: Гцпс1:іоп() { 
ѵаг 5 = і = 0; 

ГогеасИ(Гипс1;іоп(ѵ) { з += ((і++ > 0)?", + ѵ; }); 

геішгп з + "Г; 

}. 

// Действует так же, как ІоЗігіпд, но вызывает ІоІ_оса1еЗі:гіпд 
// для всех значений 
1:оІ_оса1еЗі:гіпд : ^ипсіііоп() { 
ѵаг з = "Г, і = 0; 

Шз. Гогеасіі(Гішс1:іоп(ѵ) { 

ІГ (і++ > 0) з += ", 

ІГ (ѵ == пиіі) з += ѵ; // піііі и цпсіеі'іпесі 
еізе з += ѵ. ІоІ_оса1еЗі:гіпд(); // остальные 

}); 

геііігп з + 

}, 

// Преобразует множество в массив значений 
ІоАггау: Гцпс1:іоп() { 
ѵаг а = []; 

Шз. ГогеасИ(Гипс1:іоп(ѵ) { а. ріізіі(ѵ); }); 
геіигп а; 

} 

}); 

// Для нужд сериализации в формат интерпретировать множество как массив. 

Зе*. ргоШуре. Ш50И = Зе*. ргоШуре. ІоАггау; 

9.6.4. Методы сравнения 

Операторы сравнения в языке ЛаѵаЗсгірі сравнивают объекты по ссылке, а не по 
значению. Так, если имеются две ссылки на объекты, то выясняется, ссылаются 
они на один и тот же объект или нет, но не выясняется, обладают ли разные объ¬ 
екты одинаковыми свойствами с одинаковыми значениями. 1 Часто бывает удоб¬ 
ным иметь возможность сравнить объекты на равенство или определить порядок 
их следования (например, с помощью операторов отношения < и >). Если вы опре¬ 
деляете новый класс и хотите иметь возможность сравнивать экземпляры этого 
класса, вам придется определить соответствующие методы, выполняющие срав¬ 
нение. 

В языке программирования Лаѵа сравнение объектов производится с помощью 
методов, и подобный подход можно с успехом использовать в ЛаѵаЗсгірі. Чтобы 
иметь возможность сравнивать экземпляры класса, можно определить метод эк¬ 
земпляра с именем едиа1з(). Этот метод должен принимать единственный аргу¬ 
мент и возвращать 1:гие, если аргумент эквивалентен объекту, метод которого был 
вызван. Разумеется, вам решать, что следует понимать под словом «эквивален¬ 
тен» в контексте вашего класса. Для простых классов часто достаточно просто 
сравнить свойства сопз1:гііс1:ог, чтобы убедиться, что оба объекта имеют один и тот 


1 То есть являются эквивалентными копиями-экземплярами одного класса. - Прим . на- 
уч.ред. 
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же тип, и затем сравнивать свойства экземпляра двух объектов, чтобы убедиться, 
что они имеют одинаковые значения. Класс Сотріех из примера 9.3 как раз обла¬ 
дает таким методом едиа1з(), и для нас не составит труда написать похожий метод 
для класса Рапде: 

// Класс Рапде затирает свое свойство сопзГгіюГог. Поэтому восстановим его. 

Рапде.ргоГоГуре.сопзГгцсГог = Рапде; 

// Объект Рапде не может быть равен никакому другому объекту, не являющемуся 
// диапазоном значений. Два диапазона равны, только если равны значения их границ. 

Рапде.ргоГоГуре. едцаіз = ГцпсГіоп(ГІіаГ) { 

ІГ (ТйаТ == піЛІ) геГцгп Гаізе; // Отвергнуть піЛІ и цпсіеГіпесі 

ІГ (ГІіаГ. сопзГгіюГог !== Рапде) геГцгп Гаізе; // Отвергнуть не диапазоны 

// Вернуть Ггце, если значения границ равны. 

геГцгп Шз.Ггот == ГііаГ.Ггот && Шз.Го == ТНаі.То; 

} 

Задание метода едиа1з() для нашего класса ЗеГ оказывается несколько сложнее. 
Мы не можем просто сравнить свойства ѵаіиез двух множеств - требуется выпол¬ 
нить глубокое сравнение: 

ЗеГ.ргоГоГуре.едцаіз = ^цпсТіоп(ТИаТ) { 

// Сокращенная проверка для тривиального случая 
ІГ (ГІйз === ГііаГ) геГцгп Ггце; 

// Если объект ГйаГ не является множеством, он не может быть равен объекту Гіііз. 

// Для поддержки подклассов класса Зеі: используется оператор іпзГапсеоГ. 

// Мы могли бы реализовать более либеральную проверку, если бы для нас 
// было желательно использовать прием грубого определения типа. 

// Точно так же можно было бы ужесточить проверку, выполняя сравнение 
// Шз.сопзГгцсГог == ГііаГ.сопзГгцсГог. 

// Обратите внимание, что оператор іпзГапсеоГ корректно отвергает попытки 
// сравнения со значениями піЛІ и цпсіеГіпесі 
ІГ (!((№{ іпзГапсеоГ Зеі:)) геГцгп Гаізе; 

// Если два множества имеют разные размеры, они не равны 
ІГ (Шз. 5іге() != Г&аГ. зіге()) геГцгп Гаізе; 

// Теперь требуется убедиться, что каждый элемент в ТПіз также присутствует в ІИаІ:. 
// Использовать исключение для прерывания цикла Гогеасіі, если множества не равны. 

Тгу { 

ГПіз. Гогеасіі(Гцпс1:іоп(ѵ) { ІГ (! ГПаГ. сопТаіпз(ѵ)) ГПгом Таізе; }); 
геГцгп Ггие; // Все элементы совпали: множества равны. 

} саГсіі (х) { 

ІГ (х === Гаізе) геГцгп Гаізе; // Элемент в Гіііз отсутствует в ГПаГ. 

Гіігом х; // Для других исключений: возбудить повторно. 

} 

>: 

Иногда бывает полезно реализовать операции сравнения, чтобы выяснить поря¬ 
док следования объектов. Так, для некоторых классов вполне можно сказать, что 
один экземпляр «меньше» или «больше» другого. Например, объекты Рапде мож¬ 
но упорядочивать, опираясь на значение нижней границы. Типы-перечисления 
можно было бы упорядочивать в алфавитном порядке по именам или в числовом 
порядке - по значениям, присваиваемым именам (предполагается, что именам 
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присваиваются числовые значения). С другой стороны, объекты класса ЗеТ не 
имеют какого-то естественного порядка следования. 

При попытке сравнения объектов с помощью операторов отношения, таких как < 
и <=, интерпретатор сначала вызовет методы ѵаІиеОІЧ) объектов и, если методы 
вернут значения простых типов, сравнит эти значения. Типы-перечисления, воз¬ 
вращаемые методом епитегаТіопО из примера 9.7, имеют метод ѵаІиеОІЧ) и могут 
сравниваться с помощью операторов отношения. Однако большинство классов не 
имеют метода ѵа1иеОГ( ). Чтобы сравнивать объекты этих типов для выяснения по¬ 
рядка их следования по вашему выбору, необходимо (опять же, следуя соглаше¬ 
ниям, принятым в языке программирования Лаѵа) реализовать метод с именем 
сотрагеТо(). 

Метод сотрагеТоО должен принимать единственный аргумент и сравнивать его 
с объектом, метод которого был вызван. Если объект ТНіз меньше, чем объект, 
представленный аргументом, метод сотрагеТо() должен возвращать значение мень¬ 
ше нуля. Если объект Шз больше, чем объект, представленный аргументом, ме¬ 
тод должен возвращать значение больше нуля. И если оба объекта равны, метод 
должен возвращать ноль. Эти соглашения о возвращаемом значении весьма важ¬ 
ны, потому что позволяют выполнять замену операторов отношения следующи- 


ми выражениями: 

Выражение отношения 

Выражение замены 

а < Ь 

а.сотрагеТо(Ь) < 0 

а <= Ь 

а.сотрагеТо(Ь) <= 0 

а > Ь 

а.сотрагеТо(Ь) > 0 

а >= Ь 

а.сотрагеТо(Ь) >= 0 

а == Ь 

а.сотрагеТо(Ь) == 0 

а != Ь 

а.сотрагеТо(Ь) != 0 


Класс Сагсі в примере 9.8 определяет подобный метод сотрагеТоО, и мы можем на¬ 
писать похожий метод для класса Рапде, чтобы упорядочивать диапазоны по их 
нижним границам: 

Рапде. ргоІоІуре.сотрагеТо = ^псИоп^Иа*) { 
геііігп ІМз.Ггот - ІЬаІ.Ггот; 

}; 

Обратите внимание, что вычитание, выполняемое этим методом, возвращает зна¬ 
чение меньше нуля, равное нулю или больше нуля в соответствии с порядком сле¬ 
дования двух объектов Рапде. Поскольку перечисление Сагсі. Рапк в примере 9.8 
имеет метод ѵа1иеОГ(), мы могли бы использовать тот же прием и в методе сотра¬ 
геТоО класса Сагсі. 

Методы ециаІзО, представленные выше, выполняют проверку типов своих аргу¬ 
ментов и возвращают Таізе, как признак неравенства, если аргументы имеют не 
тот тип. Метод сотрагеТоО не имеет специального возвращаемого значения, с по¬ 
мощью которого можно было бы определить, что «эти два значения не могут срав¬ 
ниваться», поэтому обычно методы сотрагеТо() возбуждают исключение при пере¬ 
даче им аргументов неверного типа. 
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Примечательно, что метод сотрагеТо() класса Папде, представленный выше, воз¬ 
вращает 0, когда два диапазона имеют одинаковые нижние границы. Это означа¬ 
ет, что в данной реализации метод сотрагеТо() считает равными любые два диапа» 
зона, которые имеют одинаковые нижние границы. Однако такое определение 
равенства не согласуется с определением, положенным в основу метода ечиаІзО, 
который требует равенства обеих границ. Подобные несоответствия в определе¬ 
ниях равенства могут стать причиной опасных ошибок, и было бы лучше привес¬ 
ти методы ечиаІзО и сотрагеТо() в соответствие друг с другом. Ниже приводится 
обновленная версия метода сотрагеТоО класса Папде. Он соответствует методу 
едиаІзО и дополнительно возбуждает исключение при передаче ему несопостави¬ 
мого значения: 

// Порядок следования диапазонов определяется их нижними границами 

// или верхними границами, если нижние границы равны.Возбуждает исключение, 

// если методу передается объект, не являющийся экземпляром класса Папде. 

// Возвращает 0, только если і;Иіз .ециа1з( 1:Иа1:) возвращает Хгие. 

Папде. ргоІоІуре.сотрагеТо = Гішс1:іоп(і:Па1:) { 

ІГ (!((№( іпзіапсеоі 1 Папде)) 

{Игом п еѵі Еггог("Нельзя сравнить Папде с " + 
ѵаг Рі^Г = ійіз.'Ргот - {На*. {тот; // Сравнить нижние границы 

(РіГГ == 0) РіГ^ = ІПіз.Ііо - *На*.*о; // Если равны, сравнить верхние 

геііігп РіГГ; 

}; 

Одна из причин, по которым может потребоваться сравнивать экземпляры клас¬ 
са, - обеспечить возможность сортировки массива экземпляров этого класса. Ме¬ 
тод Аггау.зоП:() может принимать в виде необязательного аргумента функцию 
сравнения, которая должна следовать тем же соглашениям о возвращаемом зна¬ 
чении, что и метод сотрагеТоО. При наличии метода сотрагеТоО, представленного 
выше, достаточно просто организовать сортировку массива объектов Папде, как 
показано ниже: 

гапдез.зоП( ^ипс1;іоп(а, Ь) { геХигп а.сотрагеТо(Ь); }); 

Сортировка имеет настолько большое значение, что следует рассмотреть возмож¬ 
ность реализации статического метода сравнения в любом классе, где определен 
метод экземпляров сотрагеТоО. Особенно если учесть, что первый может быть лег¬ 
ко реализован в терминах второго, например: 

Папде. ЬуІ_омегВоипсІ = Гііпс1:іоп(а, Ь) { геііігп а.сотрагеТо(Ь); }; 

При наличии этого метода сортировка массива может быть реализована еще про¬ 
ще: 


гапдез. зо г!( Папде. ЬуІ_о\л/егВоипсІ); 

Некоторые классы могут быть упорядочены более чем одним способом. Напри¬ 
мер, класс Сагсі определяет один метод класса, упорядочивающий карты по мас¬ 
ти, а другой - упорядочивающий по значению. 

9.6.5. Заимствование методов 

В методах ЛаѵаЗсгірі нет ничего необычного - это обычные функции, присвоен¬ 
ные свойствам объекта и вызываемые «посредством» или «в контексте» объекта. 
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Одна и та же функция может быть присвоена двум свойствам и играть роль двух 
методов. Мы использовали эту возможность в нашем классе Зеі:, например, когда 
скопировали метод іоАггауО и заставили его играть вторую роль в виде метода 

Ю^СЖ). 

Одна и та же функция может даже использоваться как метод сразу нескольких 
классов. Большинство методов класса Аг гау, например, являются достаточно уни¬ 
версальными, чтобы копировать их из Аггау.ргоіоіуре в прототип своего класса, 
экземпляры которого являются объектами, подобными массивам. Если вы смот¬ 
рите на язык ЛѵаЗсгірі через призму классических объектно-ориентированных 
языков, тогда использование методов одного класса в качестве методов другого 
класса можно рассматривать как разновидность множественного наследования. 
Однако ЛаѵаЗсгірі не является классическим объектно-ориентированным язы¬ 
ком, поэтому я предпочитаю обозначать такой прием повторного использования 
методов неофициальным термином заимствование . 

Заимствоваться могут не только методы класса А г гау: мы можем реализовать соб¬ 
ственные универсальные методы. В примере 9.9 определяются обобщенные мето¬ 
ды іоЗі:гіпд( ) и едиа1з( ), которые с успехом могут использоваться в таких классах, 
как Рапде, Сотріех и СагР. Если бы класс Рапде не имел собственного метода едиа1з( ), 
мы могли бы заимствовать обобщенный метод едиа1з(), как показано ниже: 

Рапде. ргоіоіуре. еццаіз = депегіс.едцаіз; 

Обратите внимание, что метод депегіс.едиа1з() выполняет лишь поверхностное 
сравнение и не подходит для использования в классах, свойства экземпляров ко¬ 
торых ссылаются на объекты с их собственными методами едиа1з(). Отметьте 
также, что этот метод включает специальный случай для обработки свойства, до¬ 
бавляемого к объектам при включении их в множество Зеі (пример 9.6). 

Пример 9.9. Обобщенные методы , пригодные для заимствования 

ѵаг депегіс = { 

// Возвращает строку, включающую имя функции-конструктора, если доступно, 

// и имена и значения всех неунаследованных свойств, не являющихся функциями. 
ГоЗігіпд: ГцпсііопО { 
ѵаг 5 = ' ['; 

// Если объект имеет конструктор и конструктор имеет имя, использовать 
// это имя класса как часть возвращаемой строки. Обратите внимание, что 
// свойство пате функций является нестандартным и не поддерживается повсеместно. 
ІГ (ГГііз.сопзігцсГог && ііііз.сопзігисГог. пате) 
з += ГПіз.сопзігисіог. пате + ": 

// Теперь обойти все неунаследованные свойства, не являющиеся функциями 
ѵаг п = 0; 

Гог(ѵаг пате іп іИіз) { 

ІГ (! ГГііз. Паз0\л/пРгорег1:у(пате)) сопііпце; // пропустить унаслед. 
ѵаг ѵаіце = 1:Гііз[ пате ]; 

ІГ (ГуреоГ ѵаіце === ГипсГіоп") сопііпце; // пропустить методы 
ІГ (п++) з += ", 
з += пате + '=' + ѵаіие; 

} 

геіцгп з + ']'; 

}, 
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// Проверить равенство, сравнив конструкторы и свойства экземпляров объектов Ііііз 
// и ТИаТ. Работает только с классами, свойства экземпляров которых являются 
// простыми значениями и могут сравниваться с помощью оператора ===. 

// Игнорировать специальное свойство, добавляемое классом ЗеТ. 
еццаіз: ГцпсТіопСтйаО { 

ІГ ({На* == піЛІ) ге*цгп Гаізе; 

ІГ (ТИіз.сопзіігіісііог !== ІіГіаІ:. сопзТ гисііог) геішгп Гаізе; 

Гог(ѵаг пате іп *Ніз) { 

іГ (пате === "|**оЬзес1:ісі**|") сопіііпие; // пропустить спец. св. 

ІГ (! ТГііз. ГіазО\А/пРгорег1;у( пате )) сопіііпце; // пропустить унасл. св. 
іГ (*Ніз[пате] !== *На1:[пате]) геітгп Гаізе; // сравнить значения 

} 

геішгп {гце; // Объекты равны, если все свойства равны. 

} 

}; 

9.6.6. Частные члены 

В классическом объектно-ориентированном программировании зачастую целью 
инкапсуляции, или сокрытия данных объектов внутри объектов, является обес¬ 
печение доступа к этим данным только через методы объекта и запрет прямого 
доступа к важным данным. Для достижения этой цели в таких языках, как Лаѵа, 
поддерживается возможность объявления «частных» (ргіѵаіе) полей экземпля¬ 
ров класса, доступных только через методы экземпляров класса и невидимые за 
пределами класса. 

Реализовать частные поля экземпляра можно с помощью переменных (или аргу¬ 
ментов), хранящихся в замыкании, образуемом вызовом конструктора, который 
создает экземпляр. Для этого внутри конструктора объявляются функции (бла¬ 
годаря чему она получает доступ к аргументам и локальным переменным конст¬ 
руктора), которые присваиваются свойствам вновь созданного объекта. Этот при¬ 
ем демонстрируется в примере 9.10, где он используется для создания инкапсули¬ 
рованной версии класса Папде. Вместо простых свойств Ітот и Іо, определяющих 
границы диапазона, экземпляры этой новой версии класса предоставляют мето¬ 
ды Ітот и Іо, возвращающие значения границ. Методы 1тот() и {о() не наследуют¬ 
ся от прототипа, а определяются отдельно для каждого объекта Папде. Остальные 
методы класса Папде определяются в прототипе как обычно, но изменены так, 
чтобы вместо чтения значений границ напрямую из свойств они вызывали бы ме¬ 
тоды 1тот() и *о(). 

Пример 9.10. Класс Капёе со слабо инкапсулированными границами 

Гипсііоп Папде(Ггот, Іо) { 

// Не сохраняет границы в свойствах объекта. Вместо этого определяет функции доступа, 
// возвращающие значения границ. Сами значения хранятся в замыкании. 

{Ніз.Ггот = ГипсІіопО { ге*іігп Ггот; }; 

{Ніз.іо = Гипс1іоп() { геііігп Іо; }; 

} 

// Методы прототипа не имеют прямого доступа к границам: они должны вызывать 
// методы доступа, как любые другие функции и методы. 

Папде. рго*о*уре = { 
сопзігисіог: Папде, 
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іпсіьсіез: Гипсііоп(х) { геііигп Ііііз. Ггот() <= х && х <= ІНіз.ІоО; }, 

ГогеасИ: ГипсІіоп(Г) { 

І'огСѵаг х=Ма1:Іп. сеИ(1;Ыз. Ггот()). тах=*Ііі5.*о(); х <= тах; х++) Г(х); 

}. 

ІоЗігіпд: Гипсіііоп () { геіііігп "(" + 1:Иіз. Ггот() + + *Шз.*о() + ")”; } 

}; 

Новый класс Рапде определяет методы для чтения значений границ диапазона, но 
в нем отсутствуют методы или свойства для изменения этих значений. Это об¬ 
стоятельство делает экземпляры этого класса неизменяемыми : при правильном 
использовании границы объекта Рапде не должны изменяться после его создания. 
Однако если не использовать возможности ЕСМАЗсгірі 5 (раздел 9.8.3), свойства 
Г гот и іо по-прежнему остаются доступными для записи и в действительности 
объекты Рапде не являются неизменяемыми: 

ѵаг г = пей Рапде( 1,5); // "неизменяемый" диапазон 

г.Ітот = Гипсі;іоп () { геіигп 0; }; // Изменчивость имитируется заменой метода 

Имейте в виду, что такой прием инкапсуляции имеет отрицательные стороны. 
Класс, использующий замыкание для инкапсуляции, практически наверняка 
будет работать медленнее и занимать больше памяти, чем эквивалент с простыми 
свойствами. 

9.6.7. Перегрузка конструкторов и фабричные методы 

Иногда бывает необходимо реализовать возможность инициализации объектов 
несколькими способами. Например, можно было бы предусмотреть возможность 
инициализации объекта Сотріех значениями радиуса и угла (полярные координа¬ 
ты) вместо вещественной и мнимой составляющих. Или создавать объекты мно¬ 
жеств Зеі:, членами которых являются элементы массива, а не аргументы конст¬ 
руктора. 

Один из способов реализовать такую возможность заключается в создании пере¬ 
груженных версий конструктора и выполнении в них различных способов ини¬ 
циализации в зависимости от передаваемых аргументов. Ниже приводится при¬ 
мер перегруженной версии конструктора Зеі:: 

^ітсііоп ЗеіО { 

ІІйз.ѵаіиез = {}; // Свойство для хранения множества 
ІПіз.п =0; // Количество значений в множестве 

// Если конструктору передается единственный объект, подобный массиву, 

// он добавляет элементы массива в множество. 

// В противном случае в множество добавляются все аргументы 
ІГ (агдитепііз.ІепдІІі == 1 && ізАггауІ_іке(агдитеп1:5[0])) 

Шз. асісі. арр1у(Шз, агдитеп1:5[0]); 
еізе іГ (агдитепіз.ІепдІП > 0) 

1:Иіз.асісі.арр1у(1:Иі5, агдитепіз); 

} 

Такое определение конструктора ЗеіО позволяет явно перечислять элементы 
множества в вызове конструктора или передавать ему массив элементов мно¬ 
жества. К сожалению, этот конструктор имеет одну неоднозначность: его нельзя 
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использовать для создания множества, содержащего единственный элемент- 
массив. (Для этого потребуется создать пустое множество, а затем явно вызвать 
метод асІсІ( ).) 

В случае с комплексными числами реализовать перегруженную версию конст¬ 
руктора, которая инициализирует объект полярными координатами, вообще не¬ 
возможно. Оба представления комплексных чисел состоят из двух вещественных 
чисел. Если не добавить в конструктор третий аргумент, он не сможет по своим 
аргументам определить, какое представление следует использовать. Однако вме¬ 
сто этого можно написать фабричный метод - метод класса, возвращающий эк¬ 
земпляр класса. Ниже приводится фабричный метод, возвращающий объект 
Сотріех, инициализированный полярными координатами: 

Сотріех. роіаг = ^ипс1:іоп( г. ІНеІа) { 

геіцгп пем Сотр1ех(г*Ма1:Н.со5(1:Не1:а), г*Ма1Н. зіпСіНеІа)); 

}; 

А так можно реализовать фабричный метод для инициализации объекта Зеі: мас¬ 
сивом: 

бе*.ІтотАггау = Рцпс1:іоп(а) { 

5 = пем 8еІ(); // Создать пустое множество 

5.асІсІ.арр1у(5, а); // Передать элементы массива методу асШ 
геіцгп з; // Вернуть новое множество 

}; 

Привлекательность фабричных методов заключается в том, что им можно дать 
любые имена, а методы с разными именами могут выполнять разные виды ини¬ 
циализации. Поскольку конструкторы играют роль имен классов, обычно в клас¬ 
сах определяется единственный конструктор. Однако это не является непрелож¬ 
ным правилом. В языке ЛѵаЗсгірі допускается определять несколько функций- 
конструкторов, использующих общий объект-прототип, и в этом случае объекты, 
созданные разными конструкторами одного класса, будут иметь один и тот же 
тип. Данный прием не рекомендуется к использованию, тем не менее ниже при¬ 
водится вспомогательный конструктор такого рода: 

// Вспомогательный конструктор для класса Зеі: . 

Гітсііоп 8е1РготАггау(а) { 

// Инициализировать новый объект вызовом конструктора 8е1() как функции, 

// передав ей элементы массива в виде отдельных аргументов. 

8е1.арр1у(Шз, а); 

} 

// Установить прототип, чтобы функция БеІРготАггау создавала экземпляры 8е1 
БеІРготАггау.ргоіоіуре = 8е1. ргоіоіуре; 

ѵаг з = пем 8е1РготАггау([1,2,3]); 
з іпзіапсеоі" 8е1 // => Іте 

В ЕСМАЗсгірі 5 функции имеют метод ЬіпсІ(), особенности которого позволяют 
создавать подобные вспомогательные конструкторы (раздел 8.7.4). 
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9.7. Подклассы 

В объектно-ориентированном программировании класс В может расширять , или 
наследовать , другой класс А. Класс А в этом случае называется суперклассом , 
а класс В - подклассом . Экземпляры класса В наследуют все методы экземпляров 
класса А. Класс В может определять собственные методы экземпляров, некоторые 
из которых могут переопределять методы класса А с теми же именами. Если ме¬ 
тод класса В переопределяет метод класса А, переопределяющий метод класса В 
может вызывать переопределенный метод класса А: этот прием называется вызо¬ 
вом метода базового класса . Аналогично конструктор В( ) подкласса может вызы¬ 
вать конструктор А() суперкласса. Это называется вызовом конструктора базово¬ 
го класса . Подклассы сами могут наследоваться другими подклассами и, работая 
над созданием иерархии классов, иногда бывает полезно определять абстракт¬ 
ные классы . Абстрактный класс - это класс, в котором объявляется один или бо¬ 
лее методов без реализации. Реализация таких абстрактных методов возлага¬ 
ется на конкретные подклассы абстрактного класса. 

Ключом к созданию подклассов в языке ЛѵаБсгірі является корректная инициа¬ 
лизация объекта-прототипа. Если класс В расширяет класс А, то объект В. ргоіоіуре 
должен наследовать А.ргоііоііуре. В этом случае экземпляры класса В будут насле¬ 
довать свойства от объекта В. ргоіоіуре, который в свою очередь наследует свойст¬ 
ва от А. р г о* о* у ре. В этом разделе демонстрируются все представленные выше тер¬ 
мины, связанные с подклассами, а также рассматривается прием, альтернатив¬ 
ный наследованию, который называется композицией . 

Используя в качестве основы класс Зеі: из примера 9.6, этот раздел продемонстри¬ 
рует, как определять подклассы, как вызывать конструкторы базовых классов 
и переопределенные методы, как вместо наследования использовать прием ком¬ 
позиции и, наконец, как отделять интерфейсы от реализации с помощью абст¬ 
рактных классов. Этот раздел завершает расширенный пример, в котором опре¬ 
деляется иерархия классов Зеі:. Следует отметить, что первые примеры в этом 
разделе служат цели продемонстрировать основные приемы использования меха¬ 
низма наследования, и некоторые из них имеют существенные недостатки, кото¬ 
рые будут обсуждаться далее в этом же разделе. 

9.7.1. Определение подкласса 

В языке ЛѵаБсгірі объекты наследуют свойства (обычно методы) от объекта-про¬ 
тотипа своего класса. Если объект 0 является экземпляром класса В, а класс В 
является подклассом класса А, то объект 0 также наследует свойства класса А. До¬ 
биться этого можно за счет наследования объектом-прототипом класса В свойств 
объекта-прототипа класса А, как показано ниже, с использованием функции 
іпИегіі:() (пример 6.1): 

В. рго1:о1:уре = іпМегіІ: (А. рго1:о1:уре); // Подкласс наследует суперкласс 

В. рго*о*уре.соп5*гіягЮг = В; // Переопределить унаследованное св. сопзігіісЩг 

Эти две строки являются ключом к созданию подклассов в ^ѵаЗсгірі. Без них 
объект-прототип будет обычным объектом - объектом, наследующим свойства от 
ОЩесІ. ргоіоіуре, - а это означает, что класс будет подклассом класса ОЩесІ, подоб¬ 
но всем остальным классам. Если добавить эти две строки в функцию с!еГіпеС1азз( ) 
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(раздел 9.3), ее можно будет преобразовать в функцию с)е^іпе8иЬс1азз() и в метод 
Рипс1:іоп.рго1:о1:уре.ех1:епсІ(), как показано в примере 9.11. 

Пример 9.11. Вспомогательные инструменты определения подклассов 

// Простая функция для создания простых подклассов 

Рііпсііоп РеРіпеЗііЬсІаззСзирегсІазз, // Конструктор суперкласса 

сопзігіісіог, // Конструктор нового подкласса 

теІИосІз, // Методы экземпл. : копируются в прототип 

зіаіісз) // Свойства класса: копируются в констр-р 

{ 

// Установить объект-прототип подкласса 
сопзігіісіог. ргоіоіуре = іпНегЩзирегсІазз. ргоіоіуре); 
сопзігисіог.ргоіоіуре.сопзігисіог = сопзігисіог; 

// Скопировать методы теІПоРз и зіаіісз, как в случае с обычными классами 
іР (теІПосІз) ехІепсКсопзІгіісІог.ргоіогуре, теІПосІз): 
іР (зіаіісз) ехІепсКсопзІгіісІіог, зіаіісз); 

// Вернуть класс 
геііігп сопзігисіог; 

} 

// То же самое можно реализовать в виде метода конструктора суперкласса 
Рітсиоп.ргоіоіуре.ехіепсі = ^цпсІіопСсопзІгисІіог, теІНосІз, зіаіісз) { 
ге1:игп сІеРіпеЗііЬсІаззСШз, сопз1:гис1:ог, теІПосІз, зіаіісз); 

}; 

Пример 9.12 демонстрирует, как определить подкласс «вручную», без использова¬ 
ния функции с!еТіпе8иЬс1азз( ). В этом примере определяется подкласс ЗіпдІеІіопЗеІ: 
класса 8е1. Класс ЗіпдІеІіопЗеІ: представляет специализированное множество, дос¬ 
тупное только для чтения и состоящее из единственного постоянно элемента. 

Пример 9.12. 8іп&Іеіоп8еі: простой подкласс множеств 

II Функция-конструктор 
І'ііпсііоп ЗіпдІеІопЗеІСтетЬег) { 

ІПіз.тетЬег = тетЬег; // Сохранить единственный элемент множества 

} 

// Создает объект-прототип, наследующий объект-прототип класса Зеі. 

ЗіпдІеІопЗеІ:. ргоіоіуре = іпИегі*(5еі. ргоіоіуре); 

// Далее добавляются свойства в прототип. 

// Эти свойства переопределяют одноименные свойства объекта Зеі. ргоіоіуре. 
ех1:епс1(5іпд1е1:оп5е1:. ргоіоііуре, { 

// Установить свойство сопзігцсіог 
сопзіігисііог: ЗіпдІеіопЗеІ:, 

// Данное множество доступно только для чтения: методы ас!с1() и гетоѵеО 
// возбуждают исключение 

асісі: РипсІіопО { ХЬгоѵі "множество доступно только для чтения"; }, 
гетоѵе: Рііпс1:іоп() { {Игом "множество доступно только для чтения"; }, 

// Экземпляры ЗіпдІеІіопЗеІ: всегда имеют размер, равный 1 
5І2е: ^цпсііоп() { геіііігп 1; }, 

// Достаточно вызвать функцию один раз и передать ей единственный элемент. 

РогеасИ: Гипс1:іоп(сопіехі:) { ГсаЩсопіехі, іИіз. тетЬег); }, 

// Метод сопіаіпзО стал проще: такая реализация пригодна только 
// для множества с единственным элементом 
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сопіаіпз: Гііпс1:іоп(х) { геііігп х === Шз.тетЬег; } 

}): 

Класс ЗіпдІеііопЗеІ: имеет очень простую реализацию, состоящую из пяти простых 
методов. Этот класс не только реализует пять основных методов класса Зеі:, но 
инаследуетот своего суперкласса такие методы, какІоЗітіпдО, іоАггауО иедиа1з(). 
Возможность наследования методов является одной из основных причин опреде¬ 
ления подклассов. Метод едиа1з() класса Зеі: (определен в разделе 9.6.4), напри¬ 
мер, может сравнивать любые экземпляры класса Зеі:, имеющие методы зііеО 
и ГогеасНО, с любыми экземплярами класса Зеі:, имеющими методы зіге() и соп- 
іаіпз(). Поскольку класс ЗіпдІеііопЗеІ: является подклассом класса Зеі:, он автома¬ 
тически наследует его метод едиа1з() и не обязан иметь собственную реализацию 
этого метода. Безусловно, учитывая чрезвычайно упрощенную структуру множе¬ 
ства, содержащего единственный элемент, можно было бы реализовать для клас¬ 
са ЗіпдІеііопЗеІ: более эффективную версию метода едиа1з(): 

ЗіпдІеііопЗеІ:.ргоіоіуре.едііаіз = Гипс1:іоп(1;Іпа1;) { 

геіигп іПаі іпзіапсеоі Зеі: && ІИаі.зіге()==1 && іМаі.сопіаіпз(Ш5. тетЬег); 

}; 

Обратите внимание, что класс ЗіпдІеііопЗеІ: не просто заимствует список методов 
из класса Зеі:: он динамически наследует методы класса Зеі:. Если в Зеі.ргоііоііуре 
добавить новый метод, он тут же станет доступен всем экземплярам классов Зеі: 
и ЗіпдІеііопЗеІ: (в предположении, что класс ЗіпдІеііопЗеІ: не определяет собствен¬ 
ный метод с таким же именем). 

9.7.2. Вызов конструктора и методов базового класса 

Класс ЗіпдІеііопЗеІ: из предыдущего раздела определяет совершенно новый тип 
множеств и полностью переопределяет основные методы, наследуемые от супер¬ 
класса. Однако часто при определении подкласса необходимо лишь расширить 
или немного изменить поведение методов суперкласса, а не заменить их полно¬ 
стью. В этом случае конструктор и методы подкласса могут вызывать конструк¬ 
тор и методы базового класса. 

Пример 9.13 демонстрирует применение этого приема. Он определяет подкласс 
МопМиІІЗе* класса Зеі:: тип множеств, которые не могут содержать элементы со зна¬ 
чениями пиіі и ипсІеГіпесІ. Чтобы исключить возможность включения в множество 
таких элементов, класс МопМиІІЗе* должен выполнить в методе асМ() проверку зна¬ 
чений добавляемых элементов на равенство значениям пиіі и ипсІеГіпед. Но при 
этом не требуется включать в класс полную реализацию метода ас№() - можно 
просто вызвать версию метода из суперкласса. Обратите также внимание, что 
конструктор МопМи118е*() тоже не реализует все необходимые операции: он просто 
передает свои аргументы конструктору суперкласса (вызывая его как функцию, 
а не как конструктор), чтобы конструктор суперкласса мог инициализировать 
вновь созданный объект. 

Пример 9.13. Вызов из подкласса конструктора и метода базового суперкласса 
/* 

* МопМііПЗеІ: - подкласс класса Зеі, который не может содержать элементы 

* со значениями пиіі и ішгіеГіпесІ. 

*/ 
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Іішсііоп МопМіі115е1:() { 

// Простое обращение к суперклассу. 

// Вызвать конструктор суперкласса как обычную функцию для инициализации 
// объекта, который был создан вызовом этого конструктора. 

Зе1.арр1у(Шз, агдшпепіз); 

} 

// Сделать класс МопМіШЗеІ подклассом класса 5е1: 

МопМііПЗеІ:. ргоіоіуре = іпИегЩЗеІ. ргоіоіуре); 

МопМііПЗеІ. ргоіоіуре. сопзігіісіог = МопМііПЗеІ; 

// Чтобы исключить возможность добавления значений піііі и ііпсіеііпесі, 

// достаточно переопределить метод ас!с1() 

ЫопЫи118е1:. рго1:о1:уре. асісі = 1ішс1іоп() { 

// Проверить наличие аргументов со значениями піііі и ііпсіеііпесі 
1ог(ѵаг і = 0; і < агдшпепіз. ІепдІР; і++) 
іі (агдшпепіз[і] == піііі) 

{Игом пем ЕггогС'Нельзя добавить піііі или ііпсіеііпесі в МопМііПЗеІ"); 

// Вызвать метод базового суперкласса, чтобы фактически добавить элементы 
геііігп Зеі. ргоіоіуре. асШ.арр1у(Шз, агдшпепіз); 

}; 


Теперь обобщим понятие ♦множество без пустых элементов» до понятия ♦фильт¬ 
рованное множество»: множество, элементы которого должны пропускаться че¬ 
рез функцию-фильтр перед добавлением. Определим фабричную функцию (по¬ 
добную функции епитегаііоп( ) из примера 9.7), которая будет получать функцию- 
фильтр и возвращать новый подкласс класса Зеі:. В действительности можно пой¬ 
ти еще дальше по пути обобщений и определить фабричную функцию, 
принимающую два аргумента: наследуемый класс и функцию-фильтр, применяе¬ 
мую к методу ас!с1(). Новой фабричной функции можно было бы дать имя Ііііегесі- 
ЗеіЗиЬсІаззО и использовать ее, как показано ниже: 

// Определить класс множеств, которые могут хранить только строки 
ѵаг 8ігіпд8еі = ІіІіегесІЗеіЗііЬсІаззСЗеі, 

Іітсііоп(х) {геііігп Ііурео^ х===”зігіпд";}); 

// Определить класс множеств, которые не могут содержать значения піііі, 

// ипсіе^іпесЗ и функции 

ѵаг Му8еі = І'іііегесІЗеІЗиЬсІаззСЫопЫиІІЗеі:, 

Іітсііоп(х) {геіцгп іуреоі х !== "іипсііоп";}); 

Реализация этой фабричной функции приводится в примере 9.14. Обратите вни¬ 
мание, что эта функция вызывает метод и конструктор базового класса подобно 
тому, как это реализовано в классе МопМііПЗеІ. 

Пример 9.14. Вызов конструктора и метода базового класса 
/* 

* Эта функция возвращает подкласс указанного класса Зеі; и переопределяет 

* метод ас!с1() этого класса, применяя указанный фильтр. 

*/ 

іііпсііоп ІіІіегесІЗеіЗиЬсІаззСзирегсІазз, Ііііег) { 

ѵаг сопзігіісіог = 1ипсііоп() { // Конструктор подкласса 

5іірегс1азз.арр1у(іПі5, агдшпепіз); // Вызов конструктора базового класса 

}; 
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ѵаг ргоіо = сопзігцсіог.ргоіоіуре = іпИегіКзцрегсІазз. ргоіоіуре); 
ргоіо.сопзігцсіог = сопзігцсіог; 
ргоіо. асісі = ГцпсІіопС*) { 

// Примерить фильтр ко всем аргументам перед добавлением 
Гог(ѵаг і = 0; і < агдцтепіз.ІепдІИ; і++) { 
ѵаг ѵ = агдіітеп1:5[і]; 

іГ (! Гі11:ег(ѵ)) ІИ гоѵ\/( "значение + ѵ + отвергнуто фильтром"); 

} 

// Вызвать реализацию метода асШ из базового класса 
зирегсіазз. ргоіоіуре. асЮ. арр1у(Шз, агдцтепіз); 

}; 

геііігп сопзігцсіог; 

} 

В примере 9.14 есть один интересный момент, который хотелось бы отметить. Он 
заключается в том, что, обертывая операцию создания подкласса функцией, мы 
получаем возможность использовать аргумент зирегсіазз в вызовах конструктора 
и метода базового класса и избежать указания фактического имени суперкласса. 
Это означает, что в случае изменения имени суперкласса достаточно будет изме¬ 
нить имя в одном месте, а не отыскивать все его упоминания в программном коде. 
Такого способа стоит придерживаться даже в случаях, не связанных с определе¬ 
нием фабричных функций. Например, с помощью функции-обертки можно было 
бы переписать определение класса МопМиІІЗеІ: и метода Рипсіііоп. ргоііоііуре. ех1:епс!() 
(пример 9.11), как показано ниже: 

ѵаг МопМцПЗе! = (ГипсІіопО { // Определить и вызвать функцию 

ѵаг зцрегсіазз = Зеі; // Имя суперкласса указывается в одном месте, 
геіцгп зцрегсіазз.ехІепсК 

ГцпсІіопО { зцрегсіазз.арр1у(Шз, агдцтепіз); }, // конструктор 
{ // методы 

асісі: Гцпс1:іоп() { 

// Проверить аргументы на равенство пціі или цпгіеГіпес! 

І'огСѵаг і = 0; і < агдцтепіз.ІепдІН; і++) 
іГ (агдцтепі;з[і] == пціі) 

{Игом пем Еггог("Нельзя добавить пціі или цпбеПпесГ ); 

// Вызвать метод базового класса, чтобы выполнить добавление 
геіцгп зцрегсіазз.ргоіоіуре.асісі.арр1у(Шз, агдшлепііз); 

} 

}); 

}()); 

В заключение хотелось бы подчеркнуть, что возможность создания подобных 
фабрик классов обусловлена динамической природой языка ЛѵаЗсгірі. Фабрики 
классов представляют собой мощный и гибкий инструмент, не имеющий анало¬ 
гов в языках, подобных ^ѵа и С++. 

9.7.3. Композиция в сравнении с наследованием 

В предыдущем разделе мы решили определить класс множеств, накладывающий 
ограничения на свои элементы в соответствии с некоторыми критериями, а для 
достижения поставленной цели использовали механизм наследования, опреде¬ 
лив функцию создания специализированного подкласса указанной реализации 
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множества, использующего указанную функцию-фильтр для ограничения круга 
допустимых элементов множества. При таком подходе для каждой комбинации 
суперкласса и функции-фильтра необходимо создавать новый класс. 

Однако существует более простой путь решения этой задачи. В объектно-ориен¬ 
тированном программировании существует известный принцип «предпочтения 
композиции перед наследованием». 1 В данном случае применение приема компо¬ 
зиции могло бы выглядеть как реализация нового множества, «обертывающего» 
другой объект множества и делегирующего ему все обращения после фильтрации 
нежелательных элементов. Пример 9.15 демонстрирует, как это реализовать. 


Пример 9.15. Композиция множеств вместо наследования 


Л 


* Объект РПРегебЗеР обертывает указанный объект множества и применяет 

* указанный фильтр в своем методе абсК). Обращения ко всем остальным базовым 

* методам просто передаются обернутому экземпляру множества. 

*/ 

ѵаг РіІРегесІЗеР = ЗеР.ехРепсК 

РішсРіоп РіІРегесІЗеР (зеР, РіІРег) { // Конструктор 
РПіз.зеР = зеР; 

РМз. РіІРег = РіІРег; 


}. 

{ // Методы экземпляров 

асШ: РііпсРіоп() { 

// Если фильтр был указан, применить его 
іР (Шз. РіІРег) { 

Рог(ѵаг і = 0; і < агділпепРз. ІепдРИ; і++) { 
ѵаг ѵ = агдіітепРз[і]; 
іР (! Шз. РіІРег(ѵ)) 

РИгом пем Еггог( "РіІРегесІЗеР: значение + ѵ + 

отвергнуто фильтром"); 

} 

} 

// Затем вызвать метод ас1с1() объекта РИіз. зеР. ас!с1() 

Шз.зеР.асІсІ.арр1у(РНі5.зеР, агдіітепРз); 
геРіігп РРіз; 


}, 

// Остальные методы просто вызывают соответствующие 
// методы объекта РИіз.зеР и ничего более, 
гетоѵе: РііпсРіоп() { 

РИіз. зеР. геітюѵе. арр1у(РРіз. зеР, агдшпепрз); 
геРіігп РРііз; 

). 

сопРаіпз: РішсРіоп(ѵ) { геРигп РИіз.зеР.сопРаіпз(ѵ); }, 
зіге: РііпсРіоп() { геРіігп РИіз.зеР.зіге(); }, 

РогеасИ: РітсРіоп(Р,с) { РРіз.зеР.РогеасР(Р.с); } 


і 


См. Э. Гамма и др. «Приемы объектно-ориентированного проектирования. Паттерны 
проектирования» или Дж. Блох «^ѵа. Эффективное программирование». 
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Одно из преимуществ применения приема композиции в данном случае заключа¬ 
ется в том, что требуется определить только один подкласс РШегесІЗеІ:. Экземпля¬ 
ры этого класса могут накладывать ограничения на элементы любого другого эк» 
земпляра множества. Например, вместо класса МопМиІІЗеІ:, представленного вы¬ 
ше, реализовать подобные ограничения можно было бы так: 

ѵаг 5 = пем РШегесІЗеІ: (пем ЗеіО, Рііпс1:іоп(х) { геіигп х !== гшіі; }); 

Можно даже наложить еще один фильтр на фильтрованное множество: 

ѵаг I = пем РШегесІ5е1:(з, { Гііпс1:іоп(х} { геііігп !(х іпзІапсеоГ Зеі:); }); 

9.7.4. Иерархии классов и абстрактные классы 

В предыдущем разделе было предложено «предпочесть композицию наследова¬ 
нию». Но для иллюстрации этого принципа мы создали подкласс класса Зеі:. Сде¬ 
лано это было для того, чтобы получившийся подкласс был іпзііапсеоР Зеі: и насле¬ 
довал полезные методы класса Зеі:, такие как *о8*гіпд() и ечиа1з(). Это достаточно 
уважительные причины, но, тем не менее, было бы неплохо иметь возможность 
использовать прием композиции без необходимости наследовать некоторую опре¬ 
деленную реализацию множества, такую как класс Зеі:. Аналогичный подход 
можно было бы использовать и при создании класса ЗіпдІеІопЗеІ: (пример 9.12) - 
этот класс был определен как подкласс класса Зеі:, чтобы унаследовать вспомога¬ 
тельные методы, но его реализация существенно отличается от реализации су¬ 
перкласса. Класс ЗіпдШопЗеІ: - это не специализированная версия класса Зеі:, 
а совершенно иной тип множеств. В иерархии классов ЗіпдШопЗеІ: должен был бы 
находиться на одном уровне с классом Зеі:, а не быть его потомком. 

Решение этой проблемы в классических объектно-ориентированных языках, 
а также в языке ЛѵаЗсгірі заключается в том, чтобы отделить интерфейс от реа¬ 
лизации. Представьте, что мы определили класс АЬзігасЕЗеІ, реализующий вспо¬ 
могательные методы, такие как *о5*гіпд( ), в котором отсутствуют реализации ба¬ 
зовых методов, таких как ГогеасМ(). Тогда все наши реализации множеств - Зеі:, 
ЗіпдШопЗеІ: и РШегесІЗеІ: - могли бы наследовать класс АЬзігасіЗеІ. При этом клас¬ 
сы РШегесІЗеІ: и ЗіпдІеЮпЗеІ: больше не наследовали бы ненужные им реализации. 

Пример 9.16 развивает этот подход еще дальше и определяет иерархию абстракт¬ 
ных классов множеств. Класс АЬзІгасіЗеІ: определяет только один абстрактный 
метод, соп*аіпз(). Любой класс, который претендует на роль множества, должен 
будет определить хотя бы один этот метод. Далее в примере определяется класс 
АЬзІгасІЕпитегаЫеЗеІ, наследующий класс АЬзІгасіЗе*. Этот класс определяет аб¬ 
страктные методы зігеО аші ГогеасМО и реализует конкретные вспомогательные 
методы (*оЗ*гіпд(), ЮАггауО, ериа1з() и т.д.). АЬзІгасІЕпитегаЫеЗеІ: не определяет 
методы ас1с1() или гетоѵе() и представляет класс множеств, доступных только для 
чтения. Класс ЗіпдІеІопЗеІ: может быть реализован как конкретный подкласс. 
Наконец, в примере определяется класс АЬзІгасІМгііаЬІеЗеІ:, наследующий АЬ$1> 
гасгЕЕпитегаЫеЗеІ:. Этот последний абстрактный класс определяет абстрактные 
методы ас!с1() и гетоѵе( ) и реализует конкретные методы, такие как ііпіоп( ) и іпі:ег- 
зесІіопО, использующие их. Класс АЬзІгасІМШаЬІеЗеІ: отлично подходит на роль 
суперкласса для наших классов Зеі: и РШегесІЗеІ:. Однако они не были добавлены 
в пример, а вместо них была включена новая конкретная реализация с именем 
АггауЗеІ:. 
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Пример 9.16 довольно объемен, но он заслуживает детального изучения. Обрати¬ 
те внимание, что для простоты создания подклассов в нем используется функция 
Рипсіііоп. ргоіоіуре. ех1:епсІ( ). 

Пример 9.16. Иерархия абстрактных и конкретных классов множеств 

// Вспомогательная функция, которая может использоваться для определения 
// любого абстрактного метода 

^цлсИоп аЬзІгасІтеІНосК ) { ХЬгоѵі пем Е г го г ("абстрактный метод"); } 

Л 

* Класс АЬзігасіЗеі определяет единственный абстрактный метод, сопІаіпзО. 

*/ 

Рііпс1:іоп АЬзІгасіЗеІіО { 

{Игом пем Еггог("Нельзя создать экземпляр абстрактного класса"); 

} 

АЬзггасІіВеІ.ргоІогуре.сопІаіпз = аЬзІгасІтеІИосІ; 

Л 

* ИоІЗеІ: - конкретный подкласс класса АЬзігасіЗеі. 

* Элементами этого множества являются все значения, которые не являются 

* элементами некоторого другого множества. Поскольку это множество 

* определяется в терминах другого множества, оно не доступно для записи, 

* а так как оно имеет бесконечное число элементов, оно недоступно для перечисления. 

* Все, что позволяет этот класс, - это проверить принадлежность к множеству. 

* Обратите внимание, что для определения этого подкласса используется метод 

* Рііпсііоп.ргоІоІуре.ехІепсК), объявленный выше. 

*/ 

ѵаг ИоІЗеІ: = АЬзігасі8е1.ехІепб( 

^ііпсііоп ЫоІЗеІ: ( зеі) { Шз.зе* = зеі:; }, 

{ 

сопіаіпз: ^ипсііоп(х) { геііігп !Шз.зе1:.соп1:аіпз(х); }, 

ІоЗІгіпд: ^ііпсііопСх) { геішгп """ + Шз.зеі.ІоЭігіпдС); }, 
ецііаіз: ^цпсиопСіНаІ:) { 

геішгп гПаІ: іпзІапсеоР МоіЗеі && іНіз.зеі.едцаІзСІИаІ.зе*); 

} 

} 

); 

Л 

* АЬзІгасІЕпшпегаЫеЗеІ: - абстрактный подкласс класса АЬзІгасІЗеІ:. 

* Определяет абстрактные методы зігеО и ^огеасИО и реализует конкретные 

* методы ізЕтрІуО, ІоАггауО, 1о[ Ьосаіе]31; гіпд() и ецііаІзО. 

* Подклассы, реализующие методы сопІаіпзО, зігеО и ^огеасНО, 

* получают эти пять конкретных методов даром. 

*/ 

ѵаг АЬзІгасІЕпіітегаЫеЗеІ: = АЬзІгас18е1.ехІепб( 

^цпсііопО { 

{Игом пем Еггог("Нельзя создать экземпляр абстрактного класса"); 

}. 

{ 

зіге: аЬзІгасІтеІИосІ, 

ІчкеасИ: аЬзІгасІтеІИосІ, 

ізЕтрІу: ^ітсІіопО { геііігп Шз.зігеО == 0; }, 

ІоЗІгіпд: ^цпсиопО { 
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ѵаг $="{”. і = 0; 

ГЬіз. ГогеасЬ(ГипсГіоп(ѵ) { 

ІГ (і++ > 0) з += ", 
з += ѵ; 

}); 

геГигп з + 

}. 

ГоІ_оса1еЗГгіпд : ГипсГіоп() { 
ѵаг з = "{", і = 0; 

ГЬіз. ГогеасЬ(ГипсГіоп(ѵ) { 

іГ (і++ > 0) з += ", 

іГ (ѵ == гиЛІ) з += ѵ; // гшіі и ііпсІеГіпесІ 
еізе з += ѵ. ГоІ_оса1еЗГгіпд(); // все остальные 

}); 

геГигп з + 

}. 

ГоАггау: ГііпсГіоп() { 
ѵаг а = []; 

ГЬіз. ГогеасЬ(ГііпсГіоп(ѵ) { а.ризЬ(ѵ); }); 
геГигп а; 

}, 

едиаіз: ГипсГіоп(ГЬаГ) { 

іГ (!(ГЬаГ іпзГапсеоГ АЬзГгасГЕпитегаЫеЗеГ)) геГигп Гаізе; 

// Если множество ГЬаГ имеет другой размер, множества не равны 
іГ (ГЬіз.зігеО != ГЬаГ.зігеО) геГигп Гаізе; 

// Проверить наличие каждого элемента ГЬіз в множестве ГЬаГ. 

Ггу { 

ГЬіз.ГогеасЬ(ГипсГіоп(ѵ){ 

іГ (!ГЬаГ.сопГаіпз(ѵ)) ГЬгом Гаізе;} 

); 

геііігп Ггце; // Все элементы одинаковые: множества равны. 

} саГсЬ (х) { 

іГ (х === Гаізе) геііігп Гаізе; // Множества не равны 

ГН гом х; // Повторно возбудить любое иное возникшее исключение. 

} 

} 

}); 

Л 

* ЗіпдІеГопЗеГ - конкретный подкласс класса АЬзГгасГЕпитегаЫеЗеГ. 

* Множество из единственного элемента, доступное только для чтения. 

V 

ѵаг ЗіпдІеГопЗеГ = АЬзГгасГЕпшпегаЫеЗеГ.ехГепсК 

ГипсГіоп ЗіпдІеГопЗеГ(тетЬег) { ГЬіз.тетЬег = тетЬег; }, 

{ 

сопГаіпз: ГітсГіоп(х) { геГіігп х === ГЬіз.тетЬег; }, 
зіге: ГипсГіопО { геГіігп 1; }, 

ГогеасЬ: ГипсГіоп(Г,сГх) { Г.са11(сГх, ГЬіз.тетЬег); } 

} 

); 


/* 

* АЬзГгасГІл/гіГаЫеЗеГ - абстрактный подкласс класса АЬзГгасГЕпіітегаЫеЗеГ. 

* Определяет абстрактные методы ас1с1() и гетоѵе() и реализует конкретные 

* методы ііпіоп(), іпГегзесГіоп() и с!іГГегепсе(). 
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*/ 

ѵаг АЬзІгасІМгііаЬІеЗеІ = АЬз1:гас1:ЕпшпегаЫе$е1:. ех1:епс1( 

^цпсІіопО { 

ІЬгом пем Е г го г( "Нельзя создать экземпляр абстрактного класса"); 

}. 

{ 

асЮ: аЬзІгасІтеІЬосІ, 
гетоѵе: аЬзІ: гасите! Ьосі, 
цпіоп: ^ипсііоп(іііаі) { 
ѵаг зеіі 1 = Шз; 

1:На'Ы : огеасЬ(1 : ипс1:іоп(ѵ) { зеіі 1 .ас!с1(ѵ); }); 
геіигп Шз; 

}, 

іпіегзесііоп: ^ипсііоп(іііаі) { 
ѵаг зеіі 1 = ІНіз; 

ІЬіз. 1 : огеасЬ(1 : ипс1:іоп(ѵ){ і?(Шіаі.сопіаіп8(ѵ)) зеіі 1 . гетоѵе(ѵ);}); 
геіцгп ІЫз; 

}, 

сІі'Г'Гегепсе: ^ипсііоп(іііаі) { 
ѵаг зеіі 1 = ІЫз; 

ІІіаі. "ГогеасІіС^ипсІіопСѵ) { зеіі 1 . гетоѵе(ѵ); }); 
геіьгп Шз; 

} 

}); 

/* 

* АггауЗе* - конкретный подкласс класса АЬзІгасІМгііаЬІеЗеІ. 

* Представляет множество элементов как массив значений и реализует линейный 

* поиск в массиве в своем методе сопШпз(). Поскольку алгоритм метода сопШпзО 

* имеет сложность 0(п) вместо 0(1), данный класс следует использовать только 

* для создания относительно небольших множеств. 

* Обратите внимание, что эта реализация опирается на методы класса Аггау 

* іпсІехОІЧ) и ^огЕасИО, которые определяются стандартом Е85. 

*/ 

ѵаг АггауЗеІ: = АЬзІгасІМгіі:аЬ1е$е1:.ех1:епсі( 

^цпсііоп АггауЗеК) { 

Шз.ѵаіьез = []; 

Шз.асісі.аррІуСШз, агдшпепіз); 

}, 

{ 

сопШпз: ^цпсііопСѵ) { геіцгп Шз. ѵаіьез. іпсІехОІЧѵ) != -1; }, 
зіге: І'ипсІіопО { геШп Шз.ѵаіьез. ІепдШ }, 

ШеасН: ^цпсЫопС^.с) { Шз.ѵаіьез. “ГогЕасИС “Г, с); }, 
асісі: ^цпсиопО { 

ШСѵаг і = 0; і < агдцтепіз. ІепдІЬ; і++) { 
ѵаг агд = агділпепІзЦ]; 

ІТ (ІШз.сопШпзСагд)) Шз.ѵаіьез.рцзЬ(агд); 

} 

геіцгп Шз; 

}. 

гетоѵе: І'ипсІіопО { 

1Ч)г(ѵаг і = 0; і < агдцтепіз. ІепдШ і++) { 
ѵаг р = Шз.ѵаіьез. Іпс1ех01 : (агдитеп1:з[і]); 
і? (р == -1) сопі:іпііе; 
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Шз. ѵаіцез. зр1ісе(р, 1); 

} 

геіцгп Шз; 

} 

} 

): 

9.8. Классы в ЕСМАЗсгірі: 5 

Стандарт ЕСМАЗсгірі 5 добавляет методы, позволяющие определять атрибуты 
свойств (методы чтения и записи, а также признаки доступности для перечисле¬ 
ния, записи и настройки) и ограничивать возможность расширения объектов. Эти 
методы были описаны в разделах 6.6, 6.7 и 6.8.3 и могут пригодиться при опреде¬ 
лении классов. В следующих подразделах демонстрируется, как использовать но¬ 
вые возможности ЕСМАЗсгірі 5 для повышения надежности своих классов. 

9.8.1. Определение неперечислимых свойств 

Класс Зе!, представленный в примере 9.6, вынужден использовать уловку, чтобы 
обеспечить возможность сохранения объектов: он добавляет свойство «оЪіесі ісі» 
ко всем объектам, добавляемым в множество. Если позднее в каком-то другом 
месте программы будет выполнен обход свойств этого объекта с помощью цикла 
Гог/іп, это свойство будет обнаружено. Стандарт ЕСМАЗсгірі 5 позволяет исклю¬ 
чить такую возможность, сделав свойство неперечислимым. В примере 9.17 де¬ 
монстрируется, как это сделать с помощью 0Ь]ес1:.РеГіпеРгорегі:у(), а также пока¬ 
зывает, как определить метод чтения и как проверить возможность расширения 
объекта. 

Пример 9.17 ’ Определение неперечислимых свойств 

// Обертывание программного код функцией позволяет определять переменные 
// в области видимости функции 
(іііпс1:іоп( ) { 

// Определить свойство оЬ^есІІР как неперечислимое и наследуемое 
// всеми объектами. При попытке получить значение этого свойства 
// вызывается метод чтения. Свойство не имеет метода записи, поэтому 
// оно доступно только для чтения. Свойство определяется как ненастраиваемое, 

// поэтому его нельзя удалить. 

ОЬіесІ. сІеГіпеРгоре г1:у(0Ьзес1:. ргоііоіуре, "оЬз есіісі ", { 

деі: іРСеІІег, // Метод чтения значения 

епіітегаЫе: Гаізе, // Неперечислимое 
соп^ідіігаЫе: Гаізе // Не может быть удалено 

}); 

// Функция чтения, которая вызывается при попытке получить значение 
// свойства оІ^есІІР 

Гііпсііоп іР6еІІег() { // Функция чтения, возвращающая ІР 

іГ (!(іРргор іп ІНіз)) { // Если объект еще не имеет ІР 

іГ (! ОЬіесІ. ізЕхІепзіЫеСіНіз)) // И если можно добавить свойство 
ІЬгоѵі Еггог("Нельзя определить ІР нерасширяемого объекта”); 
0Ьіес1:.РеГіпеРгорег1у(ІІіі8, ІРргор, { // Добавить его. 

ѵаіье: пех1ір++, // Значение 
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ѵтіІаЬІе: ^аізе, // Только для чтения 
епитегаЫе: ^аізе, // Неперечислимое 
сопІ'ідигаЫе: Шзе // Неудаляемое 

}): 

} 

геіигп 1Иіз[ісіргор]; // Вернуть существующее или новое значение 

}; 

// Следующие переменные используются функцией ісІСеІІегС) и являются 
// частными для этой функции 

ѵаг ісіргор = "|**оЬзес1:ІсІ**|"; // Предполагается, что это свойство 

// больше нигде не используется 
ѵаг пехЫР = 1; // Начальное значение для іР 

}()); // Вызвать функцию-обертку, чтобы выполнить программный код 

9.8.2. Определение неизменяемых классов 

Помимо возможности делать свойства неперечислимыми, стандарт ЕСМАЗсгірі 5 
позволяет делать свойства доступными только для чтения, что может быть до¬ 
вольно удобно при создании классов, экземпляры которых не должны изменять¬ 
ся. В примере 9.18 приводится неизменяемая версия класса Рапде, который ис¬ 
пользует эту возможность, применяя функции 0Ь]ес1:.Ре1 : іпеРгорег1:іез() и 0Ь]ес1:. 
сгеаІеО. Кроме того, функция ОЬ^есІ.РеІ'іпеРгорегіііезО используется в нем также 
для добавления свойств в объект-прототип класса, что делает методы экземпля¬ 
ров недоступными для перечисления, подобно методам встроенных классов. Но 
и это еще не все: определяемые в примере методы экземпляров создаются доступ¬ 
ными только для чтения и не могут быть удалены, что исключает возможность 
динамического изменения класса. Наконец, в примере 9.18 использован один ин¬ 
тересный трюк - при вызове без ключевого слова пем функция-конструктор клас¬ 
са действует как фабричная функция. 

Пример 9.18. Неизменяемый класс со свойствами и методами, 

доступными только для чтения 

// Эта функция может работать и без ключевого слова 'пем': она одновременно 
// является и конструктором, и фабричной функцией 
І'ііпсііоп Рапде(1тот, Іо) { 

// Дескрипторы свойств Ітот и Іо, доступных только для чтения, 
ѵаг ргорз = { 

Ітот: {ѵаіце : Ітот, епитегаЫе:1гііе,мгіІаЫе:Шзе,соп^ідигаЫе:Шзе}, 

Іо: {ѵа1це:1:о, епитегаЫе :1гие, мгііаЫе^аІзе, соп^ідцгаЫе^аІзе} 

}; 

іТ (Шз іпзіапсеоі 1 Рапде) // Если вызвана как конструктор 

ОЬзесІ.РеІтпеРгорегІіезСіЫз, ргорз): // Определить свойства 
еізе // Иначе как фабричная функция 

геіигп ОЬзесІ.сгеаІеСРапде.ргоіоіуре, // Создать и вернуть новый 

ргорз): // объект Рапде со свойствами 

} 

// Если добавлять свойства в объект Рапде.ргоіоіуре тем же способом, можно будет 
// определить атрибуты этих свойств. Поскольку мы не указываем атрибуты епитегаЫе, 

// мгііаЫе и сопНдигаЫе, они по умолчанию получают значение І'аізе. 
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ОЬзесІ.Ре^іпеРгорегііез^апде.ргоіоіуре, { 
іпсіисіез: { 

ѵаіие: Гипс*іоп(х) { геіигп ІНіз.Ітот <= х && х <= ІНіз.Іо; } 

>. 

геасИ: { 

ѵаіие: ?ипс*іоп(0 { 

^ог(ѵаг х = МаіН.сеіЦіНіз. Ігот); х <= ІНіз.Іо; х++) Г(х); 

} 

}, 

ІоЗігіпд: { 

ѵаіие: І^псІіопО { геіигп "(” + ІНіз.Ігот + "..." + ІИіз.Іо + } 

} 

}); 

Для определения неизменяемых и неперечислимых свойств в примере 9.18 ис¬ 
пользуются функции 0Ь]ес1:.с1еГіпеРгорег1:іез() и ОЬзесГ.сгеаГеО. Они предоставля¬ 
ют широкие возможности, но необходимость определять для них объекты деск¬ 
рипторов свойств может сделать программный код более сложным для чтения. 
Чтобы избежать этого, можно определить вспомогательные функции для измене¬ 
ния атрибутов свойств, которые уже были определены. Две такие вспомогатель¬ 
ные функции демонстрируются в примере 9.19. 

Пример 9.19. Вспомогательные функции для работы с дескрипторами свойств 

// Делает указанные (или все) свойства объекта о 
// недоступным для записи и настройки. 

І'ипсііоп 1тее2еРгор5(о) { 

ѵаг ргорз = (агдитепііз.ІепдІН == 1) // Если один аргумент, 

? ОЬ^есІ:.деЮмпРгорегі:у№те5(о) // изменить все свойства, 

: Аггау. ргоіоіуре.зріісе.саЩагдитепІз, 1): // иначе только указанные 
ргорз. ^огЕасМС^ипсІіопСп) { // Делает каждое свойство ненастраиваемым 

// и доступным только для чтения 
// Пропустить ненастраиваемые свойства 

іГ (ІОЬзесІ.деіОѵ/пРгорегІуОезсгірІогСо, п). соп^ідигаЬІе) геіигп; 

ОЬзесІ:.с!еГіпеРгорегі;у(о, п, { мгіІаЫе: Гаізе, сопІЧдигаЫе: Шзе }); 

}); 

геіигп о; // Чтобы можно было продолжить работу с объектом о 

} 

// Делает неперечислимыми указанные (или все) свойства объекта о, 

// если они доступны для настройки. 

І^псііоп ПісІеРгорз(о) { 

ѵаг ргорз = (агдитепіз.ІепдіН == 1) // Если один аргумент, 

? О^есі.деЮ\л/пРгорегі:уИатез(о) // изменить все свойства, 

: Аггау.ргоіоіуре.зріісе.саЩагдитепіз, 1): // иначе только указанные 
ргорз. 1 = огЕасН(1 : ипс1:іоп(п) { // Скрыть каждое от цикла Гог/іп 

// Пропустить ненастраиваемые свойства 

іГ (!ОЬ}ес1.деІО\л/пРгорегі:уОе5сгір1:ог(о, п).соп^ідигаЫе) геіигп; 

ОЬзесІ:.с!еГіпеРгорег1:у(о, п, { епитегаЫе: Шзе }); 

}); 

геіигп о; 

} 

Функции 0Ь]есГ.с1еГіпеРгорег1:у() и 0Ь]ес1:.с1еГіпеРгорегІіе$() могут использоваться 
и для создания новых свойств, и для изменения атрибутов уже существующих 
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свойств. При создании новых свойств все опущенные атрибуты по умолчанию 
принимают значение іаізе. Однако при изменении атрибутов уже существующих 
свойств опущенные атрибуты не изменяются. Например, в функции ІіісіеРгорзО 
выше указывается только атрибут епитегаЫе, потому что функция должна изме¬ 
нять только его. 

С помощью этих двух функций можно писать определения классов с использова¬ 
нием преимуществ ЕСМАЗсгірі 5, без существенного изменения привычного сти¬ 
ля определения классов. В примере 9.20 приводится определение неизменяемого 
класса Вапде, в котором используются наши вспомогательные функции. 

Пример 9.20. Более простое определение неизменяемого класса 

іііпсііоп Вапде(ігот, Іо) { // Конструктор неизменяемого класса Вапде 

іМіз.ігот = ігот; 
іМіз.іо = Іо; 

ігее 2 еРгорз(іМіз); // Сделать свойства неизменяемыми 

} 

Вапде.ргоіоіуре = МіРеРгорз({ // Определить неперечислимые свойства прототипа 
сопзігцсіог: Вапде, 

іпсііісіез: іыпсііоп(х) { геііігп іМіз.ігот <= х && х <= іМіз.іо; }, 
іогеасМ: іипсііоп(і) {іог(ѵаг х=МаіМ.сеі1(іЬіз. ігот); х<=Шз. Іо; х++) ^(х);}. 
іоЭігіпд: іцпсііоп() { геііігп "(" + іМіз.ігот + + іМіз.іо + ")"; } 

}): 

9.8.3. Сокрытие данных объекта 

В разделе 9.6.6 и в примере 9.10 было показано, как можно использовать перемен¬ 
ные и аргументы функции-конструктора для сокрытия данных объекта, созда¬ 
ваемого этим конструктором. Недостаток этого приема заключается в том, что 
в ЕСМАЗсгірі 3 допускается возможность замещения методов доступа к этим 
данным. Стандарт ЕСМАЗсгірі 5 позволяет обеспечить более надежное сокрытие 
частных данных за счет определения методов доступа к свойствам, которые не 
могут быть удалены. Этот способ демонстрируется в примере 9.21. 

Пример 9.21. Класс Еап§е со строго инкапсулированными границами 

// Эта версия класса Вапде является изменяемой, но она следит за своими 
// границами, обеспечивая выполнение условия Ігот <= Іо. 
іипсііоп Вапде(ігот, Іо) { 

// Проверить соблюдение условия при создании 

іі (ігот > Іо) іНгом пем Еггог( "Вапде: значение ігот должно быть <= Іо"); 

// Определение методов доступа, которые следят за соблюдением условия 
іііпсііоп деіРгот() { геііігп ігот; } 
іііпсііоп деіТо() { геіцгп іо; } 

іцпсііоп зеіРгот(і) { // Не позволяет устанавливать значение ігот > іо 
іі (і <= іо) ігот = і; 

еізе іМгом пем Еггог("Вапде: значение ігот должно быть <= іо"); 

} 

іііпсііоп зеіТо(і) { // Не позволяет устанавливать значение іо < ігот 

іі (і >= ігот) іо = і; 

еізе іНгом пем Еггог("Вапде: значение іо должно быть >= ігот"); 

} 
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// Создать перечислимые, ненастраиваемые свойства с методами доступа 
ОЬзесІ.сІеІ'іпеРгорегиезСШз, { 

Ітот: {де* : де* Ргот, зе*:зе*Ргот, епитегаЫе:*гие, соп*ідигаЫе:*а1зе}, 

*о: { де*: де*То, зе*: зе*То, епитегаЫе:*гие, соп^ідіігаЬІеіШзе } 

}); 

} 

// Настройка объекта-прототипа осталась такой же, как и в предыдущих примерах. 

// Обращение к методам экземпляров чтения свойств *гот и *о выполняется так, 

// как если бы они были простыми свойствами. 

Рапде.рго*о*уре = НіРеРгорз({ 
сопз*гис*ог: Рапде, 

іпсііісіез: *ипс*іоп(х) { ге*игп *Ніз.*гот <= х && х <= *Ніз.*о: }, 

*огеасН: *ипс*іоп(*) {*ог(ѵаг х=Ма*Н.сеі1(*Ніз. Ггот); х<=*Ніз. *о:х++) *(х);}, 
*оЗ*гіпд: *ипс*іоп() { ге*игп "(" + Шз.Ггот + ”..." + *Ніз.*о + } 

}); 

9.8.4. Предотвращение расширения класса 

Возможность расширения классов за счет добавления новых методов в объект- 
прототип обычно рассматривается как характерная особенность языка ЛѵаВсгірі. 
Стандарт ЕСМАВсгірі 5 позволяет при желании предотвратить такую возмож¬ 
ность. Функция ОЬ]ес*.ргеѵеп*Ех*епзіопз() делает объект нерасширяемым (раз¬ 
дел 6.8.3) - в такой объект невозможно добавить новые свойства. Функция 0Ь]ес*. 
$еа1() идет еще дальше: она не только предотвращает добавление новых свойств, 
но и делает все имеющиеся свойства ненастраиваемыми, предотвращая возмож¬ 
ность их удаления. (Однако ненастраиваемое свойство по-прежнему может быть 
доступно для записи и по-прежнему может быть преобразовано в свойство, дос¬ 
тупное только для чтения.) Чтобы предотвратить возможность расширения объ¬ 
екта ОЬ^ес*. рго*о*уре, можно просто записать: 

ОІ^ес*. зеа1(0Ь]ес*. рго*о*уре): 

Другая динамическая особенность языка ЛѵаВсгірі - возможность замены мето¬ 
дов объекта: 

ѵаг огідіпа1_зог*_те*МосІ = Аггау.рго*о*уре.зог*; 

Аггау.рго*о*уре.зог* = *ітс*іоп() { 
ѵаг з*аг* = пем йа*е(); 
огідіпа1_зог*_те*ИосІ.арр1у(*Иіз, агдитеп*з); 
ѵаг епр = пем Оа*е(); 

сопзоіе. 1од("Сортировка массива заняла " + (епР - з*аг*) + 

миллисекунд.”); 

}; 

Предотвратить такую замену можно, объявив методы экземпляров доступными 
только для чтения. Сделать это можно с помощью вспомогательной функции 
ГгееіеРгорзО, объявленной выше. Другой способ добиться этого эффекта заклю¬ 
чается в использовании функции 0Ь]ес*.Ггее2е(), которая выполняет те же дейст¬ 
вия, что и функция 0Ь]ес*. зеа1(), и дополнительно делает все свойства ненастраи¬ 
ваемыми и доступными только для чтения. 

Свойства, доступные только для чтения, обладают одной особенностью, о кото¬ 
рой необходимо помнить при работе с классами. Если объект о наследует свойство 
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р, доступное только для чтения, попытка присвоить значение свойству о.р будет 
завершаться неудачей без создания нового свойства в объекте о. Если потребуется 
переопределить унаследованное свойство, доступное только для чтения, можно 
воспользоваться функциями 0Ь]ес1:.с1е1 : іпеРгорег1:у(), ОЬ^есІ:.сІе^іпеРгорегіііезС) или 
ОЬ^есІ:.сгеа1:е(), чтобы создать новое свойство. Это означает, что, когда методы эк¬ 
земпляров класса делаются доступными только для чтения, это существенно ос¬ 
ложняет возможность их переопределения в подклассах. 

На практике обычно не требуется блокировать возможность изменения объектов- 
прототипов таким способом, но в некоторых случаях предотвращение расшире¬ 
ния объектов может оказаться полезным. Вспомните фабричную функцию епите- 
гаіііоп () из примера 9.7. Она сохраняет все экземпляры перечислений в свойствах 
объекта-прототипа и в свойстве-массиве ѵа1ію$ конструктора. Эти свойства и мас¬ 
сив играют роль официального перечня экземпляров перечислений, и их опреде¬ 
ленно имеет смысл зафиксировать, чтобы исключить возможность добавления 
новых экземпляров и изменения или удаления существующих. Для этого доста¬ 
точно добавить в функцию епитега1:іоп( ) следующие строки: 

ОЬ] есі . “Г гееге ( епііте гаі: іоп. ѵаііюз); 

ОЬ^есі:. ІгеегеСепитегаІіоп); 

Обратите внимание, что применение функции 0Ь]ес1:.1тее2е() к типу перечисле¬ 
ния исключает возможность использования свойства окцесИсІ, как было показано 
в примере 9.17. Решение этой проблемы состоит в том, чтобы прочитать значение 
свойства оЬзесИс! (вызвать соответствующий метод чтения и установить внутрен¬ 
нее свойство) перечисления только один раз, перед тем как его зафиксировать. 

9.8.5. Подклассы и ЕСМАБсгірІ 5 

В примере 9.22 демонстрируется порядок создания подклассов с использованием 
возможностей ЕСМАВсгірі 5. В нем определяется класс зІгіпдЗеІ, наследующий 
класс АЬз1гасІИгі*аЫе8е1 из примера 9.16. Основная особенность этого примера 
заключается в использовании функции 0Ь]ес1;.сгеа1:е() для создания объекта-про¬ 
тотипа, наследующего прототип суперкласса, и в определении свойств вновь соз¬ 
данного объекта. Как уже отмечалось выше, основная сложность этого подхода 
заключается в необходимости использовать неудобные дескрипторы свойств. 

Другой интересной особенностью этого примера является передача значения піііі 
функции ОЩесІ. сгеа!е() при создании объекта, не наследующего ничего. Этот объ¬ 
ект используется для хранения элементов множества, а тот факт, что он не имеет 
прототипа, позволяет вместо метода ПазОмпРгорегІіуО использовать оператор іп. 

Пример 9.22. 8ігіпё8еІ: определение подкласса множества 

с использованием ЕСМАЗсгірі 5 

^ііпсііоп ЗітіпдЗеіО { 

ІІііз.зе* = ОЬ^есІ:.сгеа1:е(пи11); // Создать объект без прототипа 
ІМіз.п = 0; 

Шз. абсі.арр1у(Шз, агдіітепіз); 

} 

// Обратите внимание, что ОЬіесІ.сгеаіе позволяет обеспечить наследование 
// прототипа суперкласса и определить методы за счет единственного вызова. 
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// Поскольку при создании свойств мы не указываем значения атрибутов ѵ^гіІаЬІе, 

// епитегаЫе и сопІ'ідигаЫе, они по умолчанию получают значение Гаізе. 

// Доступность методов только для чтения усложняет их переопределение в подклассах. 
ЗігіпдЗеІ;.ргоіоіуре = О^есІ.сгеаііеСАЬзІгасІМгііаЬІеЗеІ. ргоіоіуре, { 

сопзігисіог: { ѵаіье: ЗігіпдЗеІ: }, 

сопіаіпз: { ѵаіье: Гипс1:іоп(х) { геХигп х іп Шз.зеі:; } }. 

зііе: { ѵаіье: ^ьпсИопСх) { ге^ьт Шз.п; } }, 

ГогеасЬ: { ѵаіье: Гипс1:іоп(Г,с) { ОЬ^есІ:. кеуз(1:Піз.зе1:).ГогЕасП(Г 1 с); } }. 

асіс): { 

ѵаіье: ^ітсІіопО { 

^ог(ѵаг і = 0; і < агдьтетз. ІепдІП; і++) { 
іГ (! (агдьтепІізГі] іп ІПіз.зеі)) { 

Шз. зе1:[агдитеп1:з[і]] = Іте; 

ІЬіз.п++; 

} 

} 

ге1:іігп Шз; 

} 

>. 

гетоѵе: { 

ѵаіие: І'ипсІіопС) { 

І'огСѵаг і = 0; і < агдитепііз.ІепдІП; і++) { 
іГ (агдитепІзЦ] іп Шз.зеі) { 
сіеіеіе Шз.зе*[агдитеп*з[і]]; 

Шз. п—; 

} 

} 

геШп Шз; 

} 

} 

}); 

9.8.6. Дескрипторы свойств 

В разделе 6.7 дается описание дескрипторов свойств, введенных стандартом 
ЕСМАВсгірі 5, но там отсутствуют примеры, демонстрирующие различные слу¬ 
чаи их использования. Мы завертим этот раздел, посвященный особенностям 
ЕСМАЗсгірі 5, расширенным примером, демонстрирующим многие операции со 
свойствами, допустимые в ЕСМАЗсгірі 5. Программный код в примере 9.23 до¬ 
бавляет в ОЩесГ.ргоЮІуре метод ргорегІіезО (разумеется, недоступный для пере¬ 
числения). Значение, возвращаемое этим методом, является объектом, представ¬ 
ляющим список свойств и обладающим полезными методами для отображения 
свойств и атрибутов (которые могут пригодиться при отладке). Его можно исполь¬ 
зовать для получения дескрипторов свойств (на случай, если потребуется реали¬ 
зовать копирование свойств вместе с их атрибутами) и для установки атрибутов 
свойств (благодаря чему он может использоваться как альтернатива функциям 
ИісІеРгорзО и ГгееіеРгорзО, объявленным ранее). Этот единственный пример де¬ 
монстрирует большинство особенностей свойств в ЕСМА8сгірі 5, а также приме¬ 
нение методики модульного программирования, о которой будет рассказываться 
в следующем разделе. 
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Пример 9.23. Особенности свойств в ЕСМА8сгірі 5 
/* 

* Определяет метод ргореПіезО в ОЬ^есІ:. ргоШуре, возвращающий объект, который 

* представляет указанные свойства объекта, относительно которого был вызван метод 

* (или все собственные свойства объекта, если метод был вызван без аргументов). 

* Возвращаемый объект имеет четыре полезных метода: 

* ІоЗігіпдО, йезсгіріогзО, Мійе() и зМом(). 

Ч 

(^ішсііоп патезрасеО { // Обернуть все в частную область видимости функции 

// Эта функция будет превращена в метод всех объектов 
^ііпсііоп ргорегі:іез( ) { 

ѵаг пашез; // Массив имен свойств 

ІТ (агдцтепіз.ІепдІМ == 0) // Все собственные свойства объекта Шз 
пашез = ОуесІ.деіОмпРгорегІуМашезСШз); 
еізе іТ (агдцтепіз. 1епд1:Ь == 1 && Аггау. ізАггауСагділпепІзЕО])) 
пашез = агділпепІзЕО]; // Или массив указанных свойств 
еізе // Или имена в списке аргументов 

пашез = Аггау.ргоШуре. зрІісе.саЩагдцтепіз, 0): 

// Вернуть новый объект Ргорегііез. представляющий указанные свойства 
геіьгп п е\п РгореПіезСШз, пашез); 

} 

// Делает эту функцию новым, неперечислимым свойством ОЬ^есІ. ргоШуре. 

// Это единственное значение, экспортируемое из частной области видимости функции. 
ОЬ^есІ.сІеІ'іпеРгорегІіуСОЬзесІ:. ргоШуре, "ргореПіез", { 
ѵаіье: ргорегііез, 

епишегаЫе: Шзе, ѵ/гіІаЫе: Ігье, сопІ'ідигаЫе: Ігье 

}); 

// Следующая функция-конструктор вызывается функцией ргорег1іез(). 

// Класс РгореПіез представляет множество свойств объекта. 

^ііпсііоп Ргорегі:іез(о, пашез) { 

Шз.о = о; // Объект, которому принадлежат свойства 

Шз. пашез = пашез; // Имена свойств 

} 

// Делает неперечислимыми свойства, представленные объектом Шз 
Ргорегііез.ргоіоіуре. МіРе = ^цпсІіоп() { 

ѵаг о = Шз.о, МісЮеп = { епцшегаЫе: Шзе }; 

Шз. пашез. ШЕасМСІ^псІіопСп) { 

ІТ (о. Ьаз0ѵ/пРгорег1:у(п)) 

0Ь]ес1:.сІе1 : іпеРгорег1:у(о, п, МісЮеп); 

}); 

геШп Шз; 


// Делает свойства ненастраиваемыми и доступными только для чтения 
РгореПіез. ргоШуре. Ітееіе = ^цпс*іоп() { 

ѵаг о = Шз.о, Ітоіеп = { мгііаЫе: Шзе, соп^ідигаЫе: Шзе }; 
Шз. пашез. ШЕасМ^ипсІіопСп) { 

і? (о. Маз0мпРгорег1:у(п)) 

ОЬ^есІ;.гіе'ГіпеРгорег1:у(о, п, Ітогеп); 

}); 
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геіцгп Шз; 

}; 


// Возвращает объект, отображающий имена свойств в дескрипторы. 

// Может использоваться для реализации копирования свойств вместе с их атрибутами: 

// ОЬ^есІ:.сІе1 = іпеРгорегі:іез(с1ез1: . зге. ргорегііезС ). сІезсгіріогзС )); 
Ргорегііез.ргоіоіуре.сіезсгіріогз = ГцпсІіопО { 
ѵаг о = іМіз.о, йезс = {}; 

ІМіз.патез.ГогЕасМС^цпсІіопСп) { 

ІГ (!о.Ьаз0мпРгорег1:у(п)) геіцгп; 

йезс[п] = О^есі. деІОѵѵпРгорегІуОезсгірІогСо, п); 

}); 

геііігп Резс: 

}; 

// Возвращает отформатированный список свойств, в котором перечислены имена, 

// значения и атрибуты свойств. Термин "регтапеп*" используется для обозначения 
// ненастраиваемых свойств, "геайопіу" - для обозначения свойств, не доступных 
// для записи, и " Иігісіеп ' - для обозначения неперечислимых свойств. 

// Обычные перечислимые, доступные для записи и настраиваемые свойства 
// указываются в списке без атрибутов. 

Ргорегііез.ргоіоіуре.іоЗігіпд = ^ітсііопО { 

ѵаг о = ІМіз.о; // Используется во вложенных функциях ниже 
ѵаг Ііпез = ІМіз. патез.тар(патеТоЗі:гіпд); 
геііцгп "{\п *' + Ііпез.]оіп(",\п ") + "\п}*’; 

Гцпсііоп патеТоЗі:гіпд(п) { 

ѵаг з = йезс = ОЬ]ес1:.деІОмпРгорегі:уОе5Сгір1:ог(о, п); 
іГ (!йезс) геіигп "попехізіепі: " + п + ": цпРеГіпесГ; 
іГ (!Йезс.соп^ідцгаЫе) з += "регтапепі: 

іГ ((Резс.де! && !Йезс.зеі) || ! Резс.мгііаЫе) з += "геасіопіу 

іТ (Ійезс.епцтегаЫе) з += "МісЮеп 

іГ (Резс.деі: || йезс.зеі:) з += ''ассеззог + п 

еізе з += п + ": + ((ІуреоГ Резс. ѵа1ие==="1 : цпс1:іоп , ')?''1 : ііпс1:іоп'' 

:йезс.ѵаіце): 

геіцгп з; 

} 

}; 

// Наконец, сделать методы экземпляров объекта-прототипа, объявленного 
// выше, неперечислимыми, с помощью методов, объявленных здесь. 

Ргорегііез.ргоіоіуре.ргорегііез().НіРе(): 

}()); // Вызвать вмещающую функцию сразу после ее определения. 

9.9. Модули 

Важной причиной организации программного кода в классы является стремле¬ 
ние придать этому программному коду модульную структуру и обеспечить воз¬ 
можность повторного его использования в различных ситуациях. Однако не толь¬ 
ко классы могут использоваться для организации модульной структуры. Обычно 
модулем считается один отдельный файл с программным кодом ЛѵаВсгірі. Файл 
модуля может содержать определение класса, множество родственных классов, 
библиотеку вспомогательных функций или просто выполняемый сценарий. Мо¬ 
дулем может быть любой фрагмент программного кода на языке ЛѵаЗсгірі при 
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условии, что он имеет модульную структуру. В языке ЛѵаЗсгірі отсутствуют ка¬ 
кие-либо синтаксические конструкции для работы с модулями (впрочем, в нем 
имеются зарезервированные ключевые слова ітрогііз и ехрогііз, поэтому такие кон* 
струкции могут появиться в будущих версиях языка), поэтому написание моду¬ 
лей в языке ЛѵаЗсгірі в значительной степени является вопросом следования со¬ 
глашениям оформления программного кода. 

Многие библиотеки и клиентские фреймворки ЛаѵаЗсгірі включают собственные 
инструменты поддержки модулей. Например, библиотеки Боіо и Ооо^іе Сіозиге 
определяют функции ргоѵіс!е() и гедиіге() для объявления и загрузки модулей. 
А в рамках проекта СоттопДО по стандартизации серверного ЛѵаЗсгірі (Ніір:// 
соттоп]8.огё) разработана спецификация, определяющая модули, в которой так¬ 
же используется функция гедиіге(). Подобные инструменты поддержки модулей 
часто берут на себя такие функции, как загрузка модулей и управление зависи¬ 
мостями, но их обсуждение выходит за рамки этой дискуссии. Если вы пользуе¬ 
тесь одним из таких фреймворков, то вам следует использовать и определять мо¬ 
дули, следуя соглашениям, принятым в этом фреймворке. А в этом разделе мы 
обсудим лишь самые простые соглашения. 

Цель модульной организации заключается в том, чтобы обеспечить возможность 
сборки больших программ из фрагментов программного кода, полученных из 
различных источников, и нормальную работу всех этих фрагментов, включая 
программный код, авторы которого не предусматривали подобную возможность. 
Для безошибочной работы модули должны стремиться избегать внесения измене¬ 
ний в глобальную среду выполнения, чтобы последующие модули могли выпол¬ 
няться в нетронутом (или почти не тронутом) окружении. С практической точки 
зрения это означает, что модули должны до минимума уменьшить количество оп¬ 
ределяемых ими глобальных имен - в идеале каждый модуль должен определять 
не более одного имени. В следующих подразделах описываются простые способы 
достижения этой цели. Вы увидите, что создание модулей в языке ЛѵаЗсгірі не 
связано с какими-либо сложностями: мы уже видели примеры использования 
приемов, описываемых здесь, на протяжении этой книги. 

9.9.1. Объекты как пространства имен 

Один из способов обойтись в модуле без создания глобальных переменных заклю¬ 
чается в том, чтобы создать объект и использовать его как пространство имен. 
Вместо того чтобы создавать глобальные функции и переменные, их можно со¬ 
хранять в свойствах объекта (на который может ссылаться глобальная перемен¬ 
ная). Рассмотрим в качестве примера класс Зеі: из примера 9.6. Он определяет 
единственную глобальную функцию-конструктор Зеі:. Он определяет различные 
методы экземпляров, но сохраняет их как свойства объекта Зеі.ргоіоіуре, благо¬ 
даря чему они уже не являются глобальными. В этом примере также определяет¬ 
ся вспомогательная функция _ѵ2з( ), но она также сохраняется как свойство клас¬ 
са Зеі:. 

Далее рассмотрим пример 9.16. Этот пример объявляет несколько абстрактных 
и конкретных классов множеств. Для каждого класса создается единственное 
глобальное имя, но модуль целиком (файл с программным кодом) определяет до¬ 
вольно много глобальных имен. С точки зрения сохранения чистоты глобального 
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пространства имен было бы лучше, если бы модуль с классами множеств опреде¬ 
лял единственное глобальное имя: 

ѵаг зеііз = {}; 

Объект зеіз мог бы играть роль пространства имен модуля, а каждый из классов 
множеств определялся бы как свойство этого объекта: 

зеііз.Зіпд1е1:оп8е1: = 8еІ8. АЬ8Ігас1ЕпілпегаЫе5е1.ехІепсК...); 

Когда возникла бы потребность использовать класс, объявленный таким спосо¬ 
бом, мы могли бы просто добавлять пространство имен при ссылке на конструк¬ 
тор: 

ѵаг 8 = пем зеііз. Зіпд1е1:оп8е1:( 1): 

Автор модуля не может заранее знать, с какими другими модулями будет исполь¬ 
зоваться его модуль, поэтому он должен принять все меры против конфликтов, 
используя подобные пространства имен. Однако программист, использующий мо¬ 
дуль, знает, какие модули он использует и какие имена в них определяются. Этот 
программист не обязан использовать имеющиеся пространства имен ограничен¬ 
но и может импортировать часто используемые значения в глобальное простран¬ 
ство имен. Программист, который собирается часто использовать класс Зеі: из 
пространства имен зеіз, мог бы импортировать класс, как показано ниже: 

ѵаг Зеі = зеііз . Зеі:; // Импортировать Зеі в глобальное пространство имен 

ѵаг 8 = пем 5е1( 1,2,3); // Теперь его можно использовать без префикса зеІ8. 

Иногда авторы модулей используют глубоко вложенные пространства имен. Если 
модуль с определениями классов множеств является частью обширной коллек¬ 
ции модулей, для него может использоваться пространство имен соііесііопз.зеіз, 
а сам модуль может начинаться со следующих определений: 

ѵаг соііесі:іоп8; // Объявить (или повторно объявить) глобальную переменную 

іГ (!со11ес1іоп8) // Если объект еще не существует 

со11ес1іоп8 = {}; // Создать объект пространства имен верхнего уровня 

со11ес1іоп8.8еІ8 = {} //И внутри него создать пространство имен зеіз. 

// Теперь определить классы множеств внутри соііесііопз.8е1з 
соііесііопз.8е1з.АЬз1гасі5е1 = ІьпсІіопО { ... } 

Иногда пространство имен верхнего уровня используется для идентификации 
разработчика или организации - автора модуля и для предотвращения конфлик¬ 
тов между пространствами имен. Например, библиотека Соо^іе Сіозиге опреде¬ 
ляет свой класс Зеі в пространстве имен доод.зігисіз. Для определения глобально 
уникальных префиксов, которые едва ли будут использоваться другими автора¬ 
ми модулей, индивидуальные разработчики могут использовать компоненты до¬ 
менного имени. Поскольку мой веб-сайт имеет имя <Іаѵі(1{Іапаёап.сот , я мог бы 
поместить свой модуль с классами множеств в пространство имен сот.сіаѵісіііапа- 
дап.соПесІіопз.зеІз. 

При таких длинных именах для любого пользователя вашего модуля операция 
импортирования становится особенно важной. Однако, вместо того чтобы импор¬ 
тировать имена отдельных классов, программист мог бы импортировать в гло¬ 
бальное пространство имен весь модуль целиком: 

ѵаг зеіз = сот. баѵібііападап.соііесііопз.зеіз; 
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В соответствии с соглашениями имя файла модуля должно совпадать с его про¬ 
странством имен. Модуль зеііз должен храниться в файле с именем 8еІ8.І8. Если 
модуль использует пространство имен соііесііопз.зеіз, то этот файл должен хра> 
ниться в каталоге соІІесііоп8/ (этот каталог мог бы также включать файл тарэ.уэ). 
А модуль, использующий пространство имен сот. сіаѵісіііападап. соііесііопз.зеіз, 
должен храниться в файле сот/даѵід^іапаёап/соііесііопз/зеіз.із. 

9.9.2. Область видимости функции 
как частное пространство имен 

Модули имеют экспортируемый ими общедоступный прикладной интерфейс 
(АРІ): это функции, классы, свойства и методы, предназначенные для использо¬ 
вания другими программистами. Однако зачастую для внутренних нужд моду¬ 
ля требуются дополнительные функции или методы, которые не предназначены 
для использования за пределами модуля. Примером может служить функция 
5еІ._ѵ2з() из примера 9.6 - для нас было бы нежелательно, чтобы пользователи 
класса Зеі вызывали эту функцию, поэтому было бы неплохо сделать ее недоступ¬ 
ной извне. 

Этого можно добиться, определив модуль (в данном случае класс Зеі:) внутри 
функции. Как описывалось в разделе 8.5, переменные и функции, объявленные 
внутри другой функции, являются локальными по отношению к этой функции 
и недоступны извне. Таким образом, область видимости функции (называемой 
иногда «функцией модуля») можно использовать как частное пространство имен 
модуля. Пример 9.24 демонстрирует, как это может выглядеть применительно 
к нашему классу Зеі:. 

Пример 9.24. Класс 8еі внутри функции модуля 

П Объявляет глобальную переменную Зеі: и присваивает ей значение, возвращаемое 
// функцией. Круглые скобки, окружающие объявление функции, свидетельствуют о том, 

// что функция будет вызвана сразу после ее объявления и что присваивается значение, 

// возвращаемое функцией, а не сама функция. Обратите внимание, что это выражение 
// определения функции, а не инструкция, поэтому наличие имени "іпѵосаііоп" 

// не вызывает создание глобальной переменной, 
ѵаг Зеі: = (Іцпсііоп іпѵосаІіопО { 

Іцпсііоп ЗеіО { // Эта функция-конструктор - локальная переменная. 

ІІііз.ѵаіцез = {}; // Свойство для хранения множества 
ІІііз.п = 0; // Количество значений в множестве 

ІІііз.айсі. арр1у(11іі5, агдцтепіз); // Все аргументы являются значениями, 

} // добавляемыми в множество 

// Далее следуют определения методов в Зеі.ргоіоіуре. 

// Для экономии места программный код опущен 
Зеі.ргоіоіуре.сопіаіпз = Іцпсііоп(ѵаіце) { 

// Обратите внимание, что ѵ2з() вызывается без префикса ЗеІ._ѵ25() 
геіцгп ІМІ8.ѵаіііез. Маз0ѵ\/пРгорегІу(ѵ25(ѵа1це)); 

}; 

Зеі.ргоіоіуре.зіге = ІцпсІіопО { геіцгп ІИіз.п; }; 

Зеі.ргоіоіуре.асісі = ІцпсІіопО { /* ... */ }; 

Зеі. ргоіоіуре. гетоѵе = ІцпсІіопО { /* ... */ }; 

Зеі. ргоіоіуре. Іо геасіі = ІцпсІіопО, сопіехі) {/*...*/}: 
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// Далее следуют вспомогательные функции и переменные, используемые 
// методами выше. Они не являются частью общедоступного АРІ модуля и скрыты 
// в области видимости функции, благодаря чему не требуется объявлять их как 
// свойства класса 5е* или использовать символ подчеркивания в качестве префикса. 
*ипс*іоп ѵ25(ѵа1) { /* ... */ } 

*ипс*іоп оЬ]ес*Ісі(о) { /* ... */ } 
ѵаг пех*ІР = 1; 

// Общедоступным АРІ этого модуля является функция-конструктор 5е*(). 

// Нам необходимо экспортировать эту функцию за пределы частного 
// пространства имен, чтобы ее можно было использовать за ее пределами. 

// В данном случае конструктор экспортируется за счет передачи его 
// в виде возвращаемого значения. Он становится присваиваемым значением 
// в выражении в первой строке выше, 
геіюгп Зеі: ; 

}()); // Вызвать функцию сразу после ее объявления. 

Обратите внимание, что такой прием вызова функции сразу после ее определения 
является характерным для языка ЛѵаЗсгірі. Программный код, выполняемый 
в частном пространстве имен, предваряется текстом «(ІипсііопО {» и завершается 
«}());*. Открывающая круглая скобка в начале сообщает интерпретатору, что это 
выражение определения функции, а не инструкция, поэтому в префикс можно 
добавить любое имя функции, поясняющее ее назначение. В примере 9.24 было 
использовано имя «іпѵосаііоп», чтобы подчеркнуть, что функция вызывается 
сразу же после ее объявления. Точно так же можно было бы использовать имя 
«патеврасе», чтобы подчеркнуть, что функция играет роль пространства имен. 

После того как модуль окажется заперт внутри функции, ему необходим некото¬ 
рый способ экспортировать общедоступный АРІ для использования за пределами 
функции модуля. В примере 9.24 функция модуля возвращает конструктор, ко¬ 
торый тут же присваивается глобальной переменной. Сам факт возврата значе¬ 
ния из функции ясно говорит о том, что оно экспортируется за пределы области 
видимости функции. Модули, определяющие более одного элемента АРІ, могут 
возвращать объект пространства имен. Для нашего модуля с классами множеств 
можно было бы написать такой программный код: 

// Создает единственную глобальную переменную, хранящую все модули, 

// имеющие отношение к коллекциям 
ѵаг со11ес*іопз; 

іГ (! со11ес*іоп5) со11ес*іоп5 = {}; 

// Теперь определить модуль 5е*5 
со11ес*іоп5.зе1:5 = (*ипс*іоп патезрасеО { 

// Здесь находятся определения различных классов множеств, 

// использующих локальные переменные и функции 
// ... Большая часть программного кода опущена... 

// Экспортировать АРІ в виде возвращаемого объекта пространства имен 
геіюгп { 

// Экспортируемое имя свойства : имя локальной переменной 
АЬзіігасІіЗеІ: : АЬбі: гас1:5е1:, 

ЬІоІіЗеІ:: МоІіЗеІ:, 

АЬбі: гас* ЕпитегаЫеЭеІ:: АЬб* гас*ЕпитегаЫеЗе*. 

5іпд1е*опЗе*: 5іпд1е*оп5е*, 

АЬб* гас*Іл/гі*аЫе5е*: АЬб* гас*Мгі*аЫе5е*, 
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Аггаубеі:: АггауЗеІ: 

}; 

> 0 ); 

Можно предложить похожий прием, определив функцию модуля как конструк¬ 
тор, который будет вызываться с ключевым словом пем и экспортировать значе¬ 
ния за счет их присваивания: 

ѵаг соПесІіопБ; 

Н (! соііесіііопз ) соПесІіопз = {}; 
соІІесііопБ. зе1:5 = (пей ^цпсіііоп патезрасеО { 

// ... Большая часть программного кода опущена ... 

// Экспортировать АРІ в объекте ІИІ5 
ІІііб.АЬбІгасІЗеІ: = АЬ5*гасі8еІ; 

1Ііі5.Мо*8е1: = №)18еі; // И так далее.... 

// Обратите внимание на отсутствие возвращаемого значения. 

}()); 

Если объект глобального пространства имен уже определен, функция модуля мо¬ 
жет просто присваивать значения свойствам этого объекта и вообще ничего не 
возвращать: 

ѵаг соПесІіопБ; 

Н (! соііесіііопз) соііесііопз = {}; 
соііесііопз.зеіБ = {}; 

(^цпсііоп патезрасеО { 

// ... Большая часть программного кода опущена ... 

// Экспортировать общедоступный АРІ в объект пространства имен, созданный выше 
со11ес1іоп5.зеіз.АЬ5Ігас18еі: = АЬзігасІЗеІ; 
соііесііопз.зеіз. Мо18е* = №)18е*; // И так далее... 

// Инструкция геіцгп не требуется, потому что экспортирование выполняется выше. 

}()); 

Фреймворки, реализующие инструменты загрузки модулей, могут предусматри¬ 
вать собственные методы экспортирования АРІ модулей. Внутри модуля может 
определяться функция ргоѵіс!ез(), которая выполняет регистрацию его АРІ, или 
объект ехрогіз, в котором модуль должен сохранять свой АРІ. Пока в языке Лѵа- 
8сгірі отсутствуют инструменты управления модулями, вам придется использо¬ 
вать средства создания и экспортирования модулей, которые лучше подходят для 
используемой вами библиотеки инструментов. 
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Шаблоны и регулярные выражения 


Регулярное выражение - это объект, описывающий символьный шаблон. Класс 
ПедЕхр в ^ѵабсгірі представляет регулярные выражения, а объекты классов 
Зіігіпд и ПедЕхр определяют методы, использующие регулярные выражения для 
выполнения поиска по шаблону и операций поиска в тексте с заменой. Граммати¬ 
ка регулярных выражений в языке ЛѵаВсгірі содержит достаточно полное под¬ 
множество синтаксиса регулярных выражений, используемого в языке Регі 5, 
поэтому, если вы имеете опыт работы с языком Регі, то вы без труда сможете опи¬ 
сывать шаблоны в программах на языке ЛѵаЗсгірі. 1 

Эта глава начинается с определения синтаксиса, посредством которого в регуляр¬ 
ных выражениях описываются текстовые шаблоны. Затем мы перейдем к описа¬ 
нию тех методов классов Зігіпд и ПедЕхр, которые используют регулярные выра¬ 
жения. 

10.1. Определение регулярных выражений 

В ЛѵаЗсгірі регулярные выражения представлены объектами ПедЕхр. Объекты 
ПедЕхр могут быть созданы посредством конструктора НедЕхр( ), но чаще они созда¬ 
ются с помощью специального синтаксиса литералов. Так же как строковые ли¬ 
тералы задаются в виде символов, заключенных в кавычки, литералы регуляр¬ 
ных выражений задаются в виде символов, заключенных в пару символов слэша 
(/). Таким образом, Лѵа8сгірі-код может содержать строки, похожие на эту: 

ѵаг раиегп = /з$/; 


1 В число особенностей регулярных выражений языка Регі, которые не поддерживают¬ 
ся в ЕСМАВсгірі, входят флаги 5 (однострочный режим) и х (расширенный синтаксис); 
управляющие последовательности \а, \е, \1, \и, \Ц \У, \Е, \0, \А, V, \г и \0; якорь (?<= по¬ 
зитивной ретроспективной проверки и якорь (?<! негативной ретроспективной провер¬ 
ки; комментарии^# и другие расширенные конструкции, начинающиеся с (?. 
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Эта строка создает новый объект ПедЕхр и присваивает его переменной раі^егп. 
Данный объект ПедЕхр ищет любые строки, заканчивающиеся символом «8». Это 
же регулярное выражение может быть определено с помощью конструктора 

ИедЕхрО: 

ѵаг раПегп = пем ПедЕхр("5$"); 

Спецификация шаблона регулярного выражения состоит из последовательности 
символов. Большая часть символов, включая все алфавитно-цифровые, букваль¬ 
но описывают символы, которые должны присутствовать. То есть регулярное вы¬ 
ражение /іаѵа/ совпадает со всеми строками, содержащими подстроку «іаѵа». 
Другие символы в регулярных выражениях не предназначены для поиска их точ¬ 
ных эквивалентов, а имеют особое значение. Например, регулярное выражение 
/з$/ содержит два символа. Первый символ, з, обозначает поиск буквального сим¬ 
вола. Второй, $, - это специальный метасимвол, обозначающий конец строки. Та¬ 
ким образом, это регулярное выражение соответствует любой строке, заканчи¬ 
вающейся символом з. 

В следующих разделах описаны различные символы и метасимволы, используе¬ 
мые в регулярных выражениях в языке ЛѵаЗсгірі. 


Литералы КедЕхр и создание объектов 

Литералы простых типов, таких как строки и числа, интерпретируются 
как одни и те же значения, где бы они ни встретились в программе. Литера¬ 
лы объектов (или инициализаторы), такие как {} и [], каждый раз создают 
новые объекты. Если поместить инструкцию ѵаг а = [ ] в тело цикла, напри¬ 
мер, в каждой итерации цикла будет создаваться новый пустой массив. 

Литералы регулярных выражений - особый случай. Спецификация ЕСМА- 
Зсгірі 3 утверждает, что литерал ПедЕхр преобразуется в объект ПедЕхр в хо¬ 
де синтаксического анализа программного кода и каждый раз, когда ин¬ 
терпретатор встречает литерал ПедЕхр, он возвращает один и тот же объект. 
Спецификация ЕСМАВсгірі 5 изменила это положение вещей и требует, 
чтобы всякий раз, когда в программе встречается литерал ПедЕхр, возвра¬ 
щался бы новый объект. Реализация в броузере ІЕ всегда соответствовала 
поведению, соответствующему ЕСМАЗсгірі 5, и большинство современных 
броузеров также перешли на новую реализацию, раньше, чем полностью 
реализовали новый стандарт. 


10.1.1. Символы литералов 

Как отмечалось ранее, все алфавитные символы и цифры в регулярных выраже¬ 
ниях соответствуют сами себе. Синтаксис регулярных выражений в ^ѵаЗсгірі 
также поддерживает возможность указывать некоторые неалфавитные символы 
с помощью управляющих последовательностей, начинающихся с символа обрат¬ 
ного слэша (\). Например, последовательность \п соответствует символу перевода 
строки. Эти символы перечислены в табл. 10.1. 
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Таблица 10.1 . Символы литералов в регулярных выражениях 


Символ 

Соответствие 

Алфавитно-цифровые 

Соответствуют сами себе 

символы 


\о 

Символ ЬШЬ (\и0000) 

\* 

Табуляция (\и0009) 

\п 

Перевод строки (\и000А) 

\Ѵ 

Вертикальная табуляция (\и000В) 

V 

Перевод страницы (\и000С) 

\г 

Возврат каретки (\и0000) 

\хпп 

Символ из набора Ьаііп, задаваемый шестнадцатеричным чис¬ 
лом пп; например, \хОА - это то же самое, что \п 

\і)ХХХХ 

ІІпісосіе-символ, заданный шестнадцатеричным числом хххх; на¬ 
пример, \и0009 - это то же самое, что \* 

\сХ 

Управляющий символ ~Х; например, последовательность эк¬ 

вивалентна символу перевода строки \п 


Некоторые знаки препинания имеют в регулярных выражениях особый смысл: 

~ $ • * + ? = ! : I \ /()[]{ } 

Значение этих символов раскрывается в последующих разделах. Некоторые из 
них имеют специальный смысл только в определенных контекстах регулярных 
выражений, а в других контекстах трактуются буквально. Однако, как правило, 
чтобы включить какой-либо из этих символов в регулярное выражение букваль¬ 
но, необходимо поместить перед ним символ обратного слэша. Другие символы, 
такие как кавычки и @, не имеют специального значения и просто соответствуют 
в регулярных выражениях самим себе. 

Если вы не можете точно вспомнить, каким из символов должен предшествовать 
символ \, можете спокойно помещать обратный слэш перед любым из символов. 
Однако имейте в виду, что многие буквы и цифры вместе с символом слэша обре¬ 
тают специальное значение, поэтому тем буквам и цифрам, которые вы ищете бу¬ 
квально, не должен предшествовать символ \. Чтобы включить в регулярное вы¬ 
ражение сам символ обратного слэша, перед ним, очевидно, следует поместить 
другой символ обратного слэша. Например, следующее регулярное выражение 
соответствует любой строке, содержащей символ обратного слэша: /\\/. 

10.1.2. Классы символов 

Отдельные символы литералов могут объединяться в классы символов путем по¬ 
мещения их в квадратные скобки. Класс символов соответствует любому симво¬ 
лу, содержащемуся в этом классе. Следовательно, регулярное выражение /[аЬс]/ 
соответствует одному из символов а, Ь или с. Могут также определяться классы 
символов с отрицанием, соответствующие любому символу, кроме тех, которые 
указаны в скобках. Класс символов с отрицанием задается символом ~ в качестве 
первого символа, следующего за левой скобкой. Регулярное выражение /[~аЬс]/ 
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соответствует любому символу, отличному от а, Ь или с. В классах символов диа¬ 
пазон символов может задаваться при помощи дефиса. Поиск всех символов ла¬ 
тинского алфавита в нижнем регистре осуществляется посредством выражения 
/[а-?]/, а любую букву или цифру из набора символов Ьаііп можно найти при по¬ 
мощи выражения /[а-іА-20-9]/. 

Некоторые классы символов используются особенно часто, поэтому синтаксис ре¬ 
гулярных выражений в Лаѵа8сгірі включает специальные символы и управляю¬ 
щие (евсаре) последовательности для их обозначения. Так, \з соответствует симво¬ 
лам пробела, табуляции и любым пробельным символам из набора Ііпісосіе, а \5 - 
любым символам, не являющимся пробельными символами из набора Ііпісосіе. 
В табл. 10.2 приводится перечень этих спецсимволов и синтаксиса классов симво¬ 
лов. (Обратите внимание, что некоторые из управляющих последовательностей 
классов символов соответствуют только А8СІІ-символам и не расширены для ра¬ 
боты с Ипісосіе-символами. Можно явно определить собственные классы Шісосіе- 
символов, например, выражение /[\и0400-\04РР]/ соответствует любому символу 
кириллицы.) 

Таблица 10.2. Классы символов регулярных выражений 


Символ 

[-.] 

Г-] 

> 

\и 

\з 

\8 

\сІ 

V) 

[\И 


Соответствие _ 

Любой из символов, указанных в скобках 
Любой из символов, не указанных в скобках 

Любой символ, кроме перевода строки или другого разделителя Ііпісосіе-строки 

Любой текстовый А8СІІ-символ. Эквивалентно [а-гА-20-9_] 

Любой символ, не являющийся текстовым А8СІ1-символом. 

Эквивалентно [~а-гА-20-9_] 

Любой пробельный символ из набора Ііпісосіе 

Любой непробельный символ из набора Ііпісосіе. Обратите внимание, что симво¬ 
лы \м и \5 - это не одно и то же 

Любые А8СІІ-цифры. Эквивалентно [0-9] 

Любой символ, отличный от А8СІІ-цифр. Эквивалентно ["0-9] 

Литерал символа «забой» (особый случай) 


Обратите внимание, что управляющие последовательности специальных симво¬ 
лов классов могут находиться в квадратных скобках. \з соответствует любому 
пробельному символу, а \с! соответствует любой цифре, следовательно, /[\з\с!]/ со¬ 
ответствует любому пробельному символу или цифре. Обратите внимание на осо¬ 
бый случай. Как мы увидим позже, последовательность \Ь имеет особый смысл. 
Однако когда она используется в классе символов, то обозначает символ «забой». 
Поэтому, чтобы обозначить символ «забой» в регулярном выражении буквально, 
используйте класс символов с одним элементом: /[\Ь]/. 

10.1.3. Повторение 

Имея знания синтаксиса регулярных выражений, полученные к настоящему мо¬ 
менту, мы можем описать число из двух цифр как /\сІ\сІ/ или из четырех цифр как 
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/\сі\сі\сі\сі/, но не сможем, например, описать число, состоящее из любого количе¬ 
ства цифр, или строку из трех букв, за которыми следует необязательная цифра. 
Эти более сложные шаблоны используют синтаксис регулярных выражений," 
указывающий, сколько раз может повторяться данный элемент регулярного вы¬ 
ражения. 

Символы, обозначающие повторение, всегда следуют за шаблоном, к которому они 
применяются. Некоторые виды повторений используются довольно часто, и для 
обозначения этих случаев имеются специальные символы. Например, + соответст¬ 
вует одному или нескольким экземплярам предыдущего шаблона. В табл. 10.3 
приведена сводка синтаксиса повторений. 

Таблица 10.3 . Символы повторения в регулярных выражениях 


Символ Значение _ 

{л. /77} Соответствует предшествующему шаблону, повторенному не менее пине более 

т раз 


{п,} 

{п} 

? 


Соответствует предшествующему шаблону, повторенному п или более раз 

Соответствует в точности п экземплярам предшествующего шаблона 

Соответствует нулю или одному экземпляру предшествующего шаблона; пред¬ 
шествующий шаблон является необязательным. Эквивалентно {0,1} 

Соответствует одному или более экземплярам предшествующего шаблона. Эк¬ 
вивалентно {1.} 


* 


Соответствует нулю или более экземплярам предшествующего шаблона. Эк¬ 
вивалентно {О,} 


Следующие строки демонстрируют несколько примеров: 

/\й{2,4}/ // Соответствует числу, содержащему от двух до четырех цифр 

Дѵ\/{ 3} \с1?/ // Соответствует в точности трем символам слова 

// и одной необязательной цифре 

/\з+]аѵа\5+/ // Соответствует слову "^аѵа" с одним или более пробелами 
// до и после него 

/["(]*/ // Соответствует нулю или более символам, отличным от открывающей круглой 

// скобки 

Будьте внимательны при использовании символов повторения * и ?. Они могут 
соответствовать отсутствию указанного перед ними шаблона и, следовательно, 
отсутствию символов. Например, регулярному выражению /а*/ соответствует 
строка «ЪЪЪЪ», поскольку в ней нет символа а! 

10.1.3.1. «Нежадное» повторение 

Символы повторения, перечисленные в табл. 10.3, соответствуют максимально 
возможному количеству повторений, при котором обеспечивается поиск после¬ 
дующих частей регулярного выражения. Мы говорим, что это - «жадное» повто¬ 
рение. Имеется также возможность реализовать повторение, выполняемое «не¬ 
жадным» способом. Достаточно указать после символа (или символов) повторения 
вопросительный знак: ??, +?, *? или даже {1,5}?. Например, регулярное выражение 
/а+/ соответствует одному или более экземплярам буквы а. Примененное к строке 
«ааа», оно соответствует всем трем буквам. С другой стороны, выражение /а+?/ 
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соответствует одному или более экземплярам буквы а и выбирает наименее воз¬ 
можное число символов. Примененный к той же строке, этот шаблон соответству¬ 
ет только первой букве а. 

«Нежадное» повторение не всегда дает ожидаемый результат. Рассмотрим шаб¬ 
лон /а+Ь/, соответствующий одному или более символам а, за которыми следует 
символ Ь. Применительно к строке «аааЪ» ему соответствует вся строка. Теперь 
проверим «нежадную» версию /а+?Ь/. Можно было бы подумать, что она должна 
соответствовать символу Ь, перед которым стоит только один символ а. В случае 
применения к той же строке «аааЪ» можно было бы ожидать, что она совпадет 
с единственным символом а и последним символом Ь. Однако на самом деле этому 
шаблону соответствует вся строка, как и в случае «жадной» версии. Дело в том, 
что поиск по шаблону регулярного выражения выполняется путем нахождения 
первой позиции в строке, начиная с которой соответствие становится возмож¬ 
ным. Так как соответствие возможно, начиная с первого символа строки, более 
короткие соответствия, начинающиеся с последующих символов, даже не рас¬ 
сматриваются. 

10.1.4. Альтернативы, группировка и ссылки 

Грамматика регулярных выражений включает специальные символы определе¬ 
ния альтернатив, подвыражений группировки и ссылок на предыдущие подвыра¬ 
жения. Символ вертикальной черты | служит для разделения альтернатив. На¬ 
пример, /аЬ | ссі |еГ/ соответствует либо строке «аЬ», либо строке «сб», либо строке 
«еі>, а шаблон /\с!{3} | [а-2]{4}/ - либо трем цифрам, либо четырем строчным буквам. 

Обратите внимание, что альтернативы обрабатываются слева направо до тех пор, 
пока не будет найдено соответствие. При обнаружении совпадения с левой аль¬ 
тернативой правая игнорируется, даже если можно добиться «лучшего» соответ¬ 
ствия. Поэтому, когда к строке «аЬ» применяется шаблон /а|аЬ/, он будет соответ¬ 
ствовать только первому символу. 

Круглые скобки имеют в регулярных выражениях несколько значений. Одно из 
них - группировка отдельных элементов в одно подвыражение, так что элементы 
при использовании специальных символов |, *, +, ? и других рассматриваются 
как одно целое. Например, шаблон ^аѵа(зсгіріі)?/ соответствует слову «^аѵа», за 
которым следует необязательное слово «зсгірі», а /(аЬ|сс!)+1еГ)/ соответствует ли¬ 
бо строке «е?», либо одному или более повторений одной из строк «аЬ» или «ссі». 

Другим применением скобок в регулярных выражениях является определение 
подшаблонов внутри шаблона. Когда в целевой строке найдено совпадение с регу¬ 
лярным выражением, можно извлечь часть целевой строки, соответствующую 
любому конкретному подшаблону, заключенному в скобки. (Мы увидим, как по¬ 
лучить эти подстроки, далее в этой главе.) Предположим, что требуется отыскать 
одну или более букв в нижнем регистре, за которыми следует одна или несколько 
цифр. Для этого можно воспользоваться шаблоном /[а-2]+\сі+Л Но предположим 
также, что нам нужны только цифры в конце каждого соответствия. Бели помес¬ 
тить эту часть шаблона в круглые скобки (/[а- 2 ]+(\с 1 +)/), то можно будет извлечь 
цифры из любых найденных нами соответствий. Как это делается, будет описано 
ниже. 
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С этим связано еще одно применение подвыражений в скобках, позволяющее 
ссылаться на подвыражения из предыдущей части того же регулярного выраже¬ 
ния. Это достигается путем указания одной или нескольких цифр послё симво' 
ла \. Цифры ссылаются на позицию подвыражения в скобках внутри регулярно¬ 
го выражения. Например, \1 ссылается на первое подвыражение, а \3 - на третье. 
Обратите внимание, что подвыражения могут быть вложены одно в другое, по¬ 
этому при подсчете используется позиция левой скобки. Например, в следующем 
регулярном выражении ссылка на вложенное подвыражение ([8з]сгір1:) будет вы¬ 
глядеть как \2: 

/([ ^ ]аѵа([8з]сгірі:)?)\зіз\з(Гип\\л/*)/ 

Ссылка на предыдущее подвыражение указывает не на шаблон этого подвыраже¬ 
ния, а на найденный текст, соответствующий этому шаблону. Поэтому ссылки 
могут использоваться для наложения ограничения, выбирающего части строки, 
содержащие точно такие же символы. Например, следующее регулярное выра¬ 
жение соответствует нулю или более символам внутри одинарных или двойных 
кавычек. Однако оно не требует, чтобы открывающие и закрывающие кавычки 
соответствовали друг другу (т. е. чтобы обе кавычки были одинарными или двой¬ 
ными): 

Соответствия кавычек мы можем потребовать посредством такой ссылки: 

/([■"])Г'"]Л1/ 

Здесь \1 соответствует совпадению с первым подвыражением. В этом примере 
ссылка налагает ограничение, требующее, чтобы закрывающая кавычка соот¬ 
ветствовала открывающей. Это регулярное выражение не допускает присутствия 
одинарных кавычек внутри двойных, и наоборот. Недопустимо помещать ссылки 
внутрь классов символов, т. е. мы не можем написать: 

/([ "])Г\і]ЛѴ 

Далее в этой главе мы увидим, что этот вид ссылок на подвыражения представля¬ 
ет собой мощное средство использования регулярных выражений в операциях 
поиска с заменой. 

Возможна также группировка элементов в регулярном выражении без создания 
нумерованной ссылки на эти элементы. Вместо простой группировки элементов 
между ( и ) начните группу с символов (?: и закончите ее символом ). Рассмот¬ 
рим, например, следующий шаблон: 

/([ ^ ]аѵа(? : [ Зз]сгір1: )? )\зіз\з( ^ипХѵѵ/*)/ 

Здесь подвыражение (?:[8з]сгір1і) необходимо только для группировки, чтобы 
к группе мог быть применен символ повторения ?. Эти модифицированные скоб¬ 
ки не создают ссылку, поэтому в данном регулярном выражении \2 ссылается на 
текст, соответствующий шаблону (1 = ип\\л/*). 

В табл. 10.4 приводится перечень операторов выбора из альтернатив, группиров¬ 
ки и ссылки в регулярных выражениях. 
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Таблица 10.4. Символы регулярных выражений выбора из альтернатив, 

группировки и ссылки 


Символ Значение _ 

| Альтернатива. Соответствует либо подвыражению слева, либо подвыражению 

справа. 

(...) Группировка. Группирует элементы в единое целое, которое может использо¬ 
ваться с символами *, +, ?, | и т. п. Также запоминает символы, соответствующие 
этой группе для использования в последующих ссылках. 




Только группировка. Группирует элементы в единое целое, но не запоминает 
символы, соответствующие этой группе. 


Ѵ> 


Соответствует тем же символам, которые были найдены при сопоставлении 
с группой с номером п. Группы - это подвыражения внутри скобок (возможно, 
вложенных). Номера группам присваиваются путем подсчета левых скобок сле¬ 
ва направо. Группы, сформированные с помощью символов (?:, не нумеруются. 


10.1.5. Указание позиции соответствия 

Как описывалось ранее, многие элементы регулярного выражения соответству¬ 
ют одному символу в строке. Например, \з соответствует одному пробельному 
символу. Другие элементы регулярных выражений соответствуют позициям ме¬ 
жду символами, а не самим символам. Например, \Ь соответствует границе сло¬ 
ва - границе между \\л/ (текстовый А8СІІ-символ) и \Ѵуі (нетекстовый символ) или 
границе между текстовым А8СІІ-символом и началом или концом строки. 1 Такие 
элементы, как \Ь, не определяют какие-либо символы, которые должны присут¬ 
ствовать в найденной строке, однако они определяют допустимые позиции для 
проверки соответствия. Иногда эти элементы называются якорными элемента¬ 
ми регулярных выражений , потому что они закрепляют шаблон за определенной 
позицией в строке. Чаще других используются такие якорные элементы, как ~ 
и $, привязывающие шаблоны соответственно к началу и концу строки. 

Например, слово « Лѵа8сгірі», находящееся на отдельной строке, можно найти 
с помощью регулярного выражения /^аѵаЗсгірі:$/. Чтобы найти отдельное слово 
« Лѵа» (а не префикс, например в слове « Лѵа8сгірі»), можно попробовать приме¬ 
нить шаблон /\з^ѵа\з/, который требует наличия пробела 2 до и после слова. Но 
такое решение порождает две проблемы. Во-первых, оно найдет слово <^аѵа», 
только если оно окружено пробелами с обеих сторон, и не сможет найти его в на¬ 
чале или в конце строки. Во-вторых, когда этот шаблон действительно найдет со¬ 
ответствие, возвращаемая им строка будет содержать ведущие и замыкающие 
пробелы, а это не совсем то, что нам нужно. Поэтому вместо шаблона, совпадаю¬ 
щего с пробельными символами \з, мы воспользуемся шаблоном (или якорем), 
совпадающим с границами слова \Ь. Получится следующее выражение: /\Ь ^ѵа\Ь/. 
Якорный элемент \В соответствует позиции, не являющейся границей слова. 


1 За исключением класса символов (квадратных скобок), где \Ь соответствует символу 
«забой». 

2 Точнее, любого пробельного символа. - Прим. науч. ред. 
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То есть шаблону /\В[Зз]сгір1;/ будут соответствовать слова <^аѵа8сгірі» и «розі- 
зсгірі» и не будут соответствовать слова «зсгірі» или «8сгірІіп&». 

В качестве якорных условий могут также выступать произвольные регулярные" 
выражения. Если поместить выражение между символами (?= и ), оно превратит¬ 
ся в опережающую проверку на совпадение с последующими символами, требую¬ 
щую, чтобы эти символы соответствовали указанному шаблону, но не включа¬ 
лись в строку соответствия. Например, чтобы найти совпадение с названием рас¬ 
пространенного языка программирования, за которым следует двоеточие, можно 
воспользоваться выражением /[^ ]аѵа( [Зз]сгір1:)?(?=\: )/. Этому шаблону соответст¬ 
вует слово « ^ѵаЗсгірі» в строке <^аѵа8сгірі: ТЬе БейпШѵе Сиісіе», но ему не бу¬ 
дет соответствовать слово « Лѵа» в строке « Лѵа іп а КиізЬеІЬ, потому что за ним 
не следует двоеточие. 

Если же ввести условие (?!, то это будет негативная опережающая проверка на 
последующие символы, требующая, чтобы следующие символы не соответство¬ 
вали указанному шаблону. Например, шаблону ^аѵа(?!Зсгір1;)([А-2]\\л/*)/ соответ¬ 
ствует подстрока « ^ѵа», за которой следует заглавная буква и любое количество 
текстовых А8СІІ-СИМВОЛОВ при условии, что за подстрокой « ^ѵа» не следует под¬ 
строка «8сгірі>. Он совпадет со строкой « ^ѵаВеапз», но не совпадет со строкой 
« Лѵапезе», совпадет со строкой « ^ѵабсгір», но не совпадет со строками « 5есѵаг 
8сгірі» или « ЛѵаЗсгіріег». 

В табл. 10.5 приводится перечень якорных символов регулярных выражений. 


Таблица 10.5 . Якорные символы регулярных выражений 


Символ Значение _ 

Соответствует началу строкового выражения или началу строки при много¬ 
строчном поиске. 

$ Соответствует концу строкового выражения или концу строки при многостроч¬ 

ном поиске. 


\Ь 


Соответствует границе слова, т. е. соответствует позиции между символом \м 
и символом \!л/ или между символом \м и началом или концом строки. (Однако 
обратите внимание, что [\Ь] соответствует символу забоя.) 


\В 


Соответствует позиции, не являющейся границей слов. 


(?=р) Позитивная опережающая проверка на последующие символы. Требует, чтобы 

последующие символы соответствовали шаблону р, но не включает эти симво¬ 
лы в найденную строку. 

(?! р) Негативная опережающая проверка на последующие символы. Требует, чтобы 

следующие символы не соответствовали шаблону р. 


10.1.6. Флаги 

И еще один, последний элемент грамматики регулярных выражений. Флаги ре¬ 
гулярных выражений задают высокоуровневые правила соответствия шаблонам. 
В отличие от остальной грамматики регулярных выражений, флаги указывают¬ 
ся не между символами слэша, а после второго из них. В языке ^ѵаЗсгірі поддер¬ 
живается три флага. Флаг і указывает, что поиск по шаблону должен быть нечув¬ 
ствителен к регистру символов, а флаг д - что поиск должен быть глобальным, 
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т. е. должны быть найдены все соответствия в строке. Флаг т выполняет поиск по 
шаблону в многострочном режиме. Если строковое выражение, в котором выпол¬ 
няется поиск, содержит символы перевода строк, то в этом режиме якорные сим*- 
волы ~ и $, помимо того, что они соответствуют началу и концу всего строкового 
выражения, также соответствуют началу и концу каждой текстовой строки. На¬ 
пример, шаблону /]аѵа$/іт соответствует как слово «іаѵа», так и «Лаѵа\піз іип>. 

Эти флаги могут объединяться в любые комбинации. Например, чтобы выпол¬ 
нить поиск первого вхождения слова «іаѵа» (или « Лѵа», « ЗАѴА* и т. д.) без учета 
регистра символов, можно воспользоваться нечувствительным к регистру регу¬ 
лярным выражением /\Ь з аѵа\Ь/і . А чтобы найти все вхождения этого слова в стро¬ 
ке, можно добавить флаг д: /\Ьз аѵа\Ь/ді . 

В табл. 10.6 приводится перечень флагов регулярных выражений. Заметим, что 
флаг д более подробно рассматривается далее в этой главе вместе с методами клас¬ 
сов Зігіпд и ПедЕхр, используемых для фактической реализации поиска. 

Таблица 10.6 . Флаги регулярных выражений 


Символ Значение _ 

і Выполняет поиск, нечувствительный к регистру. 


9 


Выполняет глобальный поиск, т. е. находит все соответствия, а не останавлива¬ 
ется после первого из них. 


т 


Многострочный режим. ~ соответствует началу строки или началу всего стро¬ 
кового выражения, а $ - концу строки или всего выражения. 


10.2. Методы класса Бігіпд для поиска по шаблону 

До этого момента мы обсуждали грамматику создаваемых регулярных выраже¬ 
ний, но не рассматривали, как эти регулярные выражения могут фактически ис¬ 
пользоваться в ЛаѵаЗсгірі-сценариях. В данном разделе мы обсудим методы объ¬ 
екта Зіігіпд, в которых регулярные выражения применяются для поиска по шаб¬ 
лону, а также для поиска с заменой. А затем продолжим разговор о поиске по 
шаблону с регулярными выражениями, рассмотрев объект ПедЕхр, его методы 
и свойства. Обратите внимание, что последующее обсуждение - лишь обзор раз¬ 
личных методов и свойств, относящихся к регулярным выражениям. Как обыч¬ 
но, полное описание можно найти в третьей части книги. 

Строки поддерживают четыре метода, использующие регулярные выражения. 
Простейший из них - метод зеагс!і( ). Он принимает в качестве аргумента регуляр¬ 
ное выражение и возвращает либо позицию первого символа найденной подстро¬ 
ки, либо -1, если соответствие не найдено. Например, следующий вызов вернет 4: 

" ^ѵа$с г ірі: ". зеа гсЬ (/зс гі р*/і ); 

Если аргумент метода зеагсІі() не является регулярным выражением, он сначала 
преобразуется путем передачи конструктору ПедЕхр. Метод зеагсІі() не поддержи¬ 
вает глобальный поиск и игнорирует флаг д в своем аргументе. 

Метод гер1асе() выполняет операцию поиска с заменой. Он принимает в качестве 
первого аргумента регулярное выражение, а в качестве второго - строку замены. 
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Метод отыскивает в строке, для которой он вызван, соответствие указанному 
шаблону. Если регулярное выражение содержит флаг д, метод гер1асе( ) заменяет 
все найденные совпадения строкой замены. В противном случае он заменяет толь; 
ко первое найденное совпадение. Если первый аргумент метода гер1асе( ) является 
строкой, а не регулярным выражением, то метод выполняет буквальный поиск 
строки, а не преобразует его в регулярное выражение с помощью конструктора 
ВедЕхрО, как это делает метод зеагсИ(). В качестве примера мы можем воспользо¬ 
ваться методом гер1асе( ) для единообразной расстановки прописных букв в слове 
♦ ^ѵаЗсгірі» для всей строки текста: 

// Независимо от регистра символов заменяем словом в нужном регистре 
*ехІ. гер1асе(/Цаѵа$сгірі:/ді, "ЦаѵаЗсгірі:"); 

Метод гер1асе() представляет собой более мощное средство, чем можно было бы 
предположить по этому примеру. Напомню, что подвыражения в скобках, нахо¬ 
дящиеся внутри регулярного выражения, нумеруются слева направо, и что регу¬ 
лярное выражение запоминает текст, соответствующий каждому из подвыраже¬ 
ний. Если в строке замены присутствует знак $ с цифрой, метод гер1асе() заменя¬ 
ет эти два символа текстом, соответствующим указанному подвыражению. Это 
очень полезная возможность. Мы можем использовать ее, например, для замены 
прямых кавычек в строке типографскими кавычками, которые имитируются 
ЛЗСП-символами: 

// Цитата - это кавычка, за которой следует любое число символов, отличных от кавычек 
// (их мы запоминаем), за этими символами следует еще одна кавычка, 
ѵаг циоіе = /'(Г"]*)7д; 

// Заменяем прямые кавычки типографскими и оставляем без изменений 
// содержимое цитаты, хранящееся в $1. 

Іехі. гер1асе(рію1:е, "«$1»"); 

Метод гер1асе() предоставляет и другие ценные возможности, о которых расска¬ 
зывается в третьей части книги, в справке к методу 51:гіпд.гер1асе(). Самое важ¬ 
ное, что следует отметить, - второй аргумент гер1асе( ) может быть функцией, ди¬ 
намически вычисляющей строку замены. 

Метод та1:сИ() - это наиболее общий из методов класса Зіігіпд, использующих ре¬ 
гулярные выражения. Он принимает в качестве единственного аргумента регу¬ 
лярное выражение (или преобразует свой аргумент в регулярное выражение, пе¬ 
редав его конструктору ВедЕхрО) и возвращает массив, содержащий результаты 
поиска. Если в регулярном выражении установлен флаг д, метод возвращает мас¬ 
сив всех соответствий, присутствующих в строке. Например: 

"1 плюс 2 равно 3”. гпаі: сИ( ДсІ + /д ) // вернет ["1", "2", "З”] 

Если регулярное выражение не содержит флаг д, метод та1:сИ() не выполняет гло¬ 
бальный поиск; он просто ищет первое совпадение. Однако та1:сИ( ) возвращает 
массив, даже когда метод не выполняет глобальный поиск. В этом случае первый 
элемент массива - это найденная подстрока, а все оставшиеся элементы пред¬ 
ставляют собой подвыражения регулярного выражения. Поэтому если таІсРО 
возвращает массив а, то а[0] будет содержать найденную строку целиком, а[1] - 
подстроку, соответствующую первому подвыражению, и т. д. Проводя параллель 
с методом гер1асе(), можно сказать, что в а [п] заносится содержимое $л. 
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Например, взгляните на следующий программный код, выполняющий разбор 
ІЖЬ-адреса: 

ѵаг игі = /( \ѵѵ+):\/\/([\ѵѵ. ]+)\/(\3*)/; 

ѵаг Іехі = "Посетите мою домашнюю страницу ПТ1:р://\ѵѵлѵ.ехатр1е.сот/"с1аѵіс1"; 
ѵаг гезіЛІ: = Тех1:.та1:с1і(иг1); 
і? (гезціі: ! = гшіі) { 

ѵаг ^цііцгі = гезцЩО]; // Содержит "\)ІХ.р://ѵнм. ехатріе. сот/“сіаѵі(Г 

ѵаг ргоіосоі = гезцЩІ]; // Содержит "НПр" 

ѵаг Роз! = гезцЩ2]; // Содержит ”тм. ехатріе. сот" 

ѵаг раІН = гезцЩЗ]; // Содержит "“сІаѵісГ 

} 

Следует отметить, что для регулярного выражения, в котором не установлен 
флаг д глобального поиска, метод та*сН() возвращает то же значение, что и метод 
ехес() регулярного выражения: возвращаемый массив имеет свойства іпсіех 
и іпри*, как описывается в обсуждении метода ехес() ниже. 

Последний из методов объекта 51:гіпд, в котором используются регулярные выра¬ 
жения, - зрШ(). Этот метод разбивает строку, для которой он вызван, на массив 
подстрок, используя аргумент в качестве разделителя. Например: 

"123,456,789". зр1И(","); // Вернет ["123", "456", "789"] 

Метод зрШО может также принимать в качестве аргумента регулярное выраже¬ 
ние. Это делает метод более мощным. Например, можно указать разделитель, до¬ 
пускающий произвольное число пробельных символов с обеих сторон: 

"1, 2, 3 , 4 .5". зрШ(/\з*,\з*/); // Вернет ["1", "2", "3", "4", "5"] 

Метод 5рШ( ) имеет и другие возможности. Полное описание приведено в третьей 
части книги при описании метода Зігіпд. зрШ(). 

10.3. Объект КедЕхр 

Как было упомянуто в начале этой главы, регулярные выражения представлены 
в виде объектов ПедЕхр. Помимо конструктора ПедЕхрО* объекты ПедЕхр поддержи¬ 
вают три метода и несколько свойств. Методы поиска и свойства класса ПедЕхр 
описаны в следующих двух подразделах. 

Конструктор ПедЕхр( ) принимает один или два строковых аргумента и создает но¬ 
вый объект ПедЕхр. Первый аргумент конструктора - это строка, содержащая те¬ 
ло регулярного выражения, т. е. текст, который должен находиться между сим¬ 
волами слэша в литерале регулярного выражения. Обратите внимание, что 
в строковых литералах и регулярных выражениях для обозначения управляю¬ 
щих последовательностей используется символ \, поэтому, передавая конструк¬ 
тору ПедЕхрО регулярное выражение в виде строкового литерала, необходимо за¬ 
менить каждый символ \ парой символов \\. Второй аргумент ПедЕхрО может от¬ 
сутствовать. Если он указан, то определяет флаги регулярного выражения. Это 
должен быть один из символов д, і, т либо комбинация этих символов. Например: 

// Находит все пятизначные числа в строке. Обратите внимание 
// на использование в этом примере символов \\ 
ѵаг іірсосіе = пеѵѵ ВедЕхр("\\с1{5}", "д"); 
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Конструктор ПедЕхр() удобно использовать, когда регулярное выражение создает¬ 
ся динамически и поэтому не может быть представлено с помощью синтаксиса 
литералов регулярных выражений. Например, чтобы найти строку, введенную, 
пользователем, надо создать регулярное выражение во время выполнения с помо¬ 
щью НедЕхр(). 

10.3.1. Свойства КедЕхр 

Каждый объект ПедЕхр имеет пять свойств. Свойство зоигсе - строка, доступная 
только для чтения, содержащая текст регулярного выражения. Свойство діораі - 
логическое значение, доступное только для чтения, определяющее наличие фла¬ 
га д в регулярном выражении. Свойство ідпогеСазе - это логическое значение, дос¬ 
тупное только для чтения, определяющее наличие флага і в регулярном выраже¬ 
нии. Свойство гтшШІіпе- это логическое значение, доступное только для чтения, 
определяющее наличие флага т в регулярном выражении. И последнее свойство 
Іазііпсіех - это целое число, доступное для чтения и записи. Для шаблонов с фла¬ 
гом д это свойство содержит номер позиции в строке, с которой должен быть начат 
следующий поиск. Как описано ниже, оно используется методами ехес() и 1ез1(). 

10.3.2. Методы КедЕхр 

Объекты ПедЕхр определяют два метода, выполняющие поиск по шаблону; они ве¬ 
дут себя аналогично методам класса Зіігіпд, описанным выше. Основной метод 
класса ПедЕхр, используемый для поиска по шаблону, - ехес(). Он похож на упоми¬ 
навшийся метод таісІіО класса Зіігіпд, за исключением того, что является мето¬ 
дом класса ПедЕхр, принимающим в качестве аргумента строку, а не методом 
класса Зіігіпд, принимающим аргумент ПедЕхр. Метод ехес() выполняет регуляр¬ 
ное выражение для указанной строки, т. е. ищет совпадение в строке. Бели совпа¬ 
дение не найдено, метод возвращает пиіі. Однако если соответствие найдено, он 
возвращает такой же массив, как массив, возвращаемый методом таісГіО для по¬ 
иска без флага д. Нулевой элемент массива содержит строку, соответствующую 
регулярному выражению, а все последующие элементы - подстроки, соответст¬ 
вующие всем подвыражениям. Кроме того, свойство іпсіех содержит номер пози¬ 
ции символа, которым начинается соответствующий фрагмент, а свойство іприі 
ссылается на строку, в которой выполнялся поиск. 

В отличие от та1ісІі( ), метод ехес() возвращает массив, структура которого не зави¬ 
сит от наличия в регулярном выражении флага д. Напомню, что при передаче гло¬ 
бального регулярного выражения метод таісИ() возвращает массив найденных 
соответствий. А ехес() всегда возвращает одно соответствие, но предоставляет 
о нем полную информацию. Когда ехес() вызывается для регулярного выраже¬ 
ния, содержащего флаг д, метод устанавливает свойство Іазііпсіех объекта регу¬ 
лярного выражения равным номеру позиции символа, следующего непосредст¬ 
венно за найденной подстрокой. Когда метод ехес() вызывается для того же регу¬ 
лярного выражения второй раз, он начинает поиск с символа, позиция которого 
указана в свойстве Іазііпсіех. Если ехес() не находит соответствия, свойство Іазі- 
Іпсіех получает значение 0. (Вы также можете установить Іазііпсіех в ноль в любой 
момент, что следует делать во всех тех случаях, когда поиск завершается до того, 
как будет найдено последнее соответствие в одной строке, и начинается поиск 
в другой строке с тем же объектом ПедЕхр.) Это особое поведение позволяет вызы- 
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ватъ ехес() повторно для перебора всех соответствий регулярному выражению 
в строке. Например: 

ѵаг раііегп = Діаѵа/д; 

ѵаг іехі = ’^аѵаЗсгірі: - это более забавная штука, чем ^ѵа!"; 

ѵаг гезиіі: ; 

ѵѵ/Иі1е((гезиіі: = раііегп.ехес(ТехТ)) != пиі 1) { 

аіегі;("Найдено + гезцЩО] + + 

в позиции ■' + гезиіі;. іпсіех + 

следующий поиск начнется с " + раііегп. Іазііпсіех); 

} 

Еще один метод объекта НедЕхр - 1ез1:(), который намного проще метода ехес(). Он 
принимает строку и возвращает ігие, если строка соответствует регулярному вы¬ 
ражению: 

ѵаг раПегп = /заѵа/і; 

раиегп.іезіС^аѵаЗсгірі:"); // Вернет ігце 

Вызов 1ез1:() эквивалентен вызову ехес(), возвращающему ігие, если ехес() возвра¬ 
щает не гшП. По этой причине метод 1ез1:() ведет себя так же, как метод ехес() при 
вызове для глобального регулярного выражения: он начинает искать указанную 
строку с позиции, заданной свойством Іазііпсіех, и если находит соответствие, ус¬ 
танавливает свойство Іазііпсіех равным номеру позиции символа, непосредствен¬ 
но следующего за найденным соответствием. Поэтому с помощью метода ІезіО 
можно так же сформировать цикл обхода строки, как с помощью метода ехес(). 

Методы зеагсМО, герІасеО и таісІіО класса Зігіпд не используют свойство Іазііпсіех, 
в отличие от методов ехес() и 1ез1:(). На самом деле методы класса Зігіпд просто 
сбрасывают Іазііпсіех в 0. Если метод ехес() или ІезіО использовать с шаблоном, 
в котором установлен флаг д, и выполнить поиск в нескольких строках, то мы 
должны либо найти все соответствия в каждой строке, чтобы свойство Іазііпсіех 
автоматически сбросилось в ноль (это происходит, когда последний поиск оказы¬ 
вается неудачным), либо явно установить свойство ІазІІпсіех равным нулю. Если 
этого не сделать, поиск в новой строке может начаться с некоторой произвольной 
позиции, а не с начала. Если регулярное выражение не включает флаг д, то вам не 
придется беспокоиться об этом. Имейте также в виду, что в ЕСМА8сгірі 5, когда 
интерпретатор встречает литерал регулярного выражения, он создает новый объ¬ 
ект ПедЕхр, со своим собственным свойством Іазііпсіех, что снижает риск использо¬ 
вания «левого» значения Іазііпсіех по ошибке. 




11 

Подмножества и расширения іаѵаЗсгірі 


До сих пор в книге описывалась официальная версия языка ЛѵаЗсгірі, соответ¬ 
ствующая стандартам ЕСМАЗсгірі 3 и ЕСМАЗсгірі 5. В этой главе, напротив, бу¬ 
дет идти речь о подмножествах и надмножествах языка ЛѵаЗсгірі. Подмножест¬ 
ва языка были определены, по большей части, для обеспечения более высокого 
уровня безопасности: сценарий, использующий только безопасное подмножество 
языка, может использоваться без опаски, даже если он был получен из непрове¬ 
ренного источника, такого как рекламный сервер. В разделе 11.1 описываются 
некоторые из этих подмножеств. 

Стандарт ЕСМАЗсгірі 3 был опубликован в 1999 году, и прошло десять лет, пре¬ 
жде чем стандарт был обновлен до версии ЕСМАЗсгірі 5, вышедшей в 2009 году. 
Брендан Эйх (Вгепсіап ЕісЬ), создатель ЛѵаЗсгірі, продолжал развивать язык на 
протяжении всех этих десяти лет (спецификация ЕСМАЗсгірі явно разрешает 
расширение языка) и совместно с проектом Могіііа выпустил версии ЛаѵаЗсгірі 
1.5, 1.6, 1.7, 1.8 и 1.8.1 в Гігеіох 1.0, 1.5, 2, 3 и 3.5. Некоторые из расширенных 
особенностей ^ѵаЗсгірі вошли в стандарт ЕСМАЗсгірі 5, но многие остаются не¬ 
стандартизованными. Однако, как ожидается, некоторые из оставшихся нестан¬ 
дартных особенностей будут стандартизованы в будущем. 

Эти расширения поддерживаются броузером Рігеіох, точнее, реализованным в нем 
интерпретатором Зрісіегтопкеу языка ЛаѵаЗсгірі. Созданный проектом Могіііа 
интерпретатор Шііпо языка ЛаѵаЗсгірі, написанный на языке Лаѵа (раздел 12.1), 
также поддерживает большинство расширений. Однако, поскольку эти расшире¬ 
ния языка не являются стандартными, они не особенно полезны для веб-разра¬ 
ботчиков, которым требуется обеспечить совместимость своих веб-приложений 
со всеми броузерами. Тем не менее они описываются в этой главе, потому что они: 

• чрезвычайно мощные; 

• могут быть стандартизованы в будущем; 

• могут использоваться при разработке расширений для Гігеіох; 

• могут использоваться для разработки серверных сценариев на языке ЛаѵаЗсгірі, 
когда используется интерпретатор Зрісіегтопкеу или Шііпо (раздел 12.1). 
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Вводный раздел был посвящен подмножествам языка, остальная же часть этой 
главы описывает расширения языка. Поскольку они нестандартизованы, они по¬ 
даются в виде учебных материалов, с меньшим количеством строгих определе¬ 
ний, чем особенности языка, описываемые в других главах книги. 

11.1. Подмножества .ІаѵаБсгірІ 

Большая часть подмножеств языка была определена с целью обеспечения без¬ 
опасности при выполнении программного кода, полученного из непроверенных 
источников. Однако существует одно интересное подмножество языка, которое 
было создано по другим причинам. Мы рассмотрим его в первую очередь, а затем 
перейдем к подмножествам языка, цель которых заключается в обеспечении без¬ 
опасности. 

11.1.1. Подмножество ТНе СоосІ РаП$ 

Небольшая книга Дугласа Крокфорда (Бои^іаз Сгоскйэгб) « ЛѵаВсгірі: ТЬе Сооб 
Рагіз» (О’КеШу) описывает подмножество ЛѵаВсгірі, включающее части языка, 
которые, по мнению автора, достойны использования. Цель этого подмножества - 
упростить язык, скрыть его недостатки и в конечном счете сделать программиро¬ 
вание проще, а программы - лучше. Крокфорд так объясняет свои устремления: 

Большинство языков программирования имеют свои достоинства и недостат¬ 
ки. Я обнаружил, что могу писать более качественные программы, используя 
достоинства и избегая недостатков. 

Подмножество Крокфорда не включает инструкции ѵ\/і1:М и сопіііпие, а также функ¬ 
цию еѵа1( ). Оно позволяет определять функции только с помощью выражений оп¬ 
ределения и не содержит инструкции определения функций. Подмножество тре¬ 
бует, чтобы тела циклов и условных инструкций заключались в фигурные скоб¬ 
ки: оно не позволяет опускать скобки, даже если тело состоит из единственной 
инструкции. Оно требует, чтобы любая инструкция, не заканчивающаяся фи¬ 
гурной скобкой, завершалась точкой с запятой. 

Подмножество не включает оператор точки, битовые операторы и операторы ++ 
и —. В нем также не допускается использовать операторы == и ! = из-за выполняе¬ 
мых ими преобразований типов и требуется использовать вместо них операторы 

=== и !==. 

Поскольку в языке ЛѵаВсгірі отсутствует понятие области видимости блока, 
подмножество Крокфорда разрешает использовать инструкцию ѵаг только на 
верхнем уровне тела функции и требует, чтобы программист объявлял все ло¬ 
кальные переменные функции с помощью единственной инструкции ѵаг - первой 
в теле функции. Подмножество не поощряет использование глобальных перемен¬ 
ных, но это уже простое соглашение по программированию, а не фактическое ог¬ 
раничение языка. 

Созданный Крокфордом веб-инструмент проверки качества программного кода 
(кіір://]8Ііпі.сот) включает возможность проверки на соответствие требованиям 
подмножества Сооб Рагіз. Помимо проверок на отсутствие в программном коде 
недопустимых особенностей, инструмент ДОІлпі также проверяет соблюдение об¬ 
щепринятых правил оформления, таких как корректное оформление отступов. 
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Крокфорд написал свою книгу до того, как в ЕСМАЗсгірі 5 был определен стро¬ 
гий режим, и теперь многие «недостатки» ЛѵаВсгірі, использование которых он 
осуждает в своей книге, могут быть запрещены за счет использования строгого- 
режима. Теперь, с принятием стандарта ЕСМАЗсгірі 5, инструмент ^Ьіпі требу¬ 
ет, чтобы программы включали директиву «иве зігісі», если перед проверкой был 
включен параметр «ТЬе Сооб Рагіз». 

11.1.2. Безопасные подмножества 

Сооб Рагіз - это подмножество языка, созданное исходя из эстетических сообра¬ 
жений и желания повысить производительность труда программиста. Существу¬ 
ет также обширная категория подмножеств, созданных с целью повышения без¬ 
опасности при выполнении программного кода ЛѵаВсгірі в безопасном окруже¬ 
нии, или в «песочнице». Безопасные подмножества запрещают использование 
особенностей языка и библиотек, которые позволяют программному коду вы¬ 
рваться за пределы «песочницы» и влиять на глобальное окружение. Каждое под¬ 
множество снабжается статическим инструментом проверки, который анализи¬ 
рует программный код, чтобы убедиться, что он соответствует требованиям под¬ 
множества. Поскольку подмножества языка, которые могут пройти статическую 
проверку, обычно оказываются довольно ограниченными, некоторые системы ор¬ 
ганизации безопасного окружения определяют большее, не так сильно ограничи¬ 
вающее, подмножество, добавляют этап трансформации программного кода, на 
котором выполняется проверка его соответствия более широкому подмножеству, 
и производят трансформацию программного кода для использования с более уз¬ 
ким подмножеством языка. А кроме того, добавляют проверки времени выполне¬ 
ния в тех случаях, когда статический анализ программного кода не гарантирует 
полную безопасность. 

Чтобы обеспечить приемлемый уровень безопасности при статической проверке, 
из языка ЛѵаВсгірі должны быть исключены следующие особенности: 

• Ни в одном безопасном подмножестве не допускается использовать функцию 
еѵа1() и конструктор РипсііопО, потому что они позволяют выполнять произ¬ 
вольные строки программного кода, которые невозможно проверить стати¬ 
чески. 

• Ограничивается или полностью исключается возможность использовать клю¬ 
чевое слово ІМІ5, потому что функции (в нестрогом режиме) с помощью Шз 
могут получить доступ к глобальному объекту. Предотвращение доступа к гло¬ 
бальному объекту является одной из основных целей любых систем организа¬ 
ции безопасного окружения. 

• Зачастую в безопасных подмножествах запрещается использовать инструк¬ 
цию мИЬ, потому что она усложняет статическую проверку программного 
кода. 

• В безопасных подмножествах не допускается использовать некоторые гло¬ 
бальные переменные. В клиентском ЛѵаВсгірі объект окна броузера дублиру¬ 
ет глобальный объект, поэтому программному коду запрещается ссылаться на 
объект міпсісм. Аналогично клиентский объект сіоситепі: определяет методы, 
обеспечивающие полный контроль над содержимым страницы. Это слишком 
мощный инструмент, чтобы доверить его программному коду, не вызывающе¬ 
му доверия. Безопасные подмножества могут обеспечивать два разных подхода 




11.1. Подмножества ІаѵаБсгір* 


293 


к глобальным переменным, таким как сіоситепі:. Они могут полностью запре¬ 
щать их использование и определять дополнительные функции, которые мо¬ 
гут использоваться программным кодом, заключенным в безопасное окруже¬ 
ние, для доступа к ограниченной части веб-страницы, выделенной для него. 
Другой подход заключается в том, что безопасное окружение, в котором вы¬ 
полняется программный код, может определять промежуточный объект сіоси¬ 
тепі;, реализующий только безопасную часть стандартного БОМ АРІ. 

• В безопасных подмножествах не допускается использовать некоторые специ¬ 
альные свойства и методы, потому что они дают слишком широкие возможно¬ 
сти потенциально небезопасному программному коду. В число таких свойств 
и методов обычно включаются свойства саііег и саііее объекта агдитепііз (неко¬ 
торые подмножества вообще запрещают использовать объект агдитепііз), мето¬ 
ды са11() и арр1у() функций, а также свойства сопзіігисііог и ргоіоіуре. Кроме 

того, запрещается использовать нестандартные свойства, такие как_ ргоііо _. 

Некоторые подмножества идут по пути явного запрещения использования не¬ 
безопасных свойств и глобальных переменных. Другие идут по пути разреше¬ 
ния доступа только к определенным, безопасным свойствам. 

• Статический анализ с легкостью выявляет доступ к специальным свойствам, 
когда выражение доступа к свойству использует оператор точки. Но проверить 
присутствие обращений с помощью [ ] гораздо сложнее, потому что статиче¬ 
ский анализ не позволяет проверить все возможные варианты строковых вы¬ 
ражений в квадратных скобках. По этой причине безопасные подмножества 
обычно запрещают использование квадратных скобок, если только выраже¬ 
ние в них не является числовым или строковым литералом. Безопасные под¬ 
множества замещают операторы [] вызовами глобальных функций, выпол¬ 
няющих чтение и запись в свойства объектов - эти функции выполняют до¬ 
полнительные проверки во время выполнения, чтобы убедиться, что про¬ 
граммный код не пытается обратиться к запрещенным свойствам. 

Некоторые из этих ограничений, такие как запрет на использование функции 
еѵа1() и инструкции мИЬ, не слишком обременительны для программистов, пото¬ 
му что эти особенности обычно не используются при программировании на языке 
ЛѵаВсгірі. Другие, такие как ограничение на использование квадратных скобок 
для доступа к свойствам, являются достаточно тяжелыми, и здесь на помощь 
приходит механизм трансляции программного кода. Транслятор может автома¬ 
тически преобразовать использование квадратных скобок, например, в вызовы 
функций, выполняющие дополнительные проверки во время выполнения. С по¬ 
мощью аналогичных трансформаций можно обезопасить использование ключе¬ 
вого слова Шз. Правда, в этом случае за безопасность приходится заплатить 
уменьшением скорости выполнения программного кода в безопасном окружении. 

В настоящее время существует несколько безопасных подмножеств. И хотя пол¬ 
ное их описание их выходит за рамки этой книги, тем не менее мы коротко позна¬ 
комимся с некоторыми из наиболее известных: 

АБэа/е 

Подмножество АБзаіЪ (Мір://а<І8а{е.ог8) было одним из первых предложенных 
безопасных подмножеств. Это подмножество было создано Дугласом Крокфор- 
дом (Бои&іаз Сгоскйэгсі) (который также определил подмножество ТЬе Сооб 
Рагіз). Подмножество АБза^е опирается только на статическую проверку. 
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которая выполняется с помощью инструмента ^Ілпі (кЫр://І8Ііпі.огё). Оно за¬ 
прещает доступ к большинству глобальных переменных и определяет перемен¬ 
ную АйЗАРЕ, которая предоставляет доступ к безопасным функциям, включая, 
методы БОМ специального назначения. Подмножество АБзаІе не получило 
широкого распространения, но оно стало важным доказательством правильно¬ 
сти самой концепции и послужило толчком к появлению других безопасных 
подмножеств. 

йо]Ох.8есиге 

Подмножество йо]ох.зесыге ( кіір://ипѵіѵ.8ііереп.сот/Ыо(*/2008/08/01/8есиге-та - 
8кир8-іѵіік-<І0]0Х8есиге/) - это расширение для библиотеки Боіо (М1р://(1о}о1оо1- 
кіі.огв ), толчком к созданию которого послужило появление подмножества 
АБзаІе. Подобно АБза^е, это подмножество основано на статической проверке 
использования ограниченного подмножества языка. В отличие от АБзаІе, оно 
позволяет использовать стандартный БОМ АРІ. Кроме того, оно включает ин¬ 
струмент проверки, реализованный на языке ЛѵаВсгірі, благодаря чему име¬ 
ется возможность динамической проверки программного кода перед его вы¬ 
полнением. 

Сща 

Подмножество Саіа (кіір://сосІе.боо&Іе.сот/р/боо&Іе-саіа/) - это подмножество, 
распространяемое с открытыми исходными текстами, созданное компанией 
Ооо^іе. Подмножество Саіа (по-испански «коробка») определяет два подмно¬ 
жества языка. Подмножество Саіііа («маленькая коробка») - сильно ограни¬ 
ченное подмножество, подобное тому, которое используется подмножествами 
АБза^е и (іоіох.зесиге. Ѵаіца («кейс» или «чемодан») - намного более широкое 
подмножество языка, близкое к подмножеству строгого режима ЕСМАБсгірі 5 
(с исключением еѵа1( )). Само название Саіа - это имя компилятора, трансфор¬ 
мирующего веб-содержимое (НТМЬ, С88 и программный код ЛѵаЗсгірі) в без¬ 
опасные модули, которые можно включать в веб-страницы, не опасаясь, что 
они будут оказывать влияние на страницу в целом или на другие модули. 

Подмножество Саіа - это часть ОрепЗосіаІ АРІ (і Мір://со<Іе.8ооёІе.сот/арі8/ореп- 
зосіаі /); оно используется компанией ѴаЬоо! на ее веб-сайтах. Например, со¬ 
держимое, доступное на портале кіір://ту.уакоо.сот 9 организовано в модули 
Саіа. 

ГВЖ 

Подмножество ГВ^ - это версия ЛѵаЗсгірі, используемая на сайте ГасеЪоок 
(кіір://{асеЬоок.сот) с целью дать пользователям возможность размещать не¬ 
проверенное содержимое на страницах своих профилей. Подмножество ГІЫ8 
обеспечивает безопасность за счет трансформации программного кода. Инст¬ 
румент преобразования вставляет проверки, которые выполняются во время 
выполнения и предотвращают доступ к глобальному объекту с помощью клю¬ 
чевого слова ІіМіз. Также он переименовывает все идентификаторы верхнего 
уровня, добавляя к ним префикс, определяемый модулем. Благодаря пере¬ 
именованию предотвращаются любые попытки изменить или прочитать гло¬ 
бальные переменные или переменные, принадлежащие другому модулю. Кро¬ 
ме того, благодаря добавлению префикса, все вызовы функции еѵа1() преобра¬ 
зуются в вызовы несуществующей функции. Подмножество ГІЫ8 реализует 
собственное безопасное подмножество БОМ АРІ. 
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Місго8о{і \ѴеЬ ЗапйЬох 

Подмножество МісгозоН ЛѴеЬ 8апс1Ьох (кіір://іѵеЪ8ап(ЦюхЛіѵеІаЪ8.сот/) опре¬ 
деляет довольно широкое подмножество языка ЛѵаЗсгірі (плюс НТМЬ и С88) 
и обеспечивает безопасность за счет радикальной переработки программного 
кода, фактически реализуя безопасную виртуальную машину ЛѵаЗсгірі по¬ 
верх небезопасной. 


11.2. Константы и контекстные переменные 

Теперь оставим подмножества языка и перейдем к расширениям. В версии Лѵа- 
Зсгірі 1.5 и выше появилась возможность использовать ключевое слово сопзі для 
определения констант. Константы похожи на переменные, за исключением того, 
что попытки присваивания им значений игнорируются (они не вызывают ошиб¬ 
ку), а попытка переопределить константу приводит к исключению: 


сопзі рі = 3.14; 
рі = 4; 
сопзі рі = 4; 
ѵаг рі = 4; 


// Определить константу и дать ей значение. 

// Любые последующие операции присваивания игнорируются. 
// Повторное объявление константы считается ошибкой. 

// Это тоже ошибка. 


Ключевое слово сопзі; действует подобно ключевому слову ѵаг: для него не сущест¬ 
вует области видимости блока и объявления константы поднимаются в начало 
вмещающего определения функции (раздел 3.10.1). 

Отсутствие в языке ЛѵаЗсгірі области видимости блока для переменных долгое 
время считали недостатком, поэтому в версии ЛѵаЗсгірі 1.7 появилось ключевое 
слово Іеі:, решающее эту проблему. Ключевое слово сопзі: всегда было зарезерви¬ 
рованным (но не используемым) словом в ЛѵаЗсгірі, благодаря чему константы 
можно добавлять, не нарушая работоспособность существующего программного 
кода. Ключевое слово Іеі: не было зарезервировано, поэтому оно не распознается 
версиями интерпретаторов ниже 1.7. 

Ключевое слово Іеі: имеет четыре формы использования: 

• как инструкция объявления переменной, подобно инструкции ѵаг; 

• в циклах ^ог или ^ог/іп, как замена инструкции ѵаг; 

• как инструкция блока, для объявления новых переменных и явного ограни¬ 
чения их области видимости; и 

• для определения переменных, область видимости которых ограничивается 
единственным выражением. 

В простейшем случае ключевое слово Іеі: используется как замена инструкции 
ѵаг. Переменные, объявленные с помощью инструкции ѵаг, определены в любой 
точке объемлющей функции. Переменные, объявленные с помощью ключевого 
слова Іеі, определены только внутри ближайшего вмещающего блока (и, конечно 
же, внутри вложенных в него блоков). Если с помощью инструкции Іеі объявить 
переменную, например, внутри тела цикла, она будет недоступна за пределами 
этого цикла: 


Іііпсііоп осісізцтз(п) { 

Іеі Іоіаі = 0, гезц11=[]; // Определены в любой точке функции 

1ог(1е1 х = 1; х <= п; х++) { // переменная х определена только в цикле 
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Іеі осісі = 2*х-1; // переменная осісі определена только в цикле 

Іоіаі += осісі; 
гезиіі.ризП(ІоІаІ)* 

} 

// Попытка обратиться к переменной х или осісі здесь 
// вызовет исключение ВеГегепсеЕггог 
геіигп гезиіі; 

} 

осісізитз( 5); // Вернет [1,4,9,16,25] 

Обратите внимание, что в этом примере инструкция Іеі используется так же, как 
замена инструкции ѵаг в цикле Гог. Она создает переменную, которая будет дос¬ 
тупна только в теле цикла и в выражениях проверки условия и увеличения цик¬ 
ла. Точно так же можно использовать инструкцию Іеі в циклах Гог/іп (и Гог еасіі; 
раздел 11.4.1): 

о = {х:1, у:2}; 

Гог(1еІ р іп о) сопзоіе. 1од(р); // Выведет х и у 

Гог еасП(1еГ ѵ іп о) сопзоіе.1од(ѵ); // Выведет 1 и 2 

сопзоіе. 1од(р) // ПеГегепсеЕггог: р не определена 

Существует одно интересное отличие между случаями, когда Іеі используется 
как инструкция объявления и когда Іеі используется как инструмент инициали¬ 
зации переменной цикла. При использовании Іеі в качестве инструкции объяв¬ 
ления значение выражения инициализации вычисляется в области видимости 
переменной. Но в цикле Гог выражение инициализации вычисляется за предела¬ 
ми области видимости новой переменной. Это отличие становится важным, толь¬ 
ко когда имя новой переменной совпадает с именем уже существующей пере¬ 
менной: 

Іеі х = 1; 

Гог(1еІ х = х + 1; х<5; х++) 

сопзоіе. 1од(х); // Выведет 2,3,4 

{ // Начало блока, чтобы образовать область видимости новой переменной 

Іеі х = х + 1; // переменная х не определена, поэтому х+1 = ИаИ 

сопзоіе. 1од(х); // Выведет ИаИ 

} 

Переменные, объявленные с помощью инструкции ѵаг, определены в любой точке 
функции, где они объявлены, но они не инициализируются, пока инструкция ѵаг 
не будет выполнена фактически. То есть переменная существует (обращение 
к ней не вызывает исключение ПеГегепсеЕггог), но при попытке использовать пере¬ 
менную до инструкции ѵаг она будет иметь значение ипсіеГіпесІ. Переменные, объ¬ 
являемые с помощью инструкции Іеі, действуют аналогично: если попытаться 
использовать переменную до инструкции Іеі (но внутри блока, где находится ин¬ 
струкция Іеі), переменная будет доступна, но она будет иметь значение ипсіеГіпесІ. 

Примечательно, что данная проблема отсутствует при использовании Іеі для 
объявления переменной цикла - просто сам синтаксис не позволяет использовать 
переменную до ее инициализации. Существует еще один случай использования 
инструкции Іеі, где отсутствует проблема использования переменной до ее ини¬ 
циализации. Блок, образуемый инструкцией Іеі (в противоположность объявле- 
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нию переменной с помощью инструкции Іеі, показанному выше), объединяет блок 
программного кода с объявлением переменных для этого блока и их инициализа¬ 
цией. В этом случае переменные и выражения их инициализации заключаются 
в круглые скобки, за которыми следует блок инструкций в фигурных скобках: 

Іеі х=1, у=2; 

Іеі (х=х+1,у=х+2) { // Отметьте, что здесь выполняется сокрытие переменных 

сопзоіе. 1од(х+у); // Выведет 5 

}; 

сопзоіе. 1од(х+у); // Выведет 3 

Важно запомнить, что выражения инициализации переменных Іеі-блока не яв¬ 
ляются частью этого блока и интерпретируются в другой области видимости. 
В примере выше создается новая переменная х, и ей присваивается значение, на 
единицу больше, чем значение существующей переменной х. 

Последний случай использования ключевого слова Іеі: является разновидностью 
Іеі-блока, в котором вслед за списком переменных и выражений инициализации 
в круглых скобках следует единственное выражение, а не блок инструкций. Та¬ 
кая конструкция называется Іеі-выражением, а пример выше можно было пере¬ 
писать, как показано ниже: 

Іеі х=1, у=2; 

сопзоіе.1од(1еІ (х=х+1,у=х+2) х+у); // Выведет 5 

Некоторые формы использования ключевых слов сопзі и Іеі (не обязательно все 
четыре, описанные здесь) в будущем наверняка будут включены в стандарт 
ЕСМАВсгірі. 


Версии .ІаѵаЗсгірі 

В этой главе при упоминании какой-то определенной версии ЛѵаВсгірі 
подразумевается версия языка, реализованная проектом МогШа в интер¬ 
претаторах ВрМегтопкеу и Шііпо и в веб-броузере Гігеіох. 

Некоторые расширения языка, представленные здесь, определяют новые 
ключевые слова (такие как Іеі), и, чтобы избежать нарушения работоспо¬ 
собности существующего программного кода, использующего эти ключе¬ 
вые слова, ЛѵаВсгірі требует явно указывать версию, чтобы иметь возмож¬ 
ность использовать расширения. Если вы пользуетесь автономным интер¬ 
претатором Врібегтопкеу или Юііпо, версию языка можно указать в виде 
параметра командной строки или вызовом встроенной функции ѵегзіоп(). 
(Она ожидает получить номер версии, умноженный на сто. Чтобы полу¬ 
чить возможность использовать ключевое слово Іеі, нужно выбрать версию 
ЛѵаВсгірі 1.7, т.е. передать функции число 170.) В Гігеіох указать номер 
версии можно в теге зсгірі: 

<зсгірі Іуре=”арр1ісаІіоп/0аѵаЗсгірІ; ѵегзіоп=1 .8"> 
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11.3. Присваивание с разложением 

В версии ЗрМегтопкеу 1.7 реализована разновидность составных инструкций 
присваивания, известная как присваивание с разложением . (Вы могли встречать 
присваивание с разложением в языках программирования РуіЬоп или КиЪу.) 
При присваивании с разложением значение справа от знака «равно» является 
массивом или объектом («составным» значением), а слева указывается одно или 
более имен переменных с применением синтаксиса, имитирующего литерал мас¬ 
сива или объекта. 

Инструкция присваивания с разложением извлекает (разлагает на составляю¬ 
щие) одно или более значений из значения справа и сохраняет в переменных, ука¬ 
занных слева. Кроме того, как и обычный оператор присваивания, присваивание 
с разложением может использоваться для инициализации вновь объявляемых 
переменных в инструкциях ѵаг и Іеі:. 

Присваивание с разложением является простым и мощным инструментом при 
работе с массивами, и его особенно удобно использовать при работе с функциями, 
возвращающими массивы значений. Однако при использовании с объектами 
и вложенными объектами эта операция становится сложной и запутанной. При¬ 
меры, демонстрирующие простоту и сложность, приводятся ниже. 

Следующий пример демонстрирует простоту присваивания с разложением при 
использовании с массивами значений: 


1е* [х,у] = [1,2]: 
[X.у] = [х+І.у+1]; 
[Х.у] = [у. х]; 
сопзоіе. 1од([х,у]); 


// То же, что и Іеі: х=1, у=2 
// То же, что и х = х + 1, у= у+1 
// Обмен значений двух переменных 
// Выведет [3,2] 


Обратите внимание, как присваивание с разложением упрощает работу с функ¬ 
циями, возвращающими массивы значений: 

// Преобразует координаты [х.у] в полярные координаты [г.ІНеІа] 

^ипсНоп роіаг(х.у) { 

геіигп [МаІИ.здгі:(х*х+у*у), МаІй.а*ап2(у,х)]; 

} 

// Преобразует полярные координаты в декартовы координаты 
^ипсііоп сагіезіап(г,ійеІа) { 

геіигп [г*Ма*Іі.со5(‘Ыіе'Ьа), г*Ма*й.5іп(ІІіе*а)]; 

} 


Іеі: [г,ііітеііа] = ро1аг(1.0, 1.0): // г=Ма1:Н. зрП:(2), *&еІа=Ма - Ыі.РІ/4 

Іеі: [х,у] = саг1:езіап(г,ІИеІа); // х=1.0, у=1.0 

При выполнении присваивания с разложением количество переменных слева не 
обязательно должно совпадать с количеством элементов массива справа. Лишние 
переменные слева получат значения ішсІеТіпесі, а лишние значения справа будут 
просто игнорироваться. Список переменных слева может включать дополнитель¬ 
ные запятые, чтобы пропустить определенные значения справа: 

Іеі: [х.у] = [1]; // х = 1, у = ііпсіеі'іпесі 

[х.у] = [1,2,3]; // х = 1, у = 2 

[.X,,у] = [1,2,3,4]; // х = 2, у = 4 
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В ЛѵаВсгірі отсутствует синтаксическая конструкция, которая позволила бы 
присвоить переменной все оставшиеся или неиспользованные значения (как мае* 
сив). Так, во второй строке в примере выше, отсутствует возможность присвоить 
переменной у остаток массива [2,3]. 

Значением инструкции присваивания с разложением является полная структура 
данных справа, а не отдельные значения, извлеченные из нее. То есть из операто¬ 
ров присваивания можно составлять «цепочки», как показано ниже: 

Іеі: Мгз*. зесопсі, аіі; 

аіі = [Нгз*. зесопсі] = [1,2,3,4]; // Нгз*=1, зесопб=2, а11=[ 1.2,3,4] 

Присваивание с разложением можно даже использовать для извлечения значе¬ 
ний из вложенных массивов. В этом случае левая сторона инструкции присваи¬ 
вания должна выглядеть как литерал вложенного массива: 

Іеі: [опе, [іѵу/оА, ЪюВ]] = [1, [2,2.5], 3]: // опе=1, і\люА=2, і\л/оВ=2.5 

Присваивание с разложением можно также выполнять, когда справа находится 
объект. В этом случае конструкция слева должна выглядеть как литерал объек¬ 
та: список пар имен свойств и имен переменных, разделенных запятыми, заклю¬ 
ченный в фигурные скобки. Имя слева от каждого двоеточия - это имя свойства, 
а имя справа от каждого двоеточия - это имя переменной. Каждое свойство, ука¬ 
занное слева, будет отыскиваться в объекте справа от оператора присваивания, 
и его значение (или ипсіе^іпесі) будет присвоено соответствующей переменной. Эта 
разновидность присваивания с разложением может сбивать с толку, особенно ес¬ 
ли в качестве имен свойств и переменных используются одни и те же идентифи¬ 
каторы. Необходимо понимать, что в примере ниже г, д и Ь - это имена свойств, 
а гес), дгееп и Ыію - имена переменных: 

Іеі: Ігапзрагепі: = {г:0.0, д:0.0. Ь:0.0, а: 1.0}: // Цвет в формате РСВА 
Іеі: {г: гес), д:дгееп, Ь:Ыие} = Ігапзрагепі:; // гесі=0.0,дгееп=0. 0, Ыие=0. 0 

Следующий пример копирует глобальные функции из объекта МаІіИ в переменные 
с целью упростить программирование большого количества тригонометриче¬ 
ских операций: 

// То же, что и Іеі: зіп=Ма1:Іі.зіп, соз=Ма1:Іі.соз, Іап=Ма‘Ыі.'Ьап 
Іеі: {зіп:зіп, соз:соз, 1ап:1:ап} = Ма1:Іт: 

Подобно тому как присваивание с разложением может использоваться при рабо¬ 
те с вложенными массивами, эта операция может использоваться при работе 
с вложенными объектами. В действительности, эти два синтаксиса можно комби¬ 
нировать для описания произвольных структур данных. Например: 

// Вложенная структура данных: объект содержит массив объектов 
Іеі: сіаіа = { 

пате: "присваивание с разложением", 

Іуре: "расширение", 

ітрі: [{епдіпе: "зріеіегтопкеу" , ѵегзіоп: 1.7}, 

{епдіпе: "гРіпо", ѵегзіоп: 1.7}] 

}; 


// Использовать присваивание с разложением для извлечения 
// четырех значений из структуры данных 

Іеі: ({пате: ^еаіііге, ітрі: [{епдіпе:ітріі, ѵегзіоп:ѵ1}, {епдіпе:ітр12}]} = сіаіа) { 
сопзоіе.Іод^еаіііге); // Выведет "присваивание с разложением" 
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сопзоіе. Іод(ітрП); // Выведет "зрібегтопкеу" 

сопзоіе.Іод(ѵІ); // Выведет 1.7 

сопзоіе.1од(ітр12); // Выведет "гРіпо" 

} 

Имейте в виду, что подобные вложенные инструкции присваивания с разложени¬ 
ем могут превратить программный код в трудночитаемые дебри, вместо того что¬ 
бы упростить его. Однако есть одна интересная закономерность, которая поможет 
вам разобраться в самых сложных случаях. Представьте сначала обычное при¬ 
сваивание (с единственным значением). После того как присваивание будет вы¬ 
полнено, переменную слева от оператора присваивания можно взять и использо¬ 
вать как выражение, которое будет возвращать присвоенное значение. Мы гово¬ 
рили, что в инструкции присваивания с разложением слева указывается синтак¬ 
сическая конструкция, напоминающая литерал массива или объекта. Но обратите 
внимание, что после выполнения присваивания с разложением программный 
код слева, который выглядит как литерал массива или объекта, действительно 
будет интерпретироваться как обычный литерал массива или объекта: все необ¬ 
ходимые переменные будут определены, и вы сможете копировать текст слева от 
знака «равно» и использовать его в своей программе как массив или объект. 

11.4. Итерации 

Проектом Могіііа в расширение ЛѵаВсгірі были добавлены новые способы вы¬ 
полнения итераций, включая цикл Гог еасЬ, а также итераторы и генераторы 
в стиле языка РуіЬоп. Они детально описываются ниже. 

11.4.1. Цикл {ог/еасН 

Цикл Гог/еасЬ - это новая инструкция цикла, определяемая стандартом Б4Х. Е4Х 
(ЕСМАЗсгірі Гог ХМЬ) - это расширение языка, позволяющее употреблять в про¬ 
граммах на языке ЛѵаВсгірі теги языка ХМЬ и предоставляющее функции для 
работы с данными в формате ХМЬ. Стандарт Е4Х реализован далеко не во всех 
веб-броузерах, но он поддерживается реализацией ЛѵаВсгірі проекта Могіііа, на¬ 
чиная с версии 1.6 (в ГігеГох 1.5). В этом разделе мы рассмотрим только цикл Гог/ 
еасЬ и особенности его использования с обычными объектами, не имеющими от¬ 
ношения к ХМЬ. Остальные подробности о Е4Х приводятся в разделе 11.7. 

Цикл Гог еасЬ напоминает цикл Гог/іп. Однако вместо итераций по свойствам объ¬ 
екта он выполняет итерации по значениям свойств: 

ІеГ о = {опе: 1, Гѵю: 2, ГРгее: 3} 

Гог(1еГ р іп о) сопзоіе. 1од(р); // Гог/іп: выведет 'опе', 'іѵую', ’іМгее' 

Гог еасіі (ІеГ ѵ іп о) сопзоіе. 1од(ѵ); // Гог/еасР: выведет 1, 2, 3 

При использовании с массивами цикл Гог/еасМ выполняет итерации по элементам 
(а не по индексам) массива. Обычно он перечисляет их в порядке следования чи¬ 
словых индексов, но в действительности такой порядок не определяется стандар¬ 
том и не является обязательным: 

а = ['один', два'. три']; 

Гог(1е1: р іп а) сопзоіе. 1од(р); // Выведет индексы массива 0, 1, 2 

Гог еасй (Іеі ѵ іп а) сопзоіе.1од(ѵ); // Выведет элементы 'один', 'два', три' 
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Обратите внимание, что область применения цикла "Гог/еасМ не ограничивается 
элементами массива- он может перечислять значения перечислимых свойств 
объекта, включая перечислимые методы, унаследованные объектом. По этой при* 
чине обычно не рекомендуется использовать цикл "Гог/еасМ для работы с объекта¬ 
ми. Это особенно верно для программ, которые должны выполняться под управ¬ 
лением версий интерпретаторов ЛѵаЗсгірі до ЕСМАЗсгірі 5, в которых невоз¬ 
можно сделать пользовательские свойства и методы неперечислимыми. (Смотри¬ 
те аналогичное обсуждение цикла "Гог/іп в разделе 7.6.) 

11.4.2. Итераторы 

В версии ЛѵаЗсгірі 1.7 цикл "Гог/іп был дополнен более универсальными возмож¬ 
ностями. Цикл "Гог/іп в ЛѵаЗсгірі 1.7 стал больше похож на цикл "Гог/іп в языке 
РуіЬоп, он позволяет выполнять итерации по любым итерируемым объектам. 
Прежде чем обсуждать новые возможности, необходимо дать некоторые опреде¬ 
ления. 

Итератором называется объект, который позволяет выполнять итерации по не¬ 
которой коллекции значений и хранит информацию о текущей «позиции» в кол¬ 
лекции. Итератор должен иметь метод пех1:(). Каждый вызов метода пех1:() дол¬ 
жен возвращать следующее значение из коллекции. Например, функция соипі;ег( ), 
представленная ниже, возвращает итератор, который, в свою очередь, возвраща¬ 
ет последовательность увеличивающихся целых чисел при каждом вызове мето¬ 
да пех1:(). Обратите внимание, что здесь для хранения текущей информации ис¬ 
пользуется область видимости функции, образующая замыкание: 

// Функция, возвращающая итератор; 

^цпсНоп соцпіегСзІагі) { 

Іеі пехІѴаІііе = МаІН. гоііпсКзІагІ); // Частная переменная итератора 
геііігп { пехі: ^цпсІіоп() { геііігп пех1:Ѵа1ііе++; }}; // Вернуть итератор 

} 

Іеі зегіаІМіітЬегОепегаІіог = соііп1:ег(1000); 

Іеі зпі = зегіаІМцтЬегСепегаІог.пехіО; // 1000 

Іеі зп2 = зегіаІМілпЬегСепегаІог.пехІ(); // 1001 

При работе с конечными коллекциями метод пехЦ) итератора возбуждают ис¬ 
ключение ЗІорНега^іоп, когда в коллекции не остается значений для выполнения 
очередной итерации. ЗІорІІегаІіоп - это свойство глобального объекта в ^ѵа- 
Зсгірі 1.7. Его значением является обычный объект (без собственных свойств), за¬ 
резервированный специально для нужд завершения итераций. Обратите внима¬ 
ние, что ЗІорНегаІіоп не является функцией-конструктором, таким как ТуреЕггог() 
или ВапдеЕггог(). Ниже приводится пример метода гапдеИегО, возвращающего 
итератор, который выполняет итерации по целым числам в заданном диапазоне: 

// Функция, возвращающая итератор диапазона целых чисел 

^ііпсііоп гапдеІІегЦігзІ, Іазі) { 

Іеі пехІѴаІце = МаіН.сеіІЦігзІ); 
геіцгп { 

пехі: ^цпсііопО { 

іі" (пехІѴаІце > Іазі) ІЬгоѵ/ Зіорііегаііоп; 
геіцгп пех1:Ѵа1це++; 

} 
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}; 

} 

// Пример неудобной ре*ализации итераций с помощью итератора диапазона. 

Іеі г = гапдеИегО. 5); // Получить объект-итератор 

ѵЛііІе(ігие) { // Теперь использовать его в цикле 

ігу { 

сопзо1е.1од(г.пех1:()); // Вызвать метод пехІ() итератора 

} 

саГсіі(е) { 

ІГ (е == ЗГорІГегаііоп) Ьгеак; // Завершить цикл по ЗГорІГегаііоп 
еізе ГМгоѵ/ е; 

} 

} 


Обратите внимание, насколько неудобно использовать объект-итератор в цикле 
из-за необходимости явно обрабатывать исключение ЗТорІТегаТіоп. Из-за этого не¬ 
удобства итераторы редко используются на практике непосредственно. Чаще ис¬ 
пользуются итерируемые объекты. Итерируемый объект представляет коллек¬ 
цию значений, по которым можно выполнять итерации. Итерируемый объект 
должен определять метод с именем_ ііегаіог _() (с двумя символами подчерки¬ 

вания в начале и в конце), возвращающий объект-итератор для коллекции. 

В ЛѵаЗсгірі 1.7 в цикл Гог/іп была добавлена возможность работы с итерируемы¬ 
ми объектами. Если значение справа от ключевого слова іп является итерируе¬ 
мым объектом, то цикл Гог/іп автоматически вызовет его метод_ ііегаГог _(), 

чтобы получить объект-итератор. Затем он будет вызывать метод пехГ() итерато¬ 
ра, присваивать возвращаемое им значение переменной цикла и выполнять тело 
цикла. Цикл Гог/іп сам обрабатывает исключение ЗГорІГегаііоп, и оно никогда не 
передается программному коду, выполняемому в цикле. Пример ниже определя¬ 
ет функцию гапде(), возвращающую итерируемый объект (а не итератор), кото¬ 
рый представляет диапазон целых чисел. Обратите внимание, насколько проще 
выглядит цикл Гог/іп при использовании итерируемого объекта диапазона по 
сравнению с циклом мРіІе, в котором используется итератор диапазона. 


// Возвращает итерируемый объект, представляющий диапазон чисел 
Гипсііоп гапде(тіп, тах) { 
геііігп { 

деГ тіп() { геііігп тіп; }, 
деГ тах() { геііігп тах; }, 
іпсііісіез: Гііпсіііоп(х) { 


// Вернуть объект, представляющий диапазон. 
// Границы диапазона не изменяются 
// и хранятся в замыкании. 

// Диапазоны могут проверять вхождение. 


геііігп тіп <= х && х <= тах; 


}. 

ГоЗігіпд; ГцпсГіопО { // Диапазоны имеют строковое представление, 

геііігп "[" + тіп + + тах + ”]“; 

}, 

_ ііегаіог _: ГііпсііопО { // Возможно выполнять итерации по диапазону 

ІеГ ѵаі = МаГМ.сеіІ(тіп); // Сохранить текущ. позицию в замыкании. 

геііігп { // Вернуть объект-итератор. 

пехі: ГііпсііопО { // Вернуть следующее число в диапазоне. 

іГ (ѵаі > тах) // Если достигнут конец - прервать итерации 

ГЬгоѵ/ ЗГорІГегаГіоп; 

геііігп ѵа1++; // Иначе вернуть следующее число 

} // и увеличить позицию 
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}; 

} 

}; 

} 

// Далее демонстрируется, как можно выполнять итерации по диапазону: 

Тог(1еі і іп гапде(І.Ю)) сопзоіе. 1од(і); // Выведет числа от 1 до 10 

Обратите внимание, что, несмотря на необходимость писать метод _Нетало г_ () 

и возбуждать исключение Зіюріііегаіііоп для создания итерируемых объектов и их 

итераторов, вам не придется (в обычной ситуации) вызывать метод_ ііегаііог _() 

и/или обрабатывать исключение ВііорПіегаІііоп - все это сделает цикл Тог/іп. Если 
по каким-то причинам потребуется явно получить объект-итератор итерируемого 
объекта, можно воспользоваться функцией ІіегаІіогО. (ІіегаІогО - это глобальная 
функция, которая появилась в версии ЛѵаЗсгірі 1.7.) Если передать этой функции 

итерируемый объект, она просто вернет результат вызова метода_ іііегаііог _(), что 

придаст дополнительную ясность программному коду. (Если передать функции 
Ііега1іог( ) второй аргумент, она передаст его методу_ іііегаііог _().) 

Однако функция ІіегаІіогО имеет еще одно важное назначение. Если ей передать 

объект (или массив), не имеющий метода_ іііегаііог _(), она вернет собственную 

реализацию итерируемого итератора для объекта. Каждый вызов метода пехіО 
этого итератора будет возвращать массив с двумя значениями. В первом элементе 
массива будет возвращаться имя свойства объекта, а во втором - значение этого 
свойства. Поскольку этот объект является итерируемым итератором, его можно 
использовать в цикле "Гог/іп вместо прямого вызова метода пехіО, а это означает, 
что функцию ІІега1іог() можно использовать совместно с операцией присваива¬ 
ния с разложением при выполнении итераций по свойствам и значениям объекта 
или массива: 

Тог(1еі [к.ѵ] іп Ііегаіог({а:1,Ь:2})) // Итерации по ключам и значениям 

сопзоіе.1од( к + "=" + ѵ); // Выведет "а=1" и "Ь=2” 

Итератор, возвращаемый функцией ІіегаІіогО, имеет еще две важные особенно¬ 
сти. Во-первых, он игнорирует унаследованные свойства и выполняет итерации 
только по «собственным» свойствам, что чаще всего и требуется. Во-вторых, если 
передать функции ІіегаііогО значение ігце во втором аргументе, возвращаемый 
итератор будет выполнять итерации только по именам свойств, без их значений. 
Обе эти особенности демонстрируются в следующем примере: 

о={х:1,у:2} // Объект с двумя свойствами 

ОЬіесі.ргоіоіуре . г - 3: // Теперь все объекты унаследуют г 

1 : ог(р іп о) сопзоіе. 1од(р); // Выведет "х", "у” и "г 

І'огСр іп Ііега1:ог(о, ігііе)) сопзоіе. 1од(р); // Выведет только “х" и "у" 

11.4.3. Генераторы 

Генераторы - это особенность ЛѵаЗсгірі 1.7 (заимствованная из языка РуіЬоп), 
основанная на использовании нового ключевого слова уіеісі. Программный код, 
использующий данную особенность, должен явно указать номер версии 1.7, как 
описывалось в разделе 11.2. Ключевое слово уіеісі используется в функциях и дей¬ 
ствует аналогично инструкции геіигп, возвращая значение из функции. Разница 
между уіеісі и геіигп состоит в том, что функция, возвращающая значение с помо- 
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щью ключевого слова уіеісі, сохраняет информацию о своем состоянии, благода¬ 
ря чему ее выполнение может быть возобновлено. Такая способность к возобнов¬ 
лению выполнения делает уіеісі замечательным инструментом для создания ите¬ 
раторов. Генераторы - очень мощная особенность языка, но понять принцип их 
действия совсем не просто. Для начала познакомимся с некоторыми определе¬ 
ниями. 

Любая функция, использующая ключевое слово уіеісі (даже если инструкция 
уіеісі никогда не будет выполняться), является функцией-генератором . Функ¬ 
ции-генераторы возвращают значения с помощью уіеісі. Они могут использовать 
инструкцию геіигп без значения, чтобы завершиться до того, как будет достигнут 
конец тела функции, но они не могут использовать геііигп со значением. За исклю¬ 
чением использования ключевого слова уіеісі и ограничений на использование 
инструкции геііигп, функции-генераторы ничем не отличаются от обычных функ¬ 
ций: они объявляются с помощью ключевого слова Гипсііоп, оператор Ііуреоі 1 воз¬ 
вращает для них строку «Ліпсііоп* и как обычные функции они наследуют свой¬ 
ства и методы от Рипсііоп. ргоіоііуре. Однако поведение функции-генератора совер¬ 
шенно отличается от поведения обычной функции: при вызове, вместо того чтобы 
выполнить свое тело, функция-генератор возвращает объект генератора . 

Генератор - это объект, представляющий текущее состояние функции-генерато¬ 
ра. Он определяет метод пехіО, вызов которого возобновляет выполнение функ¬ 
ции-генератора и позволяет продолжить ее выполнение, пока не будет встречена 
следующая инструкция уіеісі. Когда это происходит, значение в инструкции уіеісі 
в функции-генераторе становится возвращаемым значением метода пехі( ) генера¬ 
тора. Если функция-генератор завершает свою работу вызовом инструкции геііигп 
или в результате достижения конца своего тела, метод пехі() генератора возбуж¬ 
дает исключение Зіюріііегаіііоп. 

Тот факт, что генераторы имеют метод пехіО, который может возбуждать исклю¬ 
чение Зііоріііегаіііоп, явственно говорит о том, что они являются итераторами. 1 
В действительности они являются итерируемыми итераторами, т. е. они могут ис¬ 
пользоваться в циклах 1ч)г/іп. Следующий пример демонстрирует, насколько про¬ 
сто создавать функции-генераторы и выполнять итерации по значениям, которые 
они возвращают с помощью инструкции уіеісі: 

// Определение функции-генератора для выполнения итераций 
// по целым числам в определенном диапазоне 
іііпсііоп гапде(тіп, тах) { 

іог(1еі і = МаіЬ.сеіІ(тіп); і <= тах; і++) уіеісі і; 

} 

// Вызвать функцию-генератор, чтобы получить генератор, и выполнить итерации по нему. 
^ог(1еі п іп гапде(3,8)) сопзоіе.Іод(п); // Выведет числа от 3 до 8. 


1 Генераторы иногда называют «итераторами-генераторами*, чтобы отличить их от соз¬ 
дающих их функций-генераторов. В этой главе вместо термина «итераторы-генераторы* 
мы будем использовать термин «генераторы*. В других источниках вы можете встре¬ 
тить термин «генератор*, обозначающий одновременно и функции-генераторы, и итера¬ 
торы-генераторы. 
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Функции-генераторы могут никогда не завершаться. Каноническим примером 
использования генераторов является воспроизведение последовательности чисел 
Фибоначчи: 

// Функция-генератор, которая воспроизводит последовательность чисел Фибоначчи 
Гііпсііоп ГіЬопассіО { 

Іеі х = 0, у = 1; 
ѵЛііІе(Ігце) { 
уіеісі у; 

[х.у] = [у.х+у]; 

} 

} 

// Вызвать функцию-генератор, чтобы получить генератор. 

Г = ^іЬопассі (); 

// Использовать генератор как итератор, вывести первые 10 чисел Фибоначчи. 

Гог(1еІ і = 0; і < 10; і++) сопзоіе.1од(Г.пехІ()); 

Обратите внимание, что функция-генератор ГіЬопассіО никогда не завершится. 
По этой причине создаваемый ею генератор никогда не возбудит исключение 
ЗГорИегаГіоп. Поэтому, вместо того чтобы использовать его как итерируемый объ¬ 
ект в цикле "Гог/іп и попасть в бесконечный цикл, мы используем его как итератор 
и явно вызываем его метод пехГ( ) десять раз. После того как фрагмент выше будет 
выполнен, генератор Г по-прежнему будет хранить информацию о состоянии 
функции-генератора. Если в программе не требуется далее хранить эту информа¬ 
цию, ее можно освободить вызовом метода с1озе() объекта Г: 

Г. с1озе( ); 

При вызове метода с1озе() генератора производится завершение связанной с ним 
функции-генератора, как если бы она выполнила инструкцию геГигп в той точке, 
где ее выполнение было приостановлено. Если это произошло в блоке Гг у, автома¬ 
тически будет выполнен блок Гіпаііу перед тем, как с1озе() вернет управление. 
Метод с1озе() никогда не возвращает значение, но если блок Гіпаііу возбудит ис¬ 
ключение, оно продолжит свое распространение из вызова с1озе( ). 

Генераторы часто бывает удобно использовать для последовательной обработки 
данных - элементов списка, строк текста, лексем в лексическом анализаторе 
и т.д. Генераторы можно объединять в цепочки, подобно конвейеру команд 
в ІІпіх. Самое интересное в этом подходе заключается в том, что он следует прин¬ 
ципу отложенных вычислений : значения «извлекаются» из генератора (или из 
конвейера генераторов) по мере необходимости, а не все сразу. Эту особенность 
демонстрирует пример 11.1. 

Пример 11.1. Конвейер генераторов 

// Генератор, возвращающий строки текста по одной. 

// Обратите внимание, что здесь не используется метод з.зрПГО. потому что 
// он обрабатывает текст целиком, создает массив, тогда как нам необходимо 
// реализовать отложенную обработку. 

ГііпсГіоп еасПІіпе(з) { 

ІеГ р; 

ѵЛіі1е((р = з. іпсІехОГ( \п')) != - 1 ) { 
уіеісі з. 5ііЬзГгіпд(0, р); 
з = з. зиЬзІ: гіпд( р+1); 
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} 

іГ (з.ІепдІР > 0) уіеісі з; 

} 

// Функция-генератор, возвращающая Г(х) для каждого элемента х итерируемого объекта і 
ГипсТіоп шар(і. Г) { 

Гог(Іеі х іп і) уіеісі Г(х); 

} 

// Функция-генератор, возвращающая элементы і, для которых Г(х) возвращает Ігііе 
Гипс! іог» зеіесі:(і, О { 

Гог(ІеГ х іп і) { 

ІГ (Г(х)) уіеісі х; 

} 

} 

// Обрабатываемый текст 

Іеі Іехі = " йсоттепі: \п \п РеПо \пѵу/ог1с!\п циіі: \п цпгеасРес! \п"; 

// Сконструировать конвейер генераторов для обработки текста. 

// Сначала разбить текст на строки 
ІеГ Ппез = еасйііпе(іехі); 

// Затем удалить начальные и конечные пробелы в каждой строке 
Іеі Тгіттесі = тар(1іпез, Гцпс1:іоп(1іпе) { геіцгп Ііпе.Ігіт(); }); 

// Наконец, игнорировать пустые строки и комментарии 
ІеТ попЫапк = зеіесі(Тгіттесі, Гцпсііоп(ііпе) { 
геііігп Ііпе.ІепдІР > 0 && 1іпе[0] != 

}); 

// Теперь извлечь отфильтрованные строки из конвейера и обработать их, 

// остановиться, если встретится строка "дціі:". 

Іог (ІеГ Ііпе іп попЫапк) { 
іі (Ііпе === "циі!;") Ьгеак; 
сопзоіе.Іод(ііпе); 

} 

Обычно инициализация генераторов выполняется при их создании: аргументы, 
передаваемые функции-генератору, являются единственными значениями, кото¬ 
рые принимают генераторы. Однако имеется возможность передать дополнитель¬ 
ные данные уже работающему генератору. Каждый генератор имеет метод зепсі(), 
который перезапускает генератор подобно методу пех1( ). Разница лишь в том, что 
методу зепс1() можно передать значение, которое станет значением, возвращае¬ 
мым выражением уіеісі в функции-генераторе. (В большинстве генераторов, кото¬ 
рые не принимают дополнительных входных данных, ключевое слово уіеісі вы¬ 
глядит как инструкция. Однако в действительности уіеісі - это выражение, воз¬ 
вращающее значение.) Кроме методов пехіО и $епс!() существует еще один способ 
перезапустить генератор - метод 1Игсм(). Если вызвать этот метод, выражение 
уіеісі возбудит аргумент метода 1Игсм() как исключение, как показано в следую¬ 
щем примере: 

// Функция-генератор, ведущая счет от заданного начального значения. 

// Метод зепс1() позволяет увеличить счетчик на определенное значение. 

// Вызов ГИ го\ѵ( ”гезеГ") сбрасывает счетчик в начальное значение. 

// Это всего лишь пример - здесь метод ІЬгоѵ/() используется не самым лучшим образом. 
Іііпсііоп соипі:ег(іпігіаі) { 
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} 


ІеГ пехІѴаІііе = іпігіаі; 
ѵМ1е(1:гие) { 

Ігу { 

ІеГ іпсгетепі: = уіеісі пехГѴаІие; 
ІГ (іпсгетепі:) 

пехГѴаІие += іпсгетепі:: 
еізе пехГѴа1ие++; 


саісЬ (е) { 

ІГ (е==="гезе1:") 

пехГѴаІие = ІпШаІ; 
еізе іМгоѵу/ е: 


} 


} 


// Сохранить начальное значение 

4 

// Вернуть значение и получить приращение 
// Если передано приращение. .. 

// ...использовать его. 

// Иначе увеличить на 1 

// Если был вызван метод 
// іМгоѵ/О генератора 


ІеГ с = соип1:ег(10); 
сопзоіе.1од(с.пехГ()); 
сопзоіе. 1од(с. зепс!( 2)); 
сопзоіе. 1од(с. ІЬгоѵ/С'гезеІ:")); 


// Создать 
// Выведет 
// Выведет 
// Выведет 


генератор с начальным значением 10 
10 
12 
10 


11.4.4. Генераторы массивов 

Еще одна особенность, заимствованная в ЛѵаЗсгірі 1.7 из языка РуіЬоп, - генера¬ 
торы массивов . Это механизм инициализации элементов массива на основе эле¬ 
ментов другого массива или итерируемого объекта. Синтаксис генераторов масси¬ 
вов основан на математической форме записи элементов множества, т. е. выраже¬ 
ния и инструкции находятся совсем не там, где привыкли их видеть программи¬ 
сты на языке ЛѵаЗсгірі. Тем не менее привыкание к необычному синтаксису 
происходит достаточно быстро, а мощь генераторов массивов просто неоценима. 

Ниже приводится пример генератора массивов, использующего созданную выше 
функцию гапде() для инициализации массива, содержащего квадраты четных 
чисел, меньшие 100: 

Іеі еѵепздьагез = [х*х Гог (х іп гапде(О.Ю)) ІГ (х % 2 === 0)] 

Эта строка примерно эквивалентна следующим пяти строкам: 

ІеГ еѵепздиагез = []; 

Гог(х іп гапде(0, 10)) { 

ІГ (х % 2 === 0) 

еѵепздиагез. ризЬ(х*х); 

} 

В общем случае синтаксис генераторов массивов имеет следующий вид: 

[ выражение Гог ( переменная іп объект ) ІГ ( условное выражение ) ] 

Обратите внимание на три основные части в квадратных скобках: 

• Цикл Гог/іп или ^ог/еасИ без тела. Эта часть генератора массивов включает пе¬ 
ременную (или несколько переменных при использовании присваивания с раз¬ 
ложением) слева от ключевого слова іп и объект (который может быть генера¬ 
тором, итерируемым объектом или массивом) справа от ключевого слова іп. 
Несмотря на отсутствие тела цикла, эта часть генератора массивов выполняет 
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итерации и присваивает последовательные значения, определяемые перемен¬ 
ной. Обратите внимание, что перед именем переменной не допускается указы¬ 
вать ключевое слово ѵаг или Іеі: - генераторы массивов неявно используют 
ключевое слово Іеі:, а используемая переменная недоступна за пределами квад¬ 
ратных скобок и не затирает существующую переменную с тем же именем. 

• После итерируемого объекта может присутствовать ключевое слово іГ и услов¬ 
ное выражение . Если оно присутствует, условное выражение используется для 
фильтрации значений, по которым выполняются итерации. Условное выраже¬ 
ние вычисляется после получения каждого значения, воспроизводимого цик¬ 
лом Гог. Если результатом выражения является Гаізе, это значение пропуска¬ 
ется и в массив ничего не добавляется. Ключевое слово ІГ можно не указы¬ 
вать - если оно отсутствует, генератор массива действует так, как если бы 
в нем присутствовала конструкция ІГ (Гте). 

• Выражение 9 стоящее перед ключевым словом Гог, представляет собой эквивалент 
тела цикла. После того как значение, возвращаемое итератором, будет при¬ 
своено переменной и пройдет проверку условным выражением , будет вычислено зна¬ 
чение этого выражения, и полученный результат будет добавлен в создавае¬ 
мый массив. 

Ниже приводятся несколько более конкретных примеров, которые помогут луч¬ 
ше понять синтаксис: 

(ІаГа = [2,3,4, -5]; // Массив чисел 

зцііагез = [х*х Го г еасб (х іп сІаГа)]: // Квадраты всех чисел: [4,9,16.25] 

// Извлечь квадратные корни из всех неотрицательных элементов 
гооГз = [МаГР.зцгКх) Гог еасб (х іп РаГа) іГ (х >= 0)] 

// Создать массив с именами свойств объекта 
о = {а:1, Ь:2, Г: ГцпсГіоп(){}} 

ІеГ аіікеуз = [р Гог (р іп о)] 

ІеГ омпкеуз = [р Гог (р іп о) іГ (о. РазОѵу/пРгорегГуСр))] 

ІеГ поГ^цпсз = [к Гог ([к,ѵ] іп ІГегаГог(о) ) іГ (ГуреоГ ѵ !== ГипсГіоп")] 

11.4.5. Выражения-генераторы 

В ЛѵаЗсгірі 1.8 1 можно заменить квадратные скобки в генераторах массивов 
круглыми скобками и получить выражения-генераторы. Выражение-генератор 
похоже на генератор массивов (синтаксис в круглых скобках в точности соответ¬ 
ствует синтаксису в квадратных скобках), но его значением является объект ге¬ 
нератора, а не массив. Преимущество выражений-генераторов перед генератора¬ 
ми массивов в том, что они используют прием отложенных вычислений - вычис¬ 
ления выполняются по мере необходимости, а не все сразу - и позволяют обраба¬ 
тывать даже бесконечные последовательности. Недостаток генераторов состоит 
в том, что они обеспечивают только последовательный доступ к своим элементам. 
То есть, в отличие от массивов, генераторы не позволяют обращаться к элементам 
по индексам: чтобы получить п-е значение, придется выполнить п-1 итераций. 

Ранее в этой главе мы реализовали функцию тар( ): 

// Функция-генератор, возвращающая Г(х) для каждого элемента х итерируемого объекта і 


і 


На момент написания этих строк выражения-генераторы не поддерживались в КЬіпо. 
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^ипсііоп тар(і. О { 

г(ІеТ: х іп і) уіеіеі І'(х); 

} 

Выражения-генераторы позволяют избежать необходимости создавать или ис¬ 
пользовать такую функцию тар(). Чтобы получить новый генератор Іп, возвра¬ 
щающий ’Г(х) для каждого значения х, возвращаемого генератором д, достаточно 
использовать такой программный код: 

Іеі Р = ('Г(х) г (х іп д)); 

Используя генератор еас!і1іпе() из примера 11.1, можно реализовать отсечение 
пробельных символов, а также фильтрацию комментариев и пустых строк, как 
показано ниже: 

Іеі Ііпез = еасМ1іпе(1:ех1:); 

Іеі Ігіттес] = (І.ігітО 1=ог (1 іп Ііпез)); 

Іеі попЫапк = (1 ^ог (1 іп ігіттесі) і? (1.ІепдТЬ > 0 && 1[0]! = '#')); 

11.5. Краткая форма записи функций 

В ЛѵаЗсгірі 1.8 1 появилась возможность краткой записи простых функций (на¬ 
зывается «лексическим замыканием»). Если функция вычисляет единственное 
выражение и возвращает его значение, ключевое слово геіигп и фигурные скобки, 
окружающие тело функции, можно опустить и просто поместить выражение сра¬ 
зу после списка аргументов. Например: 

Іеі зіісс = ^ііпсііоп(х) х+1, уез = ^ііпсІіоп() ігие, по = ^ипсІіопО Шзе; 

Это просто и удобно: функции, определяемые таким способом, ведут себя как 
обычные функции, в определении которых присутствуют фигурные скобки 
и ключевое слово геііигп. Этот сокращенный синтаксис удобно использовать, в ча¬ 
стности, при передаче функций другим функциям. Например: 

// Отсортировать массив в обратном порядке 
Раіа.зогК^ііпсІіопСа, Ь) Ь-а); 

// Определение функции, которая возвращает сумму квадратов элементов массива 
Іеі зцтО^Здцагез = ^цпс*іоп((1а*а) 

Аггау. гес!исе(Аггау.тар(с1а1:а, ^цпс1:іоп(х) х*х), ^ііпсІ:іоп(х,у) х+у); 

11.6. Множественные блоки саісіі 

В ЛѵаЗсгірі 1.5 инструкция ігу/саІсИ была добавлена возможность использовать 
несколько блоков саісіі. Чтобы использовать эту возможность, необходимо, что¬ 
бы за именем параметра блока саіісіп следовало ключевое слово іТ и условное вы¬ 
ражение: 

*гу { 

// здесь могут возбуждаться исключения нескольких типов 
ІЬгоѵі 1; 


і 


На момент написания этих строк данная особенность не поддерживалась в Шйпо. 
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} 

са1:сЬ(е іГ е іпзіапсеоі 1 ВеІ'егепсеЕггог) { 

// Здесь обрабатывается исключение обращения к неопределенному имени , 

} 

саІсЬ(е іГ е === "диі^” ) { 

// Обработка исключения, получаемое в результате возбуждения сроки "ріпі" 

} 

саіс1і(е іГ ТуреоГ е === "зігіпд") { 

// Здесь обрабатываются все остальные строковые исключения 

} 

саісіі(е) { 

// Здесь обрабатываются любые другие исключения 

} 

Гіпаііу { 

// Блок Гіпаііу действует как обычно 

} 

Когда возникает какое-либо исключение, по очереди проверяются все блоки 
саісО. Исключение присваивается именованному параметру блока саісО и вычис¬ 
ляется условное выражение. Если оно возвращает Ггие, выполняется тело этого 
блока саГсГ», а все остальные блоки саісМ пропускаются. Если блок саісіі не имеет 
условного выражения, он ведет себя как блок с условным выражением іГ г те 
и выполняется всегда, если перед ним не был встречен блок саісіі, удовлетворяю¬ 
щий условию. Если условное выражение присутствует во всех блоках саісМ и ни 
в одном из них условное выражение не вернуло ігие, исключение продолжит рас¬ 
пространение как необработанное. Обратите внимание, что, поскольку условное 
выражение уже находится в круглых скобках блока саісМ, его не требуется еще 
раз заключать в скобки, как в обычных инструкциях іГ. 

11.7. Е4Х: ЕСМА$сгір1 Гог ХМІ. 

Расширение ЕСМАЗсгірі іот ХМЬ, более известное как Е4Х, - это стандартное 
расширение 1 ^ѵаЗсгірі, определяющее ряд мощных особенностей для обработки 
ХМЬ-документов. Расширение Е4Х поддерживается интерпретаторами Зрісіег- 
топкеу 1.5 и КЬіпо 1.6. Из-за того что оно не получило широкой поддержки у про¬ 
изводителей броузеров, расширение Е4Х, вероятно, лучше относить к серверным 
технологиям, основанным на интерпретаторах ЗрШегтопкеу или КЬіпо. 

Расширение Е4Х представляет ХМЬ-документ (или элементы и атрибуты ХМЬ- 
доку мента) как объект ХМ Б, и представляет фрагменты ХМЬ (несколько элементов 
ХМЬ, не имеющих общего родителя) в виде родственного объекта ХМІ_І_ізГ. В этом 
разделе мы познакомимся с несколькими способами создания и обработки объек¬ 
тов ХМ Б. Объекты ХМ Б - это совершенно новый тип объектов, для работы с которы¬ 
ми в Е4Х предусмотрен (как мы увидим) специальный синтаксис. Как известно, 
для всех стандартных объектов ЛѵаЗсгірі, не являющихся функциями, оператор 
ГуреоГ возвращает строку «оЪіесі». Объекты ХМЬ, подобно функциям, отличаются 
от обычных объектов ЛѵаЗсгірі, и для них оператор іуреоГ возвращает строку 


і 


Расширение Е4Х определяется стандартом ЕСМА-357. Официальную спецификацию 
можно найти по адресу кіір://іѵіѵіѵ.еста -іпіегпаііопаІ.огё/риЫісаиопз/зіаткіагйз/Еста- 
357. Мт. 
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«хтЬ. Важно понимать, что объекты ХМІ_ никак не связаны с объектами БОМ (Бо- 
ситепі ОЪіесі Мосіеі - объектная модель документа), которые используются в кли¬ 
ентском ЛѵаВсгірі (глава 15). Стандарт Е4Х определяет дополнительные средства 
для преобразования ХМЬ-документов и элементов между представлениями Е4Х 
и БОМ, но броузер Гігеіох не реализует их. Это еще одна причина, почему расши¬ 
рение Е4Х лучше относить к серверным технологиям. 

Этот раздел представляет собой краткое учебное руководство по расширению 
Е4Х и не должен рассматриваться как полноценное его описание. В частности, 
объекты ХМІ_ и ХМНізІ: имеют множество методов, которые вообще не будут упоми¬ 
наться здесь. Их описание также отсутствует в справочном разделе. Тем из вас, 
у кого появится желание использовать расширение Е4Х, за более полной инфор¬ 
мацией необходимо обращаться к официальной спецификации. 

Расширение Е4Х определяет совсем немного новых синтаксических конструкций. 
Самая заметная часть нового синтаксиса заключается в возможности использова¬ 
ния разметки ХМЬ непосредственно в программном коде ^ѵа8сгірі и включения 
в него литералов ХМІ_, как показано ниже: 

// Создать объект ХМІ_ 
ѵаг рі: = 

<регіос!іс1:аЫе> 

<е1етеп1: іР="1"><пате>Водород</пате></е1етеп1:> 

<е1етеп1: іР="2"><пате>Гелий</пате></е1етеп1:> 

<е1етепі: іс!="3"><пате>Литий</пате></е1етепі:> 

</регіос!іс1:аЫе>; 

// Добавить новый элемент в таблицу 

рі.еіетепі: += <е1етеп1 іс!="4"><пате>Бериллий</пате></е1етеп1:>; 

Синтаксис литералов ХМ 1_ в расширении Е4Х в качестве экранирующих символов 
использует угловые скобки, что позволяет помещать в разметку ХМЬ произволь¬ 
ные выражения на языке Лѵа8сгірі. Ниже демонстрируется еще один способ соз¬ 
дания точно такого же элемента ХМЬ, как в примере выше: 

рі: = <регіос1іс1аЫе></регіос1іс1аЫе>; // Создать пустую таблицу 

ѵаг еіетепіз = ["Водород", "Гелий", "Литий"]; // Добавить элементы 
// Создать теги ХМІ_, используя содержимое массива 
Гог(ѵаг п = 0; п < еіетепіз.ІепдІП; п++) { 

рі.еіетепі: += <е1етеп1: Іс1={п+1}><пате>{е1етепі5[п]}</пате></е1етеп1:>; 

} 

В дополнение к синтаксису литералов можно также извлекать данные из строк 
с разметкой ХМЬ. Следующий пример добавляет в периодическую таблицу еще 
один элемент: 

рі.еіетепі: += пем ХМІ_( ’<е1етеп1: іР="5"><пате>Бор</пате></е1етеп1:>' ); 

При работе с фрагментами ХМЬ вместо конструктора ХМЦ) используется конст¬ 
руктор ХМІ_І_із1(): 

рі.еіетепі; += пей ХМІ_І_із1( '<е1етеп1 іР="6"><пате>Углерод</пате></е1етеп1:>' + 

' <е1етепі: іс!="7"><пате>Азот</пате></е1етеп1:>'); 

После создания ХМЬ-документа для доступа к его содержимому можно использо¬ 
вать интуитивно понятный синтаксис Е4Х: 
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ѵаг еіетепіз = рТ.еІетепТ; // Вернет список всех тегов <е1етеп1:> 
ѵаг патез = рТ.еІетепТ. пате; // Список всех тегов <пате> 

ѵаг п = патез[0]; // "Водород": содержимое тега <пате> с номером 0. 

Кроме того, расширение Б4Х добавляет новый синтаксис для работы с объектами 
ХМІ_. Оператор .. - это оператор доступа к вложенным элементам. Его можно ис¬ 
пользовать вместо привычного оператора . доступа к членам: 

// Другой способ получить список всех тегов <пате> 
ѵаг патез2 = рТ..пате; 

Расширение Б4Х позволяет использовать даже оператор шаблона: 

// Получить все вложенные теги <е1етеп1:>. 

// Это еще один способ получить список всех тегов <пате>. 
ѵаг патезЗ = р{. еіетеп*. *: 

Расширение Е4Х отличает имена атрибутов от имен тегов с помощью символа @ 
(этот синтаксис заимствован из языка ХРаіЬ). Например, значение атрибута 
можно запросить, как показано ниже: 

// Получить атомное число гелия 
ѵаг аіотісМцтЬег = р*.е1етеп*[1].@ісІ; 

Оператор шаблона для имен атрибутов имеет вид 

// Список свех атрибутов всех тегов <е1етеп*> 
ѵаг аІотісМьтз = рі.еіетеп*.®*; 

Расширение Е4Х включает даже мощные и удивительно выразительные синтак¬ 
сические конструкции для фильтрации списков с помощью произвольных выра¬ 
жений-предикатов: 

// Отфильтровать список всех элементов так, чтобы 
// он включал только элементы с атрибутом ісі < 3 
ѵаг ІідІпЕІетепІз = рі. еіетеп*. (@іс! < 3); 

// Отфильтровать список всех тегов <е1етепі> так, чтобы он включал только те, 

// имена которых начинаются с символа "Б". Затем создать список тегов <пате> 

// из оставшихся тегов <е1етепі>. 

ѵаг ЬЕІетепІМатез = р{. еіетеп*. (пате.сИагАКО) == 'Б'), пате: 

Цикл Гог/еасО, с которым мы познакомились выше в этой главе (раздел 11.4.1), 
в расширении Е4Х дополнен возможностью итераций по спискам тегов и атрибу¬ 
тов ХМЬ. Напомню, что цикл Гог/еасП похож на цикл Гог/іп, за исключением того, 
что вместо итераций по свойствам объекта он выполняет итерации по значениям 
свойств: 

// Вывести названия всех элементов периодической таблицы 
^ог еасП (ѵаг е іп р{. еіетепі:) { 
сопзоіе. 1од(е.пате): 

> 

// Вывести атомные числа элементов 

^ог еасН (ѵаг п іп рі.еіетеп*.®*) сопзоіе.1од(п); 

В расширении Е4Х выражения могут присутствовать слева от оператора при¬ 
сваивания. Это позволяет изменять существующие и добавлять новые теги и ат¬ 
рибуты: 



11.7. Е4Х: ЕСМАБсгірІ Іог ХМІ. 


313 


// Изменить тег <е1етепб> для Водорода - добавить в него новый атрибут 
// и новый дочерний элемент, чтобы он выглядел так: 

// 

// <е1етепІ іс!="1" зутЬо1="В"> 

// <пате>Водород</пате> 

// <\л/еідМ;>1.00794</ѵу/еідИ1;> 

// </е1етепі> 

// 

рі.еіетепі[0].@зутЬо1 = "В"; 
рі:. еіетепі; [ 0]. ѵу/еідИІ; = 1.00794; 

Так же легко можно удалять теги и атрибуты, используя стандартный оператор 

сіеіеііе: 

сіеіеіе рі.еіетепі:[0].@зутЬо1; // удалить атрибут 
сіеіеіе рі..меідРі; // удалить все теги <\л/еідПІ> 

Расширение Е4Х реализовано так, что позволяет выполнять большинство типич¬ 
ных операций с документами ХМЬ с помощью привычного синтаксиса языка. 
В Е4Х также имеются методы, которые можно вызывать относительно объектов 
ХМЬ. Например, метод іпзегіСІііІсІВеІ'огеО: 

рі. іпзегіСПіІсіВеІогеСрІ. е1етепІ[ 1 ], 

<е1етепІ ір="1"><пате>Дейтерий</пате></е1етепІ>); 

Расширение Е4Х полностью поддерживает пространства имен, а также включает 
синтаксические конструкции и функции для работы с пространствами имен ХМЬ: 

// Объявить пространство имен по умолчанию с помощью инструкции 

// "деІацН хті патезрасе" зіаіетепі: 

сіеіаіііі хті патезрасе = "Ы1р://шм.\л/3. огд/1999/хРІтІ"; 

// Следующий документ хіііті содержит несколько тегов зѵд: 
сі = <П1т1> 

<Ьос1у> 

Маленький красный квадрат: 

<зѵд хт1пз="Ы1р://ш\л/.\л/3. огд/2000/зѵд" ѵшіІР="10" ПеідРІ="10"> 

<гесІ х="0" у="0" місіІР="10'' ІгеідІѵІ=" 10" Ш1="гес1' , /> 

</зѵд> 

</Ьос1у> 

</П1т1> 

// Элемент Роду с цгі его пространства имен и локальным именем 

ѵаг іадпате = 6. Ьосіу.пате(); 

ѵаг Ьосіупз = Іадпате.цгі; 

ѵаг Іосаіпате = Іадпате.ІосаІИате; 

// Выборка элементов <зѵд> выполняется сложнее, потому что они не принадлежат 

// пространству имен по умолчанию. Поэтому для выборки зѵд сначала нужно создать 

// объект Патезрасе и затем использовать его 

// оператор :: добавляет пространство имен в имя тега 

ѵаг зѵд = пем №тезрасе( , П11р://ш\л/.мЗ. огд/2000/зѵд' ); 

ѵаг соіог = 6. . зѵд: : гесІ.@ІШ // "гесГ 
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В предыдущих главах подробно рассматривался базовый язык ЛѵаВсгірі, и вско¬ 
ре мы перейдем ко второй части книги, в которой рассказывается о том, как Лѵа- 
Всгірі встраивается в веб-броузеры, и описывается обширнейший АРІ клиентско¬ 
го ЛѵаВсгірі. ЛѵаВсгірі - это язык программирования для Веб, и большая часть 
программного кода на языке ЛѵаВсгірі написана для выполнения в веб-броузе- 
рах. Однако ЛѵаВсгірі - это быстрый и универсальный язык с широкими возмож¬ 
ностями, и нет никаких причин, по которым ЛѵаВсгірі не мог бы использоваться 
для решения других задач программирования. Поэтому, прежде чем перейти 
к знакомству с клиентским ЛѵаВсгірі, мы коротко рассмотрим две другие реали¬ 
зации ^ѵаВсгірі. ЕЫпо - это интерпретатор ЛѵаВсгірі, написанный на языке 
Лѵа, что обеспечивает программам на языке ЛѵаВсгірі доступ ко всем библиоте¬ 
кам языка Лѵа. Интерпретатор Шііпо рассматривается в разделе 12.1. Ыойе - 
версия интерпретатора Ѵ8 ЛѵаВсгірі, созданного компанией Ооо^іе, включаю¬ 
щая низкоуровневые интерфейсные библиотеки доступа к РОВІХ (ІІпіх) АРІ - 
к файлам, процессам, потокам, сокетам и так далее - с особым упором на асин¬ 
хронные операции ввода/вывода, сетевые взаимодействия и работу с протоколом 
НТТР. Интерпретатор Косіе рассматривается в разделе 12.2. 

Название главы говорит, что она посвящена «серверному» ЛаѵаВсгірі, а обычно 
для создания серверов и для управления ими используются интерпретаторы №(1е 
и Шііпо. Но под словом «серверный» можно также понимать «все, что за предела¬ 
ми веб-броузера». Программы, выполняемые под управлением Шііпо, способны 
создавать графические интерфейсы пользователя, используя фреймворк 8\ѵіп& 
для языка Лѵа. А интерпретатор №(1е может выполнять программы на языке 
^ѵаВсгірі, способные манипулировать файлами подобно тому, как это делают 
сценарии командной оболочки. 

Цель этой короткой главы состоит в том, чтобы осветить некоторые направления 
за пределами веб-броузеров, где может использоваться язык ЛѵаВсгірі. Здесь не 
предпринимается попытка в полном объеме охватить интерпретатор Шііпо или 
№(1е, а обсуждаемые здесь прикладные интерфейсы не описываются в справоч¬ 
ном разделе. Очевидно, что в одной главе невозможно сколько-нибудь полно опи- 
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сать платформу Лѵа или Р08ІХ АРІ, поэтому раздел об интерпретаторе Шііпо 
предполагает, что читатели имеют некоторое знакомство с Лѵа, а раздел об ин¬ 
терпретаторе Косіе предполагает знакомство с низкоуровневыми прикладными 
интерфейсами ІІпіх. 


12.1. Управление .Іаѵа с помощью КЫпо 

Шііпо - это интерпретатор ЛѵаВсгірі, написанный на языке Лѵа, цель которо¬ 
го - упростить возможность создания программ на языке ЛѵаВсгірі, которые 
могли бы использовать мощь платформы Лѵа. Интерпретатор Шііпо автоматиче¬ 
ски выполняет преобразование простых типов ЛѵаЗсгірі в простые типы Звсѵа. 
и наоборот, благодаря чему сценарии на языке ЛѵаЗсгірі могут читать и изме¬ 
нять свойства и вызывать методы объектов на языке Лѵа. 

КЫпо определяет несколько важных глобальных функций, не являющихся ча¬ 
стью базового языка ЛѵаВсгірі: 


// Специфические 
// Введите ИеІрО 
р гіпі; (х); 
ѵегзіоп(170); 
ІоасКШепате. ... 

геасІРіІеСШе); 

геасШгІ(цгІ); 

зрампСО; 

гцпСоттапсКстсІ, 

[агдз. 

диі1:() 


глобальные функции, определяемые интерпретатором: 
в строке приглашения гПіпо, чтобы получить дополнительную информацию 
// Глобальная функция вывода в консоль 
// Требует от ВИіпо задействовать особенности версии 1.7 
); // Загружает и выполняет один или более файлов 

// с программами на языке ЗаѵаЗсгірі: 

// Читает текстовый файл и возвращает его содержимое в виде строки 
// Читает текстовое содержимое по адресу ЬІРІ и возвращает 
// в виде строки 

// Вызывает Т() или загружает и выполняет файл Т 
// в новом потоке выполнения 
// Запускает системную команду с нулем или более 
.// аргументов командной строки 
// Завершает работу ВИіпо 


Как получить КЫпо 

Интерпретатор КЫпо - свободное программное обеспечение, разработан¬ 
ное проектом Могіііа. Вы можете загрузить копию по адресу кіір://и>іѵіѵ. 
тогіИа.огё/гкіпо/. Версия КЫпо 1.7г2 реализует ЕСМА8сгірі 3 и ряд рас¬ 
ширений языка, описанных в главе 11. КЫпо - достаточно зрелый про¬ 
граммный продукт, и новые его версии появляются не так часто. На мо¬ 
мент написания этих строк в репозитории с исходными текстами была дос¬ 
тупна предварительная версия 1.7гЗ, включающая частичную реализацию 
стандарта ЕСМА8сгірі 5. 

КЫпо распространяется в виде ^К-архива. Запускается он командой, как 
показано ниже: 

]аѵа -^аг гПіпо1_7В2/]з. ^аг ргодгат.^з 

Если опустить параметр ргоёгат.із, интерпретатор КЫпо запустится в ин¬ 
терактивном режиме, который позволит вам опробовать простенькие про¬ 
граммы и однострочные примеры. 
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Обратите внимание на функцию ргіп1:( ): мы будем использовать ее в этом разделе 
вместо сопзо1е.1од(). Интерпретатор Юііпо представляет пакеты и классы Лаѵа 
как объекты ЛаѵаЗсгірі: 

// Глобальная переменная Раскадез определяет корень иерархии пакетов Эаѵа 
Раскадез. апу. раскаде. пате // Любой пакет из С1.АЗЗРАТН 

заѵа.іапд // Глобальная переменная ^аѵа - краткая ссылка на Раскадезоаѵа 

заѵах.зѵу/іпд // А заѵах - краткая ссылка на Раскадезоаѵах 

// Классы: доступны как свойства пакетов 
ѵаг 8узі:ет = іаѵа.Іапд.Зузіет; 
ѵаг ЭРгате = іаѵах. зѵу/іпд. ЭРгате; 

Поскольку пакеты и классы представлены как объекты ЛѵаВсгірі, их можно 
присваивать переменным, чтобы давать им более короткие имена. Но при жела¬ 
нии их можно импортировать более формальным способом: 

ѵаг Аггауілзі: = заѵа. ьШ. АггауПзІ: // Создать краткое имя для класса 
ітрогіСІаззОаѵа.цШ.НазИМар): //Аналог: ѵаг НазПМар^аѵа.цШ.НазПМар 

// Импорт пакета (отложенный) с помощью ітрогі:Раскаде(). 

// Не следует импортировать іаѵа.іапд: слишком много конфликтов имен 
// с глобальными переменными ЭаѵаЗсгірі. 
ітрогі: Раскаде Оаѵа. цШ); 
ітрогііРаскадеОаѵа. пеі); 

// Другой прием: передать произвольное количество классов и пакетов функции 
// ЭаѵаІтрог1:ег() и использовать возвращаемый объект с инструкцией ѵѵі1:Іі 
ѵаг дціркдз = Эаѵаітрогіег^аѵа.амі:, ^аѵа.амі.еѵепі, Раскадез.^аѵах.зміпд); 
мШі (дціркдз) { 

/* Здесь определены такие классы, как Роп*. Асііопілзіепег и ЭРгате */ 

} 

С помощью ключевого слова пем можно создавать экземпляры классов языка 
Лѵа, как если бы это были классы ЛѵаЗсгірі: 

// Объекты: создание из классов Эаѵа с помощью ключевого слова пей 
ѵаг Г = пей іаѵа. іо. РіІеС’ДтрДезі"); // Этот объект используется ниже 
ѵаг оці: = пем ^аѵа. іо. Рі1еѴ\/гіі:ег(Г); 

Интерпретатор КЫпо позволяет использовать ЛѵаВсгірі-оператор іпзІіапсеоГ для 
работы с объектами и классами на языке Захеи 

Г іпзіапсеоГ заѵа.іо.РіІе // => ігце 

оці іпзіапсеоГ ^аѵа. іо. РеаРег // => Раізе: объект Мгііег, а не РеаРег 

оці іпзіапсеоі 1 іаѵа. іо. СІозеаЫе // => ігце: Мгііег реализует СІозеаЫе 

Как видно выше в примерах создания объектов экземпляров, интерпретатор 
КЫпо позволяет передавать значения конструкторам Заѵа. и присваивать возвра¬ 
щаемые ими значения переменным Лѵа8сгірі. (Обратите внимание на неявное 
преобразование типов, выполняемое интерпретатором КЫпо в этом примере: За- 
ѵа8сгірі-строка */ітр/іеві* автоматически преобразуется в значение типа }аѵа. 
Іапё.Зігіпё.) Методы Лѵа очень похожи на конструкторы Лѵа, и КЫпо позволяет 
программам на языке ЛѵаВсгірі вызывать методы на языке Лѵа: 

// Статические методы на языке Эаѵа действуют подобно функциям ЭаѵаЗсгірІ: 

^аѵа. 1апд.Зузіет.де1:Ргорег1:у("]аѵа.ѵегзіоп") // Вернет версию Эаѵа 
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ѵаг ізЭідіІ: = заѵа.Іапд. СНагасРег. ізОідіР; // Присвоит статич. метод переменной 
ізОідіРС’Р") // => ргце: Арабская цифра 2 

// Вызвать методы экземпляра объектов Р и оцр на языке Эаѵа, созданных выше 

оцр.ѵ\/гіРе("Не11о МогІсДп"); 

оцр.с1озе(); 

ѵаг Іеп = Р.1епдРН(); 

Кроме того, КМпо позволяет получать и изменять значения статических полей 
Лѵа-классов и полей экземпляров ^ аѵа-объектов из программы на языке Лѵа- 
8сгірі. В классах на языке ^аѵа часто не определяют общедоступные поля, отда¬ 
вая предпочтение методам доступа. Если в Лѵа-классе определены методы досту¬ 
па, КМпо обеспечивает доступ к ним, как к свойствам объекта на языке Лѵа- 
8сгірі: 

// Прочитать значение статического поля Эаѵа-класса 
ѵаг зрсіоцр = заѵа. Іапд.ЗузРет.оиі:; 

// ПНіпо отображает методы доступа в отдельные свойства ЭаѵаЗсгірР 
Р.пате // => "/Ртр/Резр": вызовет Р.деРМатеО 

Р. сіігесРогу // => 1=а1зе: вызовет Р. ізОігесііогу() 

В языке Лѵа имеется возможность создавать перегруженные версии методов, 
имеющие одинаковые имена, но разные сигнатуры. Обычно интерпретатор КМпо 
способен определить, какую версию метода следует вызвать, опираясь на типы 
аргументов, которые передаются программой на языке ЛѵаЗсгірі. Однако ино¬ 
гда бывает необходимо явно идентифицировать метод по имени и сигнатуре: 

// Предположим, что Эаѵа-объект о имеет метод Р, который принимает целое 
// или вещественное число. В ЭаѵаЗсгірр необходимо будет явно указать сигнатуру: 
о[' Р(іпр)' ](3); // Вызвать метод, принимающий целое число 

о[' Р(РІоаР) ’ ](Ма1:1т. РІ); // Вызвать метод, принимающий вещественное число 

Для итераций по методам, полям и свойствам Лѵа-классов можно использовать 
цикл Рог/іп: 

ітрогРСІаззОаѵа. Іапд. ЗузРет); 

Рог(ѵаг т іп ЗузРет) ргіпр(т); // Выведет статические члены ]аѵа.Іапд.ЗузРет 
Рог(т іп О ргіпр(т); // Выведет члены экземпляра заѵа.іо.РіІе 

// Обратите внимание, что таким способом нельзя перечислить классы в пакете 
Рог (с іп заѵа.іапд) ргіпр(с); // Этот прием не сработает 

КМпо позволяет программам на языке ЛѵаВсгірі получать и изменять значения 
элементов ^ѵа-массивов, как если бы они были ^ѵа8сгірі-массивами. Конечно, 
^ѵа-массивы отличаются от ^ѵа8сгірі-массивов: они имеют фиксированную 
длину, их элементы имеют определенный тип, и они не имеют Лѵа8сгірі-мето- 
дов, таких как 5Іісе(). В ^ѵа8сгірі не существует синтаксических конструкций, 
которые могли бы использоваться интерпретатором КМпо для создания Лѵа-мас- 
сивов в программах на языке ЛѵаВсгірі, поэтому для этой цели необходимо ис¬ 
пользовать класс іаѵаЛап&геІІесіАггау : 

// Создать массив из 10 строк и массив из 128 байтов 

ѵаг ѵюгсіз = іаѵа. Іапд. геРІесР. Аггау. пеѵЛпзРапсеОаѵа. Іапд. ЗРгіпд, 10); 

ѵаг Ьурез = заѵа. Іапд. геРІесР. Аггау. пе\л/ІпзРапсе(]аѵа. Іапд. ВуРе. ТУРЕ, 128); 
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// После создания с массивами можно работать как с иаѵаЗсгірі-массивами: 

1"ог(ѵаг і = 0; і < Ьуіез.ІепдІР; і++) ЬуІез[і] = і; 

Программирование на языке Лѵа часто связано с реализацией интерфейсов. Ча* 
ще всего с этой необходимостью приходится сталкиваться при разработке графи¬ 
ческих интерфейсов, когда каждый обработчик события должен реализовать ин¬ 
терфейс приемника событий. Следующие примеры демонстрируют, как это сде¬ 
лать: 

// Интерфейсы: Реализация интерфейсов выглядит следующим образом: 
ѵаг Рапсііег = пе\л/ заѵа.аѵ^.еѵепі.ЕосцзІ_із1:епег({ 

Госцзбаіпесі: Гцпсііоп(е) { ргіп*("доІ Госцз"); }. 

^осц5І_оз*: І'ипсІіопСе) { ргіпІС'ІозІ: І'осиз"); } 

}); 

// Аналогично выполняется расширение абстрактных классов 
ѵаг Рапсііег = пе\л/ заѵа.а\л/і:.еѵеп1:.Міпс1о\л/Ас1ар1:ег({ 

ѵ\/іпс1о\л/С1о5іпд: ^цпсііоп(е) { ^аѵа.Іапд.Зузіет.ехіі:(0); } 

}): 

// Когда интерфейс определяет единственный метод, можно использовать простую функцию 
Ьи1:1:оп.ас!с1Асі:іопІіз1:епег(Гипс1:іоп(е) { ргіпІіС’ЬиПоп сІіскесГ); }); 

// Если все методы интерфейса или абстрактного класса имеют одну и ту же сигнатуру, 

// в качестве реализации можно использовать единственную функцию, 

// а НПіпо будет передавать ей имя метода в последнем аргументе 
Ггате. асісМпРоѵ\/Іі5{епег(Гипсііоп(е, пате) { 

ІГ (пате === "ѵапсІомСІозіпд'') ]аѵа. Іапд. Зузііет.ехі1:(0); 

}); 

// Если необходимо определить объект, реализующий несколько интерфейсов, 

// можно использовать класс ^ѵаАсіарІег : 

ѵаг о = пе\л/ ^ѵаАс!ар1:ег(заѵа.а\л/і:.еѵепі:.Асііопілзііепег, }аѵа .Іапд.ПьппаЫе, { 
гип: ^ьпсііопО {}, // Реализует интерфейс ПьппаЫе 

асІіопРегГогтесі: Гипс1:іоп(е) {} // Реализует интерфейс Асііопілзіепег 

>); 

Когда Лѵа-метод возбуждает исключение, интерпретатор Шііпо продолжает его 
распространение как ЛѵаВсгірі-исключения. Получить оригинальный Лѵа- 
объект ]аѵа.Іапё.Ехсерііоп можно через свойство ]аѵаЕхсер1:іоп Лѵа8сгірі-объек- 
та Еггог: 

ігу { 

Заѵа.Іапд.Зузіет.де1:Ргорег1:у(пиіі); // піЛІ - недопустимый аргумент 

> 

саІсР(е) { // е - иаѵаЗсгірі-исключение 

ргіпі:(е. заѵаЕхсерІіоп); // это обертка для ]аѵа. Іапд. МиПРоіпІегЕхсерІіоп 

> 

Здесь необходимо сделать последнее замечание по поводу преобразования типов 
в Шііпо. Интерпретатор Шііпо автоматически преобразует простые числа, логиче¬ 
ские значения и пиіі. Лѵа-тип сііаг интерпретируется в языке ЛѵаЗсгірі как чис¬ 
ло, так как в языке Лѵабсгірі отсутствует символьный тип. ^ѵа8сгірі-строки 
автоматически преобразуются в Лѵа-строки, но (и это может быть камнем пре¬ 
ткновения) Лѵа- строки остаются объектами іаѵаХапц.Вігіпц и не преобразуются 
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обратно в ^ѵа8сгірі-строки. Взгляните на следующую строку из примера, приво¬ 
дившегося ранее: 

ѵаг ѵегзіоп = заѵа.Іапд.Зузіет.деіРгорегіуС'заѵа.ѵегзіоп"); 

После выполнения этой инструкции переменная ѵегзіоп будет хранить объект 
Іаѵа.Іапё.Зігіпё. Он обычно ведет себя как ЛѵаЗсгірі-строка, но существуют важ¬ 
ные отличия. Во-первых, Лѵа-строка вместо свойства ІепдіО имеет метод 1епд1;И(). 
Во-вторых, оператор іуреоР возвращает тип «оЪ^есі» для Лѵа-строк. Лѵа- строку 
нельзя преобразовать в Лѵа8сгірі-строку вызовом метода іоЗігіпдО, потому что 
все Лѵа-объекты имеют собственные методы іоЗігіпдО, возвращающие экземп¬ 
ляры іаѵаЛапё.Зігітіё . Чтобы преобразовать Лѵа-значение в строку, его нужно 
передать ЛѵаЗсгірі-функции 5і:гіпд( ): 

ѵаг ѵегзіоп = ЗігіпдПаѵа.Іапд.Зузііет.деііРгорегііуСзаѵа.ѵегзіоп")); 

12.1.1. Пример использования КНіпо 

В примере 12.1 приводится простое приложение для интерпретатора Шііпо, демон¬ 
стрирующее большую часть возможностей и приемов, описанных выше. Пример 
использует пакет ]аѵах.8ъѵіпё со средствами построения графических интерфей¬ 
сов, пакет іаѵа.пеі с инструментами организации сетевых взаимодействий, пакет 
Іаѵа.іо потокового ввода/вывода и инструменты языка Лѵа многопоточного выпол¬ 
нения для реализации простого приложения менеджера загрузки, которое загру¬ 
жает файлы по адресам ІІНЬ и отображает ход выполнения загрузки. На рис. 12.1 
показано, как выглядит окно приложения в процессе загрузки двух файлов. 




п<ЛШГ ІЩРг И ■ НИ У ш ШЖг 

|Пр://йр то2і!іа.огд/риР/тогіІіа.сгддапііпоі.7Рч2.2ір 1 ЬоѵуцІоасІ 

I !.....1 

Іиір:/ /ѵѵт\лаѵа.пи/йоѵ*п!оай/ійк7/ Ьіпагіде/ійк 

Пр://Ир.то2іНа.огд;риЬ/тогіІІа.оід/1$/іЛіпо1_7і 

- 7-«а-Ьіп-Ь119-Іігшх-І586-21. поѵ.„2010,Ьіп: 

Щ ЩІ=р/ійк?~е&І»т 

.іѵлѵі-ІѵлѵЗѵ ... . 



Рис. 12.1. Графический интерфейс, созданный с помощью Шііпо 


Пример 12.1. Приложение менеджера загрузки для КНіпо 

Л 

* Приложение менеджера загрузки с простым графическим интерфейсом, 

* построенным средствами языка Оаѵа 
*/ 

// Импортировать графические компоненты из библиотеки Зиіпд 
// и несколько других классов 
ітрог1:Раскаде(]аѵах. зміпд); 
ітрогіСІаззОаѵах. з\л/іпд. ЬогРег. ЕтріуВогбег); 
ітрогі:С1аз5(]аѵа. а\л/1:. еѵепі. Асііопілзіепег); 
ітрогіСІаззОаѵа. пеі:. ІЖ); 
ітрогіСІаззОаѵа. іо. РПеОЩриШгеат); 
ітрогіСІаззОаѵа. Іапд.ТНгеаб); 


// Создать графические элементы управления 

ѵаг Ітате = пем ОРгате("ПНіпо УПІ_ РеісНег"); // Окно приложения 
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ѵаг игі^іеісі = пе\л/ ЛехРРіеІсІ(ЗО); 
ѵаг Ьи 1 ; 1 :оп = пем ЭВцрРоп("0оѵ\/п1оасГ); 
ѵаг РіІ-есНоозег = пе\л/ ЭРі1еСІюозег(); 
ѵаг го\а/ = Вох.сгеаРеНогігопРаІВохО; 
ѵаг соі = Вох.сгеаРеѴегРіса1Вох(); 

ѵаг расШпд = пем ЕтрІіуВогс!ег(3.3,3,3); 


// Поле ввода ІЖІ_ 

// Кнопка запуска загрузки 
// Диалог выбора файла 
// Контейнер для поля и кнопки 
// Для строки и индикатора хода 
// выполнения операции 
// Отступы для строк 


// Объединить все компоненты и отобразить 

гоѵ\/.ас1с1(цг1Ріе1с1); 

гоѵ\/.ас1с1(ЬиРРоп); 

соІ.асІсК гоѵО; 

Ггате. ас!сі(со1); 

го\л/. зеРВогРе г (расШпд); 

Ргате. раск(); 

Ргате. ѵізіЫе = 1: гие ; 


графический интерфейс 

// Поместить поле ввода в строку 
// Поместить кнопку в строку 
// Поместить строку в колонку 
// Поместить колонку во фрейм 
// Добавить отступы вокруг строки 
// Определить минимальный размер 
// Вывести окно 


// Эта функция вызывается, когда в окне что-то происходит. 

Ргате.аРРМіпРо\л/Ііз1:епег(1 : ипс1:іоп(е, пате) { 

// Если пользователь закрыл окно, завершить приложение. 

ІГ (пате === "ѵапсІоѵѵСІозіпд") // ВПіпо добавляет аргумент пате 

заѵа. 1апд.8уз1:ет.ехі1:(0); 

}); 


// Эта функция вызывается, когда пользователь щелкает на кнопке 
Ьциоп.аРРАс{іопІі5Іепег(Гцпс1:іоп() { 

Ігу { 

// Создать объект заѵа.пеІ.иРИ для представления ІІРІ источника. 

// (Автоматически будет проверена корректность ввода пользователя) 
ѵаг цгі = пем ипЦцгШеІсІ.ІехІ:); 

// Предложить пользователю выбрать файл для сохранения содержимого ІІРІ 
ѵаг гезропзе = ШесНоозег.зНо\л/$аѵеОіа1од(1тате); 

// Завершить, если пользователь щелкнул на кнопке Сапсеі 
іГ (гезропзе != ЭРіІеСІіоозег.АРРНОѴЕ.ОРТІОЮ геіцгп; 

// Иначе получить объект заѵа.іо.Рііе, представляющий файл назначения 
ѵаг Рііе = РіІесПоозег.деіЗе1есі:ес1Рі1е(); 

// Запустить новый поток выполнения для загрузки игі 

пе\л/ іаѵа. 1апд.ТПгеас1(Рипс1:іоп() { с!о\л/п1оас1(цгі,Рііе); }).зіагі(); 

} 

саРсН(е) { 

// Вывести диалог, если что-то пошло не так 

ЭОрііопРапе. зІіо\л/МеззадеОіа1од(Ргате, е.теззаде, "ЕхсерРіоп", 

ЭОрііопРапе.ЕРВ0Р.МЕ83А6Е); 


> 



// Использует заѵа.пеі.ІШІ_ и др. для загрузки содержимого ІІРЬ и использует ^аѵа.іо.РіІе 
// и др. для сохранения этого содержимого в файле. Отображает ход выполнения загрузки 
// в компоненте ЭРгодгеззВаг. Эта функция вызывается в новом потоке выполнения. 

РипсРіоп с!о\л/п1оас1(и гі , Рііе) { 

Рту { 

// Каждый раз, когда запускается загрузка очередного файла, 

// необходимо добавить в окно новую строку для отображения ІІРІ , 

// имени файла и индикатора хода выполнения операции 
ѵаг го\л/ = Вох.сгеаРеНогігопРаІВохО; // Создать строку 
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го и. зе1:Вогс)ег(рас)с)іпд); 

ѵаг ІаЬеІ = цгі. 1:оЗі:гіпд() + ": 

гои.ас)с1(пеи ЛаЬеІ(ІаЬеІ)); 

ѵаг Ьаг = пей ЗРгодгеззВаг(0, 100); 

Ьаг.зТгіпдРаіпііес) = Тгііе; 

Ьаг.зРгіпд = Рі1е.1о8Ргіпд(); 
гои. ас) с) (Ьаг); 
со1.ас)с)( гои); 

Ргате. раск(); 


// Добавить отступы 
// Отобразить ЬРЬ 
// в компоненте ЛаЬеІ 
// Создать полосу индикатора 
// Отобразить имя файла 
// в полосе индикатора 
// Добавить индикатор в строку 
// Добавить строку в колонку 
// Изменить размер окна 


// Здесь еще не известен размер загружаемого файла, поэтому изначально 
// индикатор просто воспроизводит анимационный эффект 
Ьаг. іпсІеТегтіпаТе = Тгііе; 


// Установить соединение с сервером и получить размер загружаемого 


// файла, если это возможно 
ѵаг сопп = цг1.орепСоппес1:іоп(); 

сопп.соппесШ; 

ѵаг Іеп = сопп.сопІепНепдІЬ; 
и (Іеп) { 

Ьаг.тахітшп = Іеп; 

Ьаг. іпсіеіегтіпаіе = Раізе; 

} 

// Получить потоки ввода и вывода 

ѵаг іпрці = сопп. іприІіЗі:геаш; 

ѵаг оиірііі: = пем Рі1е0іЦріЦ8ігеат(Рі1е) 


// Получить іаѵа. пеР. ЬПІ-СоппесІііоп 
// Подключиться и ждать заголовки 
// Проверить, получена ли длина файла 
// Если длина известна, тогда 
// настроить индикатор на вывод 
// процента выполнения задания 


// Прочитать байты с сервера 
; // Записать в файл 


// Создать входной буфер в виде массива размером 4 Кбайта 

ѵаг ЬцРРег = іаѵа. Іапд. геИесР. Аггау. пеиІпз1:апсе(іаѵа. Іапд. ВуРе.ТѴРЕ, 

4096); 

ѵаг пііт; 

иЬі1е((пііт=іпріі1:. геасКЬцРРег)) != -1) { // Читать до признака ЕОР 

оЛрЛ.игИеСЬиРРег, 0, пит); // Записать байты в файл 


Ьаг.ѵаіье += пцт; 

} 

оцІрцІ.сІозеО; 
іпрці.с1озе(); 

} 

саісЬ(е) { // Если что-то пошло не 
іР (Ьаг) { 

Ьаг. іпсІеРегті паре = Раізе; 
Ьаг.зРгіпд = е.РоЗРгіпд(); 

} 

} 

} 


// Обновить индикатор 
// Закрыть потоки по завершении 

так, вывести ошибку в индикаторе 

// Остановить анимацию 
// Заменить имя файла сообщением 


12.2. Асинхронный ввод/вывод 
в интерпретаторе ІЧосІе 

№к!е - это быстрый интерпретатор ^ѵаВсгірі, написанный на языке С++, вклю¬ 
чающий средства доступа к низкоуровневым интерфейсам ІІпіх для работы с про¬ 
цессами, файлами, сетевыми сокетами и так далее, а также к клиентским и сер¬ 
верным интерфейсам реализации протокола НТТР. За исключением нескольких 
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синхронных методов, имеющих специальные имена, все остальные инструменты 
интерпретатора Кобе доступа к интерфейсам ІІпіх являются асинхронными, и по 
умолчанию программы, выполняемые под управлением Кобе, никогда не блоки: 
руются, что обеспечивает им хорошую масштабируемость и позволяет эффектив¬ 
но справляться с высокой нагрузкой. Поскольку прикладные программные ин¬ 
терфейсы являются асинхронными, интерпретатор Кобе опирается на использо¬ 
вание обработчиков событий, которые часто реализуются с использованием вло¬ 
женных функций и замыканий. 1 

Этот раздел освещает некоторые наиболее важные инструменты и события, имею¬ 
щиеся в составе Кобе, но это описание ни в коем случае нельзя считать полным. 
Полное описание Кобе можно найти в электронной документации по адресу 
Ніір://по<ІеІ8.огё/арі/. 


Как получить ІЧосІе 

Кобе - это свободное программное обеспечение, которое можно загрузить 
по адресу Ы1р:Цпойе]в.огё . На момент написания этих строк интерпретатор 
все еще активно разрабатывался и скомпилированные дистрибутивы не 
были доступны, однако вы можете собрать собственную копию интерпре¬ 
татора из исходных текстов. Примеры в этом разделе опробовались под 
управлением версии Кобе 0.4. Прикладной интерфейс интерпретатора еще 
не зафиксирован, однако основные функции, демонстрируемые в этом раз¬ 
деле, едва ли сильно изменятся в будущем. 

Интерпретатор Кобе построен на основе механизма Ѵ8 баѵаВсгірі, разрабо¬ 
танного компанией Ооо^іе. Версия Кобе 0.4 использует версию Ѵ8 3.1, ко¬ 
торая реализует все особенности ЕСМАВсгірі 5, за исключением строгого 
режима. 

После загрузки, компиляции и установки Кобе вы сможете запускать про¬ 
граммы, написанные для этого интерпретатора, как показано ниже: 

посіе ргодгат.дз 


Знакомство с интерпретатором Шііпо мы начали с функций ргіпіО и 1оасІ(). Ин¬ 
терпретатор Кобе имеет похожие инструменты, но с другими именами: 

// Подобно броузерам, для вывода отладочной информации Иосіе определяет 
// функцию сопзоіе. 1од(). 

сопзоіе. 1од("Не11о Мойе"); // Выведет отладочную информацию в консоль 
// Вместо 1оасІ() в нем используется функция гециігеО. 

// Она загружает и выполняет (только один) указанный модуль и возвращает объект, 

// содержащий имена, экспортируемые модулем. 

ѵаг {"в = гедіЯгеС'^з"); // Загрузит модуль "'Рз" и вернет объект с его АРІ 


1 Клиентский баѵаЗсгірі также является асинхронным и опирается на использование 
событий, поэтому вам будет проще понять примеры, которые приводятся в этом разде¬ 
ле, после того как вы прочтете вторую часть книги и познакомитесь с особенностями 
создания клиентских программ на языке баѵаЗсгірі. 
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Интерпретатор Ыойе реализует в глобальном объекте все стандартные конструк¬ 
торы, свойства и функции, предусмотренные стандартом ЕСМАВсгірі 5. Однако 
в дополнение к этому он также поддерживает клиентские функции для работы 
с таймером: зеШтеоиТО, зеІІпТегѵаІО, сІеагТітеоиТО и сІеагІпІегѵаІО: 

// Вывести приветствие через одну секунду. 
зеіТітеоіЦ(?ипсІіоп() { сопзоіе. 1од( Привет, Мир!'"); }, 1000); 

Эти глобальные клиентские функции рассматриваются в разделе 14.1. Реализа¬ 
ция Кобе совместима с реализациями интерпретаторов в веб-броузерах. 

Интерпретатор Койе также определяет и другие глобальные компоненты в про¬ 
странстве имен ргосезз. Ниже перечислены некоторые из свойств этого объекта: 

ргосезз. ѵегзіоп // Строка с версией Ыосіе 

ргосезз. агдѵ // Аргументы командной строки в виде массива, агдѵ[0] = "поре"' 
ргосезз. епѵ // Переменные окружения в виде объекта. 

// например: ргосезз. епѵ. РАТН 
ргосезз. ріс) // Числовой идентификатор процесса 
ргосезз. деТиіс)( ) // Возвращает числовой идентификатор пользователя 
ргосезз.смс)() // Возвращает текущий рабочий каталог 

ргосезз. сПс)іг( ) // Выполняет переход в другой каталог 

ргосезз. ехП() // Завершает программу (после запуска всех обработчиков) 


Поскольку функции и методы, реализуемые интерпретатором Койе, являются 
асинхронными, они не блокируют выполнение программы в ожидании заверше¬ 
ния операций. Неблокирующий метод не может вернуть результат выполнения 
асинхронной операции. Если в программе потребуется получить результат или 
просто определить, когда завершится операция, необходимо определить функ¬ 
цию, которую интерпретатор Койе сможет вызвать, когда результат будет досту¬ 
пен или когда операция завершится (или возникнет ошибка). В некоторых случа¬ 
ях (например, в вызове зеІТітеоыШ выше) достаточно просто передать методу 
функцию в виде аргумента, и Койе вызовет ее в соответствующий момент време¬ 
ни. В других случаях можно воспользоваться инфраструктурой событий интер¬ 
претатора Койе. Объекты, реализованные в интерпретаторе №)йе, которые гене¬ 
рируют события (их часто называют источниками ( етШег ) событий), определя¬ 
ют метод оп() для регистрации обработчиков. Они принимают в первом аргу¬ 
менте тип события (строку) и функцию-обработчик во втором аргументе. Для 
различных типов событий функциям-обработчикам передаются различные ар¬ 
гументы, поэтому вам может потребоваться обратиться к документации по АРІ, 
чтобы точно узнать, как писать свои обработчики: 


етіПег. оп(пате, Т) 

етіПег.ас1с1І_і5І:епег(пате, О 
етіПег. опсе(пате, О 

етіПег. 1із1:епегз(пате) 
етіПег. гетоѵеІ_із1:епег(пате, О 
етіПег. гетоѵеА1Иіз1:епегз(пате) // Удаляет все обработчики события пате 


// Регистрирует Т для обработки события пате, 

// генерируемого объектом етіПег 

// То же самое: асІсНізІіепе г() - синоним для оп() 

// Для обработчиков однократного срабатывания, 

// затем Т автоматически удаляется 
// Возвращает массив функций-обработчиков 
// Удаляет обработчик Т 


Объект ргосезз, представленный выше, является источником событий. Ниже 
приводится пример обработчиков некоторых его событий: 
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// Событие "ехіі:" отправляется перед завершением работы N 00 ) 0 . 
ргосезз.опС'ехіі", Гипс1;іоп( ) { сопзоіе. ІодС'СоосІЬуе" ); }); 

// Необработанные исключения генерируют события, если имеется хотя бы один 
// зарегистрированный обработчик. В противном случае исключение 
// заставляет интерпретатор Иосіе вывести сообщение и завершить работу. 
ргосезз.опС’ипсаидМЕхсерИоп", Гііпсі:іоп(е) { сопзоіе. 1од(Ехсер1:іоп, е); }); 

// Сигналы Р08ІХ, такие как 8ІСІМТ, 8ІСНСІР и 8ІСТЕРМ, также генерируют события 
ргосезз.оп(*'8ІСІМТ", ^ііпсІіопО { сопзоіе.ІодС’ІдпогесІ Сігі-С"); }); 


Поскольку интерпретатор Кобе позволяет выполнять высокопроизводительные 
операции ввода/вывода, его прикладной интерфейс к потокам ввода/вывода яв¬ 
ляется одним из наиболее часто используемых в программах. Потоки, открытые 
для чтения, генерируют события, когда появляются данные, готовые для чтения. 
В следующем примере предполагается, что з - это поток, открытый для чтения, 
созданный где-то в другом месте программы. Ниже будет показано, как созда¬ 
вать объекты потоков для файлов и сетевых сокетов: 


// Входной поток з: 
з.опС'сІаіа", Г); 
5.оп("епсГ, Г); 

з.оп("еггог", О; 
з. геабаЫе 
з.рацзе(); 

з. гезшпе(); 


// При появлении данных передать их функции 14) в аргументе 
// событие "епсГ возникает по достижении конца файла, 

// когда данные больше не могут поступить 

// Если что-то не так, передаст исключение функции 14) 

// => Ігііе, если поток по-прежнему открыт для чтения 
// Приостановит отправку событий "сіаіа". 

// Например, чтобы уменьшить скорость выгрузки 
// Возобновит отправку событий "сіаіа’' 


// Определяет кодировку, если обработчику события "сіаіа" данные должны 
// передаваться в виде строк 

з. зеі: Епсосііпд (епс); // Как декодировать байты: "іі1:Г8”, "азсіі" или "Ьазе64” 


Потоки, открытые для записи, не так тесно связаны с событиями, как потоки, 
открытые для чтения. Метод игі1:е( ) таких потоков используется для отправки 
данных, а метод епсК ) - для закрытия потока, когда все данные будут записаны. 
Метод \л/гі1:е() никогда не блокируется. Если интерпретатор №к!е окажется не 
в состоянии записать данные немедленно и во внутреннем буфере потока не ока¬ 
жется сводного места, метод \л/гі1:е( ) вернет Гаізе. Чтобы узнать, когда интерпрета¬ 
тор вытолкнет буфер и данные фактически будут записаны, можно зарегистриро¬ 
вать обработчик события «сігаіп»: 


// Выходной поток з: 

з.\л/гіі:е(ЬиГГег); 

з. мгііеСзІгіпд, епсосііпд) 

з.епс)() 
з. епс)( ЬиІ'Ге г); 
з.епсКзІг, епсосііпд) 
з. мгііеаЫе; 
з.оп("сігаіп”, О 


// Запись двоичных данных 
// Запись строковых данных. 

// по умолчанию епсосііпд = 

// Закроет поток. 

// Запишет последнюю порцию данных и закроет поток. 

// Запишет последнюю строку и закроет поток 
// ігііе, если поток по-прежнему открыт для записи 
// 14 ) будет вызываться при опустошении внутр. буфера 


Как видно из примеров выше, потоки ввода/вывода, реализованные в интерпре¬ 
таторе Ыосіе, могут работать и с двоичными, и с текстовыми данными. Текст пере¬ 
дается с использованием простых строк ^ѵаЗсгірі. Байты обрабатываются с по- 
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мощью специфического для №хіе типа данных В и Р Ре г. Буферы в интерпретаторе 
Косіе являются объектами, подобными массивам, с фиксированной длиной, эле¬ 
ментами которых могут быть только числа в диапазоне от 0 до 255. Программы* 
выполняющиеся под управлением Кобе, часто интерпретируют буферы как не¬ 
прозрачные блоки данных, читая их из одного потока и записывая в другой. Тем 
не менее байты в буфере доступны как обычные элементы массива, а сами буфе¬ 
ры имеют методы, позволяющие копировать байты из одного буфера в другой, по¬ 
лучать срезы буфера, записывать строки в буфер с использованием заданной ко¬ 
дировки и декодировать буфер или его часть обратно в строку: 


ѵаг ЬуРез = пей ВиРРег(256); 
Рог(ѵаг і = 0; і < ЬуСез. ІепдІИ ; 
ЬуРез[і] = і; 

ѵаг епс) = ЬуРез. з1ісе(240, 256); 

епс)[0] 

епс1[0] = 0; 

ЬуРез[240] 

ѵаг тоге = пем ВііРРег(8); 
епс). сору (тоге, 0, 8, 16); 
тоге[0] 


// Создать новый буфер на 256 байт 
і ++ ) // Цикл по индексам 

// Установить каждый элемент в буфере 
// Получить срез буфера 
// => 240: епс)[0] = ЬуРез[240] 

// Изменить элемент среза 
// => 0: буфер тоже изменится 
// Создать новый отдельный буфер 
// Скопировать элементы 8-15 из епс)[] в тоге[] 
// => 248 


// Буферы также позволяют выполнять преобразования двоичных данных в строки 
// и обратно. Допустимые кодировки: ’ЧіІіРв", "азсіі" и ■'Ьазе64". 

// По умолчанию используется "ііРРв". 

ѵаг ЬііР = пей ВііРРег("2тіг", ЧіРРв"); // Закодировать текст в байты, ІРТР-8 
ЬііР.ІепдРН Ц => 3 символа занимают 4 байта 

ЬцРЛо8Ргіпд() // => "2тсг": обратно в текст 

ЬііР = пей ВііРРег(ІО); // Новый буфер фиксированной длины 

ѵаг Іеп = ЬііР.игіі:е("7іг ? '‘, 4); // Записать текст, начиная с 4-го байта 

Ьиі 1 . ІіоЗі; гіпд( "иіі^в” , 4. 4+1еп) // => "яг ? ": декодировать диапазон байтов 

Инструменты интерпретатора Ыойе для работы с файлами и файловой системой 
находятся в модуле «&*: 

ѵаг Рз = гедіііге("Рз"); // Загрузит инструменты для работы с файловой системой 


Для большинства своих методов этот модуль предоставляет синхронные версии. 
Любой метод, имя которого оканчивается на «8упс», является блокирующим ме¬ 
тодом, возвращающим значение и возбуждающим исключение. Методы для ра¬ 
боты с файловой системой, имена которых не оканчиваются на «8упс», являются 
неблокирующими - они возвращают результаты или ошибки посредством пере¬ 
даваемых им функций обратного вызова. Следующий фрагмент демонстрирует, 
как реализуется чтение текстового файла с использованием блокирующего мето¬ 
да и как реализуется чтение двоичного файла с использованием неблокирующего 
метода: 


// Синхронное чтение файла. Следует передать имя кодировки, 

// чтобы в результате получить текст, а не двоичные байты, 
ѵаг РехР = Рз. геасІРіІеЗупсС'сопРід.ізоп", "иРР8"); 

// Асинхронное чтение двоичного файла. Следует передать функцию, чтобы получить данные 
Рз. геасІРіІеС'ітаде.рпд", Рііпс1:іоп(егг, ЬиРРег) { 

ІР (егг) РНгоѵу/ егг; // Если что-то пошло не так 
ргосезз(ЬиРРег); // Содержимое файла в параметре ЬиРРег 

}); 
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Для записи в файл существуют аналогичные функции игіі:еРі1е() и игіГеРіІе- 
5упс(): 

Гз.игіГеРіІеС'сопГід.]зоп", 5І:гіпдіГу(іі5егргеР5)); 

Функции, представленные выше, интерпретируют содержимое файла как един¬ 
ственную строку или объект ВиГГег. Кроме того, для чтения и записи файлов ин¬ 
терпретатор Кобе определяет также АРІ потоков ввода/вывода. Функция ниже 
копирует содержимое одного файла в другой: 

// Копирование файлов с применением АРІ потоков ввода/вывода. 

// Чтобы определить момент окончания копирования, 

// ей нужно передать функцию обратного вызова 
ГипсГіоп Гі1еСору(Гі1епате1, Гі1епате2, сіопе) { 

ѵаг іпрііі: = Гз. сгеаГеВеасіЗі:геат(Гі1епате1); // Входной поток 

ѵаг оііГрііГ = Гз. сгеаі:е\л/гіі:е31:геат(Гі1епате2): // Выходной поток 

іпрііі:.оп("с)а1:а'\ ГипсГіоп(с)) { оіЦріЦ.игіГе(сІ); }); // Копировать 
іпрііі:. оп("еггог", Гііпс1:іоп(егг) { хЬгоѵі егг; }); // Сообщить об ошибке 

іприі:. оп("епс)”, ГцпсГіопО { // По исчерпании входных данных 

оііГрііГ.епсК); // закрыть выходной поток 

іГ (сіопе) с)опе(); // И известить вызвавшую программу 

}); 

} 

Модуль «Гз» включает также несколько методов, возвращающих список содер¬ 
жимого каталогов, атрибуты файлов и т. д. Следующая ниже программа для ин¬ 
терпретатора №)бе использует синхронные методы для получения списка содер¬ 
жимого каталога, а также для определения размеров файлов и времени последне¬ 
го их изменения: 


#! /цзг/ІосаІ/Ып/посІе 

ѵаг Гз = гедііігеС'Гз"), раГИ = гециі ге( "раГГі” ); // 

ѵаг с)іг = ргосезз. смс)( ); // 

іГ (ргосезз.агдѵ.ІепдГН > 2) с)іг = ргосезз.агдѵ[2]; // 
ѵаг Гііез = Гз. геасШг5упс(сІіг); // 

ргосезз. зГсІоиГ. \л/гіге( "Ыаше\гЗі2е\1;0а1:е\п"); // 

Гііез.ГогЕасН(Гііпс1:іоп(Гі1епате) { // 

ѵаг ГііПпате = раГП. зоіпСсііг, Гііепате); // 

ѵаг зіаГз = Гз. зГаГЗупсС Гиііпате); // 

іГ (зШз. ізйігесГогу()) Гііепате += // 

ргосезз. зГсіоііГ. мгіі:е( Гііепате + "\г" + // 

зіаіз.зііе + "М" + // 

зГаГз.тГіте + "\п"); // 

}); 


Загрузить модули 
Текущий каталог 
Или из команд, строки 
Прочитать содер. кат- га 
Вывести заголовок 
Для каждого файла 
Объед. имя и каталог 
Получить атрибуты файла 
Пометить подкаталоги 
Вывести имя файла 
размер файла 
и время поел, изменения 


Обратите внимание на комментарий #! в первой строке, в примере выше. Это спе¬ 
циальный комментарий, используемый в ІІпіх, чтобы объявить сценарий, сле¬ 
дующий далее, исполняемым, определив файл интерпретатора, который должен 
его выполнить. Интерпретатор Кобе игнорирует подобные строки комментариев, 
когда они находятся в первых строках файлов. 

Модуль «пеі» определяет АРІ для организации взаимодействий по протоколу 
ТСР. (Для выполнения сетевых взаимодействий на основе дейтаграмм можно ис¬ 
пользовать модуль «б&гат».) Ниже приводится пример очень простого сетевого 
ТСР-сервера, реализованного на основе особенностей Кобе: 
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// Простой эхо-сервер, реализованный на основе особенностей Иосіе: 

// он ожидает соединений на порту с номером 2000 и отправляет обратно клиенту 

// все данные, которые получит от него. 

ѵаг пеі = гедіііге( ’пеТ'); 

ѵаг зегѵег = пеТ. сгеаТеЗегѵег(); 

зегѵег. 1із1:еп(2000, ТипсТіопО { сопзоіе. 1од("Прослушивается порт 2000"); }); 
зегѵег.опС'соппесііоп", ТипсТіоп(зТгеат) { 

сопзоіе. 1од("Принято соединение от", зТгеат. гетоІеАсІсІгезз); 
зТгеат. оп("сіаііа", І'ипсТіопСсІаііа) { 5І:геат.игіі:е(с1а1:а); }); 
зІгеат.опС'епсГ, ^ііпсІіопСсіаІіа) { сопзоіе. 1од( "Соединение закрыто"); }); 

}): 

В дополнение к базовому модулю «пеі» в интерпретаторе Кобе имеется встроен¬ 
ная поддержка протокола НТТР в виде модуля «Мір». Особенности его использо¬ 
вания демонстрируют примеры, следующие ниже. 

12.2.1. Пример использования ІЧосІе: НТТР-сервер 

В примере 12.2 приводится реализация простого НТТР-сервера, основанная на 
особенностях интерпретатора Кобе. Она обслуживает файлы в текущем каталоге 
и дополнительно реализует два адреса ШІЬ специального назначения, которые 
обслуживаются особым образом. В этой реализации используется модуль «Мір», 
входящий в состав интерпретатора Кобе, и применяются АРІ доступа к файлам 
и потокам ввода/вывода, демонстрировавшиеся выше. В примере 18.17, в гла¬ 
ве 18, демонстрируется аналогичный специализированный НТТР-сервер. 

Пример 12.2. НТТР-сервер , основанный на особенностях Иойе 

// Простой ИосІеЭВ НТТР-сервер, обслуживающий файлы в текущем каталоге 
// и реализующий два специальных адреса СІРІ для нужд тестирования. 

// Подключение к серверу выполняется по адресу Ш1:р://1оса1Ноз1; 8000 
// или НПр://127.0.0.1:8000 

// Сначала необходимо загрузить используемые модули 
ѵаг ППр = гедіііге( 'Пир'); // АРІ НТТР-сервера 

ѵаг {"в = гецііігеС '^з’); // Для работы с локальными файлами 

ѵаг зегѵег = пеѵѵ Ніір.5егѵег(); // Создать новый НТТР-сервер 
зегѵег. 1 ізііеп(8000); // Прослушивать порт 8000. 

// Для регистрации обработчиков событий в Иосіе используется метод "оп()". 

// Когда сервер получает новый запрос, для его обработки вызывается функция, 
зегѵег.опСгеццезі:", І'ипсііоп (гецііезі:, гезропзе) { 

// Выполнить разбор адреса ІІРІ 

ѵаг игі = гецііігеС ’іігГ ).рагзе(гедиез1:.иг1); 

// Специальный адрес СІРЬ, который вынуждает сервер выполнить задержку перед ответом. 
// Это может быть полезно для имитации работы с медленным сетевым подключением. 

(іігі. раІНпате === "Дезі/сіеіау" ) { 

// Величина задержки определяется из строки запроса 
// или устанавливается равной 2000 миллисекунд 
ѵаг сіеіау = рагзеІпКіігІ.дііегу) || 2000; 

// Установить код состояния и заголовки ответа 

гезропзе. игіІеНеасК 200, {"Сопіепі-Туре" : "Іехіі/ріаіп; сітагзе1:=ІІТР-8"}); 

// Начать отправку ответа немедленно 
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гезропзе.мгіре("3адержка на " + сіеіау + " миллисекунд...”); 

// А затем завершить другой функцией, которая будет вызвана позже. 
зеРТітеоиР(РцпсРіоп() { в 

гезропзе. югіре(" готово."); 
гезропзе.епсК); 

}, сіеіау); 

) 

// Если запрошен адрес "/РезР/тіггог", отправить запрос обратно целиком. 

// Удобно, когда необходимо увидеть тело и заголовки запроса, 
еізе іР (іігі.раРЬпате === "/РезР/тіггог") { 

// Код состояния и заголовки ответа 

гезропзе.мгіРеНеасН200, {"СопРепр-Туре": "РехР/рІаіп; сЬагзе1:=ІІТР-8”}); 

// Вставить в ответ тело запроса 
гезропзе.ѵѵгіРеСгедцезР.теРЬосі + ” " + гедцезР.игІ + 

НТТР/" + гедцезр.ЬрррѴегзіоп + "\г\п"); 

// И заголовки запроса 
Рог(ѵаг И іп гедцезР.ЬеасІегз) { 

гезропзе. \л/гі1;е(М + ": + гедцезР. Гіеас)егз[ Гі] + "\г\п"); 

) 

гезропзе.игіРе("\г\п"); // За заголовками следует дополнительная пустая строка 
// Завершение отправки ответа выполняется следующими функциями-обработчиками: 

// Если в сЬііпк передается тело запроса, вставить его в ответ. 
гедцезР.оп("с1аРа", РііпсРіоп(сЬцпк) { гезропзе.\А/гі1:е(сГіипк); }); 

// Когда достигнут конец запроса, ответ также завершается. 
гедііезР.оп("епсГ, РцпсРіоп(сЬііпк) { гезропзе.епсі(); }); 

} 

// Иначе обслужить файл из локального каталога, 
еізе { 

// Получить имя локального файла и определить тип его содержимого по расширению, 
ѵаг Рііепате = іігі.раРЬпате.зиЬзІ:гіпд( 1); // удалить начальный / 
ѵаг Руре; 

з\ѵіі:сГі(Рііепате.зиЬзІгіпд(Гііепате.ІазИпсІехОРС*'.”)+1)) { // расшир. 
сазе "ЬРтІ": 

сазе "ЬРт": Руре = "РехР/ЬРтІ; сЬагзе1:=ІІТР-8**; Ьгеак; 

сазе *^з": Руре = "аррІісаРіоп/ЗаѵаЗсгірР;сЬагзеР=ІЛТ-8"; Ьгеак; 

сазе "сзз": Руре = "РехР/сзз; сЬагзеР=ІЛТ-8"; Ьгеак; 

сазе "РхР" Руре = "РехР/рІаіп; сГіагзе1:=ІІТР-8"; Ьгеак; 

сазе "тапіРезР": Руре = "РехР/сасЬе-тапіРезР; сЬагзеР=ІЛТ-8"; Ьгеак; 

ЬеРаііІР: Руре = "аррІісаРіоп/осРеР-зРгеат"; Ьгеак; 

} 

// Прочитать файл в асинхронном режиме и передать его содержимое единым блоком 
// в функцию обратного вызова. Для очень больших файлов лучше было бы 
// использовать АРІ потоков ввода/вывода с функцией Рз.сгеаРеПеас)$Ргеат(). 

Рз. геас)Рі1е( Шепате, РцпсРіоп(егг, сопРепР) { 

іР (егг) { // Если по каким-то причинам невозможно прочитать файл 
гезропзе. мгіРеНеас)(404, { // Отправить 404 №)Р Роцпс) 

"СопРепр-Туре": "РехР/рІаіп; сЬагзеР=1ЯР-8"}); 
гезропзе. мгіРе(егг.теззаде); // Тело сообщения об ошибке 
гезропзе.епс)(); // Завершить отправку 

} 

еізе { // Иначе, если файл успешно прочитан. 

гезропзе. игіРеНеас)( 200, // Установить код состояния и тип МІМЕ 

{"СопРепр-Туре": Руре}); 
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гезропзе.игііе(сопіепі); // Отправить содержимое файла 
гезропзе. епс!(); // И завершить отправку 

} 

}); 

} 

}); 

12.2.2. Пример использования ІЧосІе: 
модуль утилит клиента НТТР 

В примере 12.3 определяется несколько вспомогательных клиентских функций, 
использующих модуль «Мір», позволяющих выполнять СЕТ- и Р08Т-запросы 
протокола НТТР. Пример оформлен как модуль «МІриШв», который можно ис¬ 
пользовать в собственных программах, например: 

ѵаг Ніірціііз = гедиі ге(". /Ігі:1:ри1:і1з'‘ ): // Отметьте отсутствие расш. ”оз" 

Ніірціііз.деі(цг1, іцпсііоп(зіаіцз, Неасіегз. Ьосіу) { сопзоіе.Іод(ЬосІу); }); 

При выполнении программного кода модуля функция гедиіге() не использует 
обычную функцию еѵа1(). Модули выполняются в специальном окружении, что¬ 
бы они не могли определять глобальные переменные или как-то иначе изменять 
глобальное пространство имен. Это специализированное окружение для выпол¬ 
нения модулей всегда включает глобальный объект с именем ехрогіз. Модули экс¬ 
портируют свои АРІ, определяя свойства этого объекта. 1 

Пример 12.3. Модуль «МіриШз» для интерпретатора Иоде 

и 

// Модуль "Ніірціііз" для интерпретатора Мойе. 

// 

// Выполняет асинхронный НТТР ОЕТ-запрос для указанного ІІВІ_ и передает 
// код состояния НТТР, заголовки и тело ответа указанной функции обратного 
// вызова. Обратите внимание, как этот метод экспортируется через объект ехрогіз. 
ехрогіз.деі = І'ипсІііопС и гі , саІІЬаск) { 

// Разобрать СІРІ и получить необходимые фрагменты 

іігі = гедціге(’цгі ‘). рагзе(игі); 

ѵаг Нозіпате = іігі.Нозіпате, рогі = цгі.рогі || 80; 

ѵаг раіН = игі. раіНпате, дцегу = іігі.дііегу; 

іі (диегу) раіН += "?” + дііегу; 

// Выполняем простой ОЕТ-запрос 

ѵаг сііепі = гедціге("Ніір").сгеаіеС1іепі(рогі, Нозіпате); 
ѵаг гедцезі = сііепі. гедиез1:("ОЕТ”, раіН, { 

"Нозі": Нозіпате // Заголовки запроса 

}): 

гедцезі. епс)(); 

// Функция обработки ответа после начала его получения 
гедцезі.оп(" гезропзе”, іцпсііоп(гезропзе) { 

// Указать кодировку, чтобы тело возвращалось как строка, а не байты 


1 Интерпретатор Мойе реализует протокол СоттотІВ работы с модулями, описание ко¬ 
торого можно найти по адресу НИр://іѵіѵіѵ.соттоп]8.ог§/8рес8/тосіиІе8/1.0/. 
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гезропзе. 5еІЕпсоРіпд( ); 

// Для сохранения тела ответа по мере получения 
ѵаг Роду = 

гезропзе.опС'РаІа", ^цпсІіопСсРііпк) { Роду += сРцпк; }); 

// По окончании тела ответа вызвать функцию обратного вызова 
гезропзе.опС'епР", ТцпсТіопО { 
іГ (саІІРаск) 

саІІРасИгезропзе.зІаІііізСоРе, гезропзе.РеаРегз. РоРу); 

}); 

}); 

}; 

// Простой НТТР РОЗТ-запрос с данными в теле запроса 
ехрогіз. роз! = ^цпсІіопСигІ, Раіа, саІІРаск) { 

// Разобрать ІІРІ и получить необходимые фрагменты 
іігі = гедіііге( 'іігГ ). рагзе(цгі); 
ѵаг Розіпате = цгі.Нозіпате, рог! = игі.рогі || 80; 
ѵаг ра!Н = іігі. раІНпате, дііегу = цгі.дііегу; 
іГ (дііегу) раІР += "?" + дііегу; 

// Определить тип данных, отправляемых в теле запроса 
ѵаг !уре; 

і! (Раіа == пцП) Раіа = 

і! (Раіа іпзіапсео! Вц!!ег) // Двоичные данные 

Іуре = "аррІісаІіоп/осІеІ-зІгеапГ; 
еізе іГ (Іурео! Раіа === "зігіпд") // Строковые данные 

іуре = "Іехі/ріаіп; сНагзе!=ІЛТ-8"; 
еізе і! (іуреоГ Раіа === "оРіесІ") { // Пары имя/значение 

Раіа = гедііігеС'дііегузІгіпд"). зІгіпдіІ^РаІа); 
іуре = "аррІісаІііоп/х-ѵ^ш-Ропп-игІепсоРеР"; 

} 

// Выполнить РОЗТ-запрос и отправить тело запроса 
ѵаг сПепТ = гедиіге("Рир").сгеаІеС1іепі(рогг, Нозіпате); 
ѵаг гедиез! = сііепі:. гедцезіС'РОЗТ", ра!Р, { 

"Нозі": Нозіпате, 

"Сопіепі-Туре": Іуре 

}); 

гедцезІ.^гііе(РаІа); 
гедцез1:.епР(); 

гедцезІ.опС'гезропзе", Рцпс1:іоп(гезропзе) { 
гезропзе. зеІЕпсоРіпдС'ііІ^в"); 
ѵаг РоРу = "" 

гезропзе.опС'РаІа", !цпс1:іоп(сНипк) { РоРу += сПііпк; }); 

гезропзе.опС’епР", ТцпсТіопО { // По завершении вызвать обработчик 

іГ (саІІРаск) 

са11Раск(гезропзе.зіаІцзСоРе, гезропзе.РеаРегз, РоРу); 

}); 


// Отправить тело запроса 

// Обработать ответ 
// Предполагается текст 
// Для хранения тела ответа 




II 
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В данной части книги в главах с 13 по 22 язык ^ѵаЗсгірі описан в том виде, в ко¬ 
тором он реализован в веб-броузерах. В этих главах вводится много новых Лѵа- 
Зсгірі-объектов, представляющих окна, документы и содержимое документов 
в веб-броузерах. В них также описываются важные прикладные интерфейсы для 
организации сетевых взаимодействий, сохранения и извлечения данных и рисо¬ 
вания графических изображений в веб-приложениях. 

• Глава 13 « ЛѵаЗсгірі в веб-броузерах» 

• Глава 14 «Объект АУішіолѵ» 

• Глава 15 «Работа с документами» 

• Глава 16 «Каскадные таблицы стилей» 

• Глава 17 «Обработка событий» 

• Глава 18 «Работа с протоколом НТТР» 

• Глава 19 «Библиотека зС^иегу» 

• Глава 20 «Сохранение данных на стороне клиента» 

• Глава 21 «Работа с графикой и медиафайлами на стороне клиента» 

• Глава 22 «Прикладные интерфейсы НТМЬб» 




13 

.ІаѵаЗсгірІ в веб-броузерах 


Первая часть этой книги была посвящена базовому языку ЛѵаЗсгірі. Теперь мы 
перейдем к тому языку ЛѵаЗсгірі, который используется в веб-броузерах и обычно 
называется клиентским ЛѵаЗсгірі (сІіепі-зШе ЛѵаЗсгірі). Большинство примеров, 
которые мы видели до сих пор, будучи корректным ЛѵаЗсгірі-кодом , не зависели 
от какого-либо контекста; это были ЛѵаЗсгірі-фрагменты, не ориентированные 
на запуск в какой-либо определенной среде. Эта глава описывает такой контекст. 

До обсуждения ^ѵаЗсгірі давайте поближе познакомимся с веб-страницами, ото¬ 
бражаемыми в веб-броузерах. Некоторые страницы представляют статическую 
информацию; их можно называть документами. (Представление такой статиче¬ 
ской информации может быть дополнено динамическим поведением с помощью 
ЛѵаЗсгірі, но сама по себе информация остается статической.) Другие страницы 
больше похожи на приложения, чем на документы. Эти страницы способны ди¬ 
намически загружать новую информацию по мере необходимости, они могут со¬ 
стоять преимущественно из графических изображений, могут действовать без 
подключения к серверу, сохранять данные локально и, как следствие, способны 
восстанавливать свое состояние при повторном посещении. Имеются также веб¬ 
страницы, которые занимают промежуточное положение и объединяют в себе 
особенности документов и приложений. 

Эта глава начинается с краткого обзора клиентского ^ѵаЗсгірі. Она представля¬ 
ет простой пример и описание роли ^ѵаЗсгірі в веб-документах и в веб-приложе- 
ниях. Кроме того, здесь приводится краткое содержание глав второй части кни¬ 
ги. Последующие разделы описывают, как программный код на языке ЗаѵаЗсгірі 
встраивается в НТМЬ-доку менты и выполняется в них. Далее следуют разделы 
с обсуждением трех важных тем программирования на ЛѵаЗсгірі: совместимо¬ 
сти, удобства и безопасности. 

13.1. Клиентский іаѵаБсгірі 

Объект Ѵііпбоѵі является средоточием всех особенностей и прикладных интерфей¬ 
сов клиентского ^ѵаЗсгірі. Он представляет окно веб-броузера или фрейм, а со¬ 
слаться на него можно с помощью идентификатора міпсісм. Объект Міпсісм опреде- 
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ляет свойства, такие как Іосаіііоп, которое ссылается на объект І_оса1:іоп, опреде¬ 
ляющий ІЖЬ текущего окна, и позволяет сценарию загружать в окно содержи¬ 
мое других адресов ІШЬ: 

// Установить значение свойства для переход на новую веб-страницу 
міпбом. Іосаііоп = "ІтІ:1:р://ш\ѵ.огеі11у.сот/"; 

Кроме того, объект ілііпсіом определяет методы, такие как а1ег1;(), который отобра¬ 
жает диалог с сообщением, и зеІТітеоиіО, который регистрирует функцию для 
вызова через указанный промежуток времени: 

// Ждать 2 секунды и вывести диалог с приветствием 
5е1:Тітеоіі1:(Гііпс1:іоп( ) { а1ег1:( "Привет, Мир!"); }, 2000); 

Обратите внимание, что программный код выше неявно использует свойство объ¬ 
екта ѵѵіпсіоѵѵ. Объект Ілііпсіом в клиентском ^ѵаЗсгірі является глобальным объек¬ 
том. Это означает, что объект іл/іпсіоѵѵ находится на вершине цепочки областей ви¬ 
димости и что его свойства и методы фактически являются глобальными пере¬ 
менными и функциями. Объект ілііпсіом имеет свойство ѵѵіпсісм, которое всегда ссы¬ 
лается на сам объект. Это свойство можно использовать для ссылки на сам объект, 
но обычно в этом нет необходимости, если требуется просто сослаться на свойство 
глобального объекта окна. 

Объект ілііпсісм определяет также множество других важных свойств, методов 
и конструкторов. Полный их перечень можно найти в главе 14. 

Одним из наиболее важных свойств объекта ілііпсісм является свойство сіоситепі:: 
оно ссылается на объект Ооситепі:, который представляет содержимое документа, 
отображаемого в окне. Объект Ооситепі: имеет важные методы, такие как деІіЕІе- 
теп1ВуІсІ(), который возвращает единственный элемент документа (представляю¬ 
щий пару из открывающего и закрывающего тегов НТМЬ и все, что содержится 
между ними), опираясь на значение атрибута ісі элемента: 

// Отыскать элемент с атрибутом іб="1:іте5І:атр" 
ѵаг *ітез*атр = босцтеп1:.деШетеп1:ВуІ(К"1:іте5І:атр"); 

Объект Еіетепі:, возвращаемый методом де1:Е1етеп1:ВуІсІ(), также имеет ряд важ¬ 
ных свойств и методов, позволяющих сценарию извлекать содержимое элемента, 
устанавливать значения его атрибутов и т. д.: 

// Если элемент пуст, вставить в него текущую дату и время 
іГ (1ітезі:атр. Гігэ1:СПі1б == піііі) 

1ітез1атр.аррепбСШс1(досіітеп1:.сгеа1:еТех1:№х1е(пе\л/ 0аИе().1оЗі:гіпд())); 

Приемы получения ссылок на элементы, обхода элементов и изменения содержи¬ 
мого документа описываются в главе 15. 

Каждый объект Еіетепі: имеет свойства зіуіе и сІаззМате, позволяющие опреде¬ 
лять стили С88 элемента документа или изменять имена классов С88, применяе¬ 
мых к элементу. Установка этих свойств, имеющих отношение к С88, изменяют 
визуальное представление элемента документа: 

// Явно изменить представление элемента заголовка 
Іітезіатр.зіуіе.ЬаскдгоцпбСоІог = "уеііои"; 

// Или просто изменить класс и позволить определять особенности 
// визуального представления с помощью каскадных таблиц стилей: 

Іітезіатр. с1азз№те = "ШдЫідШ"; 
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Свойства зііуіе и с1азз№те, а также другие приемы управления стилями С88 опи¬ 
сываются в главе 16. 

Другим важным множеством свойств объектов ілііпсісм, Ооситепі: и Еіетепі: являют¬ 
ся свойства, ссылающиеся на обработчики событий. Они позволяют сценариям 
определять функции, которые должны вызываться асинхронно при возникнове¬ 
нии определенных событий. Обработчики событий позволяют программам на 
языке ^ѵаЗсгірі изменять поведение окон, документов и элементов, составляю¬ 
щих документы. Свойства, ссылающиеся на обработчики событий, имеют имена, 
начинающиеся с «оп», и могут использоваться, как показано ниже: 

// Обновить содержимое элемента іітеэіатр, когда пользователь щелкнет на нем 
іітеэіатр. опсііск = ^цпсііопО { ІНіэ. іппегНТМІ. = пем Оаіе(). іо8і:гіпд(); } 

Одним из наиболее важных обработчиков событий является обработчик опіоасі объ¬ 
екта Міпсіои. Это событие возникает, когда содержимое документа, отображаемое 
в окне, будет загружено полностью и станет доступно для выполнения манипуля¬ 
ций. Программный код на языке ^ѵаЗсгірі обычно заключается в обработчик со¬ 
бытия опіоасі. События являются темой главы 17. Пример 13.1 использует обработ¬ 
чик опіоасі и демонстрирует дополнительные приемы получения ссылок на элемен¬ 
ты документа, изменения классов С88 и определения обработчиков других собы¬ 
тий в клиентском ^ѵаЗсгірі. В этом примере программный код на языке ЛѵаЗсгірі 
заключен в НТМЬ-тег <зсгірі>. Подробнее этот тег описывается в разделе 13.2. Об¬ 
ратите внимание, что в этом примере имеется определение функции, заключенное 
в определение другой функции. Вложенные функции часто используются в кли¬ 
ентских сценариях на языке ЛѵаЗсгірі, особенно в виде обработчиков событий. 

Пример 13.1. Простой клиентский сценарий на языке За ѵаЗсгірі , 

исследующий содержимое документа 

СЮОСТѴРЕ Шш1> 

<Шт1> 

<Неас1> 

<5Іу1е> 

/* Стили С88 для этой страницы */ 

. геѵеаі * { біэріау: попе; } /* Элементы с атрибутом с1а55=" геѵеаі" невидимы */ 

. геѵеаі *. ІіапсІІе { біэріау: Ыоск;} /* Кроме элементов с с1азз=" Иапсііе” */ 

</з*у1е> 

<зсгірі> 

// Ничего не делать, пока документ не будет загружен полностью 
міпбом.опіоаб = ^цпсііопО { 

// Отыскать все контейнерные элементы с классом "геѵеаі" 
ѵаг еіетепіз = йосілпеп*. деІЕІетепІэВуСІаззНатеСгеѵеаі"); 

^ог(ѵаг і = 0; і < еіетепіз.ІепдІН; і++) { // Для каждого такого элемента... 
ѵаг е11 = е1етеп*з[і]; 

// Отыскать элементы с классом "Ьапсііе" в контейнере 
ѵаг ііііе = е11.деіЕ1етепІ5ВуС1а55№те("Напс11е”)[0]; 

// После щелчка на этом элементе сделать видимым остальное содержимое 
ас!сІПеѵеа1НапсЛег(і:іі:1е, еіі); 

} 

^цпсііоп асМПеѵеаІНапдІегСШІе, еіі) { 

Шіе.опсііск = ^цпсИопО { 

(еИ.сІазэИате == "геѵеаі") еіі.сІаэзИате = "геѵеаІесГ; 
еізе (еіі.сІаззИате == "геѵеаІесГ) еП.сІаээНате = "геѵеаі"; 
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} 

} 

}; 

</зсгір1:> 

</йеай> 

<Ьойу> 

<с!іѵ с1аз5="геѵеаГ’> 

<М с1азз="ИапсЛе ,, >Щелкните здесь, чтобы увидеть скрытый текст</М> 

<р>Этот абзац невидим. Он появляется после щелчка на заголовке. </р> 

</біѵ> 

</Ьобу> 

</И1:т1> 

Во введении к этой главе отмечалось, что некоторые веб-страницы ведут себя как 
документы, а некоторые - как приложения. Следующие два подраздела исследу¬ 
ют применение ^ѵаЗсгірі в обоих типах веб-страниц. 

13.1.1. Сценарии .ІаѵаЗсгірІ в веб-документах 

Программы на языке ^ѵаЗсгірі могут манипулировать содержимым документа 
через объект Ооситепі; и содержащиеся в нем объекты Еіетепі:. Они могут изменять 
визуальное представление содержимого, управляя стилями и классами С88, и оп¬ 
ределять поведение элементов документа, регистрируя соответствующие обработ¬ 
чики событий. Комбинация управляемого содержимого, представления и пове¬ 
дения называется динамическим НТМЬ (Бупатіс НТМЬ, или БНТМЬ), а прие¬ 
мы создания документов БНТМЬ описываются в главах 15, 16 и 17. 

Программный код на языке ^ѵаЗсгірі в веб-документах обычно должен исполь¬ 
зоваться ограниченно и выполнять определенную роль. Основная цель использо¬ 
вания ЛѵаЗсгірі - облегчить пользователю получение или отправку информа¬ 
ции. Работа пользователя не должна зависеть от наличия поддержки ^ѵа8сгірі 
в броузере; сценарии на ЛѵаЗсгірі можно отнести к подручным средствам, ко¬ 
торые: 

• Создают анимационные и другие визуальные эффекты, ненавязчиво руково¬ 
дя действиями пользователя и помогая ему передвигаться по странице. 

• Сортируют столбцы таблиц, упрощая пользователю поиск требуемой инфор¬ 
мации. 

• Скрывают определенное содержимое и отображают детали по мере «погруже¬ 
ния» пользователя в содержимое. 

13.1.2. Сценарии .ІаѵаЗсгірІ в веб-приложениях 

Веб-приложения применяют все возможности ЛѵаЗсгірі и БНТМЬ, которые ис¬ 
пользуются в веб-документах, но помимо управления содержимым, его представ¬ 
лением и поведением они также используют преимущества других фундамен¬ 
тальных механизмов, предоставляемых веб-броузерами. 

Чтобы понять суть веб-приложений, важно осознать, что веб-броузеры развива¬ 
лись не только как инструменты для отображения документов и давно уже транс¬ 
формировались в некоторое подобие простых операционных систем. Сравните: 
традиционные операционные системы позволяют создавать ярлыки (представ- 
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ляющие файлы и приложения) на рабочем столе и в папках. Веб-броузеры позво¬ 
ляют создавать закладки (представляющие документы и веб-приложения) на па¬ 
нели инструментов и в папках. Операционные системы выполняют множестве 
приложений в отдельных окнах; веб-броузеры отображают множество докумен¬ 
тов (или приложений) в отдельных вкладках. Операционные системы определяют 
низкоуровневые АРІ для организации сетевых взаимодействий, рисования гра¬ 
фики и сохранения файлов. Веб-броузеры определяют низкоуровневые АРІ для 
организации сетевых взаимодействий (глава 18), сохранения данных (глава 20) 
и рисования графики (глава 21). 

Представляя веб-броузеры как упрощенные операционные системы, веб-прило- 
жения можно определить как веб-страницы, в которых используется программ¬ 
ный код на языке ^ѵаЗсгірі для доступа к расширенным механизмам (таким 
как сетевые взаимодействия, рисование графики и сохранение данных) броузе¬ 
ров. Самым известным из этих механизмов является объект ХМШІіІірРедиезІ:, кото¬ 
рый обеспечивает сетевые взаимодействия посредством управляемых НТТР-за- 
просов. Веб-приложения используют этот механизм для получения новой инфор¬ 
мации с сервера без полной перезагрузки страницы. Веб-приложения, использую¬ 
щие этот прием, часто называют Аіах-приложениями, и они образуют фундамент 
того, что известно под названием <ЛУеЪ 2.0». Объект ХМ1_Н1:1:рРедиез1: во всех подроб¬ 
ностях рассматривается в главе 18. 

Спецификация НТМЬб (которая на момент написания этих строк еще находи¬ 
лась в состоянии проекта) и ряд связанных с ней спецификаций определяют ряд 
других важных прикладных интерфейсов для веб-приложений. В их число вхо¬ 
дят прикладные интерфейсы для сохранения данных и рисования графики, ко¬ 
торые описываются в главах 21 и 20, а также множество других возможностей, 
таких как геопозиционирование (^еоіосаііоп), управление журналами посеще¬ 
ний и фоновые потоки выполнения. Когда все эти прикладные интерфейсы будут 
реализованы, они обеспечат дальнейшее расширение возможностей веб-прило¬ 
жений. Подробнее о них рассказывается в главе 22. 

Безусловно, сценарии на языке ^ѵаЗсгірі занимают в веб-приложениях более 
важное положение, чем в веб-документах. Сценарии на ^ѵаЗсгірі расширяют 
возможности веб-документов, но при правильном оформлении документы оста¬ 
ются полностью доступными даже при отключенной поддержке ^ѵаЗсгірі. Веб¬ 
приложения по определению являются программами на языке ^ѵаЗсгірі, ис¬ 
пользующими механизмы, предоставляемые веб-броузерами, и не будут работать 
при отключенной поддержке ^ѵаЗсгірі. 1 

13.2. Встраивание .ІаѵаБсгірІ-кода 
в разметку НТМІ. 

Клиентский ЛѵаЗсгірі-код может встраиваться в НТМЬ-документы четырьмя 
способами: 


1 Интерактивные веб-страницы, взаимодействующие с серверными ССІ-сценариями по¬ 
средством форм НТМЬ также можно считать «веб-приложениями», и они могут быть 
написаны без применения ^ѵаЗсгірі. Однако это не тот тип веб-приложений, которые 
мы будем обсуждать в этой книге. 
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• встроенные сценарии между парой тегов <зсгір1:> и </зсгір1:>; 

• из внешнего файла, заданного атрибутом зге тега <зсгірі;>; 

• в обработчик события, заданный в качестве значения НТМЬ-атрибута, такого 
как опсііск или оптоизеоѵег; 

• как тело ІШЬ-адреса, использующего специальный спецификатор псевдопро¬ 
токола ЭаѵаЗсгірІ::. 

В следующих далее подразделах описываются все четыре способа встраивания 
программного кода на языке ^ѵаЗсгірі. Следует отметить, что НТМЬ-атрибуты 
обработчиков событий и адреса ІШЬ с псевдопротоколом ^аѵазегірі;: редко ис¬ 
пользуются в современной практике программирования на языке ЛѵаЗсгірі (они 
были более распространены на раннем этапе развития Всемирной паутины). 
Встроенные сценарии (в тегах <зсгірі;> без атрибута зге) также стали реже исполь¬ 
зоваться по сравнению с прошлым. Согласно философии программирования, из¬ 
вестной как ненавязчивый ^ ѵа8сгір! (ипоЫгизіѵе ^ѵаЗсгірі), содержимое (раз- 
метка НТМЬ) и поведение (программный код на языке ЛѵаЗсгірі) должны быть 
максимально отделены друг от друга. Следуя этой философии программирова¬ 
ния, сценарии на языке ^ѵаЗсгірі лучше встраивать в НТМЬ-документы с помо¬ 
щью элементов <зсгір1:>, имеющих атрибут зге. 

13.2.1. Элемент <5сгір1> 

Клиентские ^ѵаЗсгірі-сценарии могут встраиваться в НТМЬ-файлы между тега¬ 
ми <зсгір1;> и </зсгір1;>: 

<зсгірі:> 

// Здесь располагается ЭаѵаЗсгіріжод 
</зсгір1:> 

В языке разметки ХНТМЬ содержимое тега <зсгір1:> обрабатывается наравне с со¬ 
держимым любого другого тега. Если ^ѵаЗсгірі-код содержит символы < или &, 
они интерпретируются как элементы ХМЬ-разметки. Поэтому в случае примене¬ 
ния языка ХНТМЬ лучше помещать весь ЛѵаЗсгірі-код внутрь секции СБАТА: 

<зс гіріх ! [СЭАТА[ 

// Здесь располагается ЭаѵаЗсгіріжод 
]]></зсгірі:> 

В примере 13.2 демонстрируется содержимое НТМЬ-файла, включающего про¬ 
стую программу на языке ЛѵаЗсгірі. Действия программы описываются в ком¬ 
ментариях, тем не менее замечу, что главная цель этого примера в том, чтобы про¬ 
демонстрировать, как ^ѵаЗсгірі-код встраивается в файлы НТМЬ наряду со всем 
остальным, в данном случае - со стилями С88. Обратите внимание, что этот при¬ 
мер по своей структуре напоминает пример 13.1 и точно так же использует обра¬ 
ботчик события опіоасі. 

Пример 13.2. Простые часы с цифровым табло на ^ ѵа8сгірі 

<! ЭОСТУРЕ Шт1> <!— Это файл НТМ1.5 --> 

<Шт1> <!-- Корневой элемент --> 

<ПеаР> <!-- Заголовок, здесь располагаются сценарии и стили --> 

<*Ше>0іді*а1 С1оск</1:Ше> 

<зсгірі:> // Сценарий на ЭаѵаЗсгірі: 
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// Определение функции для отображения текущего времени 
^цпсТіоп бізр1ауТіте( ) { 

ѵаг еІТ = досцтепТ.деТЕ1етеп1:ВуІд("с1оск"); // Найти элемент с іб="с1оск" 
ѵаг пом = пем йаі:е(); // Получить текущее время 

еІТ. іппегНТМІ. = пом. ІіоІосаІеТішеЗі;гіпд(); // Отобразить его 

5е1:Тітеои1:(ді5р1ауТіте, 1000); // Вызвать снова через 1 сек. 


} 

міпбом.опіоаб = бізрІауТіте; // Начать отображение времени после загрузки документа. 
</зсгір1:> 


<зТу1е> /* 

йсіоск { /* 

^опі;: Ьоіб 24рТ запз; /* 

Ьаскдгоцпб: /* 

расШпд: Юрх; /* 

Ьогбег: зоііб Ыаск 2рх; /* 
Ьогбег-габіцз: Юрх; /* 


Таблица стилей С35 для часов */ 

Стили применяются к элементу с іб="с1оск" */ 
Использовать большой полужирный шрифт */ 
Светлый, голубовато-серый фон */ 

Отступы вокруг */ 

И сплошная черная рамка */ 

Закругленные углы (если поддерживаются) */ 


} 

</зТу1е> 

</Неаб> 

<Ьобу> 

<М>Цифровые часы</М> 
<зрап іб="с1оск''х/зрап> 
</Ьобу> 

</Шт1> 


<! — 
<! — 
<! — 


Тело - отображаемая часть документа --> 
Вывести заголовок --> 

Время выводится здесь --> 


13.2.2. Сценарии во внешних файлах 

Тег <зсгірІ> поддерживает атрибут зге, который определяет ІШЬ-адрес файла, со¬ 
держащего ^ѵа8сгірі-код. Используется он следующим образом: 

<ЗСГІрІ! 5ГС=". ./. ./зСГІрТз/цТІІ. 33"></ЗСГІрТ> 

Файл ^ѵа8сгірі-кода обычно имеет расширение ./'в и содержит Лѵа8сгірі-код 
в «чистом виде» без тегов <зсгірІ> или любого другого НТМЬ-кода. 

Тег <зсгірІ> с атрибутом зге ведет себя точно так, как если бы содержимое указан¬ 
ного файла ^ѵа8сгірі-кода находилось непосредственно между тегами <зсгірІ> 
и </зсгір1:>. Обратите внимание, что закрывающий тег </зсгір!> обязателен, даже 
когда указан атрибут зге и между тегами отсутствует Лѵа8сгірі-код. В разметке 
ХНТМЬ в подобных случаях можно использовать единственный тег <зсгір1/>- 

При использовании атрибута зге любое содержимое между открывающим и за¬ 
крывающим тегами <зсгір!> игнорируется. При желании в качестве содержимо¬ 
го в тег <зсгірі> можно вставлять описание включаемого программного кода или 
информацию об авторском праве. Однако следует заметить, что инструменты 
проверки соответствия разметки требованиям стандарта НТМЬб будут выдавать 
предупреждения, если между тегами <зсгір1: згс='"> и </зсгір1:> будет находиться 
какой-либо текст, не являющийся пробельными символами или комментариями 
на языке ЛѵаЗсгірі. 

Использование тега с атрибутом зге дает ряд преимуществ: 

• НТМЬ-файлы становятся проще, т. к. из них можно убрать большие блоки Заг 
ѵа8сгірі-кода, что помогает отделить содержимое от поведения. 
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• ^ѵаЗсгірі-функцию или другой Лѵа8сгірі-код, используемый несколькими 
НТМЬ-файлами, можно держать в одном файле и считывать при необходимо¬ 
сти. Это уменьшает объем занимаемой дисковой памятй и намного облегчает 
поддержку программного кода, т. к. отпадает необходимость править каждый 
НТМЬ-файл при изменении кода. 

• Если сценарий на языке ^ѵаЗсгірі используется сразу несколькими страни¬ 
цами, он будет загружаться броузером только один раз, при первом его ис¬ 
пользовании - последующие страницы будут извлекать его из кэша броузера. 

• Атрибут 5гс принимает в качестве значения произвольный ІЖЬ-адрес, поэтому 
ЛѵаЗсгірі-программа или веб-страница с одного веб-сервера может воспользо¬ 
ваться кодом (например, из библиотеки подпрограмм), предоставляемым дру¬ 
гими веб-серверами. Многие рекламодатели в Интернете используют этот факт. 

• Возможность загружать сценарии с других сайтов еще больше увеличивает 
выгоды, получаемые от кэширования: компания Ооо^іе продвигает использо¬ 
вание стандартных, хорошо известных ІШЬ-адресов для часто используемых 
клиентских библиотек, что позволяет броузерам хранить в кэше единствен¬ 
ную копию, совместно используемую многими сайтами в Веб. Привязка сце¬ 
нариев ЛѵаЗсгірі к серверам компании Ооо^іе может существенно умень¬ 
шить время запуска веб-страниц, поскольку библиотека наверняка уже будет 
храниться в кэше броузера пользователя, но при этом вы должны доверять 
стороннему программному коду, который может оказаться критически важ¬ 
ным для вашего сайта. За дополнительной информацией обращайтесь по ад¬ 
ресу: Ніір://сойе.ёооёІе.сот/арі8/аіахІіЪ8/. 

Возможность загрузки сценариев со сторонних серверов, отличных от тех, где на¬ 
ходятся документы, использующие эти сценарии, влечет за собой важное следст¬ 
вие, имеющее отношение к обеспечению безопасности. Политика общего проис¬ 
хождения, описываемая в разделе 13.6.2, предотвращает возможность взаимо¬ 
действия сценария на ЛѵаЗсгірі в документе из одного домена с содержимым из 
другого домена. Однако следует отметить, что источник получения самого сцена¬ 
рия не имеет значения, значение имеет источник получения документа, в кото¬ 
рый встраивается сценарий. Таким образом, политика общего происхождения 
в данном случае неприменима: ^ѵа8сгірі-код может взаимодействовать с доку¬ 
ментами, в которые он встраивается, даже если этот код получен из другого ис¬ 
точника, нежели сам документ. Включая сценарий в свою веб-страницу с помо¬ 
щью атрибута зге, вы предоставляете автору сценария (или веб-мастеру домена, 
откуда загружается сценарий) полный контроль над своей веб-страницей. 

13.2.3. Тип сценария 

^ѵаЗсгірі изначально был языком сценариев для Всемирной паутины, и по умол¬ 
чанию предполагалось, что элементы <зсгір1:> содержат или ссылаются на про¬ 
граммный код на языке ^ѵаЗсгірі. Если у вас появится необходимость использо¬ 
вать нестандартный язык сценариев, такой как ѴВЗсгірі корпорации Місгозоій 
(который поддерживается только в Іпіегпеі Ехріогег), необходимо в атрибуте Ііуре 
указать МІМЕ-тип сценария: 


<зсгір1: Туре="ТехТ/ѵЬзсгірТ"> 

// Здесь располагается ѴВЗсгірі-код 
</зсгірі:> 
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По умолчанию атрибут Ііуре получает значение «іехі^аѵаЗсгірі». При желании 
можно явно указать это значение, однако в этом нет необходимости. 

В старых броузерах вместо атрибута Ііуре использовался атрибут Іапдиаде тегй 
<зсгірі;>, и вы по-прежнему можете встретить веб-страницы, включающие такие 
теги: 

<зсгірі: 1апдііаде="іаѵазсгірі:"> 

// Здесь располагается ^ѵаЗсгірі-код. .. 

</зсгір1:> 

Атрибут Іапдиаде считается устаревшим и не должен более использоваться. 

Когда веб-броузер встречает элемент <зсгір1;> с атрибутом Ііуре, значение которого 
он не может распознать, он пытается проанализировать элемент, но не отображает 
и не выполняет его содержимое. Это означает, что элемент <зсгір1і> можно исполь¬ 
зовать для встраивания в документ произвольных текстовых данных: достаточно 
просто указать значение атрибута Ііуре, указывающее, что данные не являются 
выполняемым программным кодом. Чтобы извлечь эти данные, можно восполь¬ 
зоваться свойством Ііехіі объекта НТМІ_Е1етепіі, представляющего элемент зсгіріі 
(как получить эти элементы, описывается в главе 15). Однако важно отметить, 
что такой прием встраивания данных работает только при непосредственном 
встраивании их в разметку. Если указать атрибут зге и неизвестное значение в ат¬ 
рибуте Ііуре, броузер проигнорирует этот тег и ничего не будет загружать с ука¬ 
занного адреса ИНЬ. 

13.2.4. Обработчики событий в НТМІ. 

Лѵа8сгірі-код, расположенный в теге <зсгір1і>, исполняется один раз, когда со¬ 
держащий его НТМЬ-файл считывается в веб-броузер. Для обеспечения интерак¬ 
тивности программы на языке ЛѵаЗсгірі должны определять обработчики собы¬ 
тий - ^ѵаЗсгірі-функции, которые регистрируются в веб-броузере и автомати¬ 
чески вызываются веб-броузером в ответ на определенные события (такие как 
ввод данных пользователем). Как было показано в начале этой главы, ^ѵаЗсгірі- 
код может регистрировать обработчики событий, присваивая функции свойст¬ 
вам объектов Еіетепіі (таким как опсііск или оптоизеоѵег), представляющих НТМЬ- 
элементы в документе. (Существует и другой способ регистрации обработчиков 
событий - подробности приводятся в главе 17.) 

Свойства обработчиков событий, такие как опсііск, отражают НТМЬ-атрибуты 
с теми же именами, что позволяет определять обработчики событий, помещая Л- 
ѵаЗсгірі-код в НТМЬ-атрибуты. Например, чтобы определить обработчик собы¬ 
тия, который вызывается, когда пользователь щелкает на флажке в форме, код 
обработчика указывается в качестве значения атрибута опсііапде НТМЬ-элемента, 
определяющего флажок: 

<іпрыи Иуре="сПескЬох" пате="ор1:іопз" ѵа1ие="діГ1:\ѵгар" 

опсПапде^огРег.орііопз.діГімгар = ІПіз. сПескей;"> 

Обратите внимание на атрибут опсііапде. ^ѵаЗсгірі-код, являющийся значением 
этого атрибута, будет выполняться всякий раз, когда пользователь будет щелкать 
на флажке. 

Атрибуты обработчиков событий, включенных в разметку НТМЬ, могут содер¬ 
жать одну или несколько ^ѵаЗсгірі-инструкций, отделяемых друг от друга точ- 
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ками с запятой. Эти инструкции будут преобразованы интерпретатором в тело 
функции, которая в свою очередь станет значением соответствующего свойства об¬ 
работчика события. (Подробное описание, как выполняется преобразование тек; 
стового содержимого НТМЬ-атрибутов в функции на языке ЛѵаЗсгірі, приводит¬ 
ся в разделе 17.2.2.) Однако обычно в НТМЬ-атрибуты обработчиков событий 
включаются простые инструкции присваивания, как в примере выше, или про¬ 
стые вызовы функций, объявленных где-то в другом месте. Это позволяет дер¬ 
жать большую часть Лѵа8сгірі-кода внутри сценариев и ограничивает степень 
взаимопроникновения ЛѵаЗсгірі- и НТМЬ-кода. На практике многие веб-разра- 
ботчики считают плохим стилем использование НТМЬ-атрибутов обработчиков 
событий и предпочитают отделять содержимое от поведения. 

13.2.5. ^ѵаБсгірІ в ІІКЬ 

Еще один способ выполнения Лѵа8сгірі-кода на стороне клиента - включение 
этого кода в ІШЬ-адресе вслед за спецификатором псевдопротокола ]аѵазсгір1::. 
Этот специальный тип протокола обозначает, что тело ШІЬ-адреса представляет 
собою произвольный Лѵа8сгірі-код, который должен быть выполнен интерпре¬ 
татором ЛѵаЗсгірі. Он интерпретируется как единственная строка, и потому ин¬ 
струкции в ней должны быть отделены друг от друга точками с запятой, а для 
комментариев следует использовать комбинации символов /* */, а не //. «Ресур¬ 
сом», который определяется ІШЬ-адресом заѵазсгірі::, является значение, возвра¬ 
щаемое этим программным кодом, преобразованное в строку. Если программный 
код возвращает значение ипсІе'ГіпесІ, считается, что ресурс не имеет содержимого. 

ІШЬ вида ] аѵазс гірі; : можно использовать везде, где допускается указывать обыч¬ 
ные ІШЬ: в атрибуте тега <а>, в атрибуте асііоп тега <Гогт> и даже как аргу¬ 
мент метода, такого как \л/іпс!о\л/.ореп(). Например, адрес ІШЬ с программным ко¬ 
дом на языке ЛѵаЗсгірі в гиперссылке может иметь такой вид: 

<а ІігеГ=*'иаѵа$сгірі: : пеѵѵ 0а1:е(). ІоЬосаІеТітеЗі:гіпд(): ’> 

Который сейчас час? 

</а> 

Некоторые броузеры (такие как Гігеіох) выполняют программный код в ІШЬ 
и используют возвращаемое значение в качестве содержимого нового отображае¬ 
мого документа. Точно так же, как при переходе по ссылке Шір:, броузер стирает 
текущий документ и отображает новое содержимое. Значение, возвращаемое 
примером выше, не содержит НТМЬ-теги, но если бы они имелись, броузер мог бы 
отобразить их точно так же, как любой другой НТМЬ-документ, загруженный 
в броузер. Другие броузеры (такие как СЬготе и 8а?агі) не позволяют ІШЬ-адре- 
сам, как в примере выше, затирать содержимое документа - они просто игнори¬ 
руют возвращаемое значение. Однако они поддерживают ШІЬ-адреса вида: 

<а Иге^'^ауаЗсПр*: аіегі: ( пеѵ/ 0аіе().1:оІ_оса1еТіте5і:гіпд()); "> 

Узнать время, не затирая документ 

</а> 

Когда загружается такой ІШЬ-адрес, броузер выполняет Лѵа8сгірі-код, но, т. к. 
он не имеет возвращаемого значения (метод а1ег1;() возвращает значение ипсІе'Гі¬ 
песІ), такие броузеры, как Гігеіох, не затирают текущий отображаемый документ. 
(В данном случае ІШЬ-адрес ] аѵазс гірі:: служит той же цели, что и обработчик 
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события опсііск. Ссылку выше лучше было бы выразить как обработчик события 
опсііск элемента <Ьи 1: 1.о п> - элемент <а> в целом должен использоваться только 
для гиперссылок, которые загружают новые документы.) Если необходимо га¬ 
рантировать, что ІШЬ-адрес ^аѵазсгірі;: не затрет документ, можно с помощью 
оператора ѵоісі обеспечить принудительный возврат значения ипсІе'ГіпесІ: 

<а Иге1 : ="іаѵазсгір1: : ѵоісі ѵ/іпсіоѵѵ. ореп(’аЬои1::Ыапк'); ">0реп МіпсІо\ѵ</а> 

Без оператора ѵоісі в этом ІШЬ-адресе значение, возвращаемое методом МіпРом. 
ореп(), было бы преобразовано в строку и (в некоторых броузерах) текущий доку¬ 
мент был бы затерт новым документом с текстом: 

[оЬіесІ: Міпсіом] 

Подобно НТМЬ-атрибутам обработчиков событий, ІШЬ-адреса ^аѵазсгірі;: явля¬ 
ются пережитком раннего периода развития Веб и не должны использоваться 
в современных НТМЬ-страницах. ІШЬ-адреса ^аѵазсгірі;: могут сослужить полез¬ 
ную службу, если использовать их вне контекста НТМЬ-документов. Если потре¬ 
буется проверить работу небольшого фрагмента Лѵа8сгірі-кода, можно ввести 
ІШЬ-адрес ^аѵазсгірі;: непосредственно в адресную строку броузера. Другое уза¬ 
коненное применение ІШЬ-адресов ^аѵазсгірі;: - создание закладок в броузерах, 
как описывается ниже. 

13.2.5.1. Букмарклеты 

«Закладкой» в веб-броузере называется сохраненный ІШЬ-адрес. Если закладка 
содержит ІШЬ-адрес ]аѵазсгір1::, такая закладка играет роль мини-программы на 
языке ЛѵаЗсгірі, которая называется букмарклетом (і ЬооктагкШ ). Букмарклеты 
легко можно запустить из меню или панели инструментов. Программный код 
в букмарклете выполняется, как если бы он являлся сценарием в странице; он мо¬ 
жет читать и изменять содержимое документа, его представление и поведение. Ес¬ 
ли букмарклет не возвращает какое-либо значение, он может манипулировать со¬ 
держимым любого отображаемого документа, не замещая его новым содержимым. 

Взгляните на следующий фрагмент ІШЬ ^аѵазсгірі;: в теге <а>. Щелчок на ссылке 
открывает простейший обработчик ^ѵаЗсгірі-выражений, который позволяет 
вычислять выражения и выполнять инструкции в контексте страницы: 

<а Ьге?=' іаѵазсгірі: : 

ѵаг е = г = /* Вычисляемое выражение и результат */ 

сіо { 

/* Отобразить выражение и результат, а затем запросить новое выражение */ 
е = рготрК"Выражение: " + е + "\п" + г + "\п", е); 

ігу { г = "Результат: ” + еѵаі(е); } /* Попробовать вычислить выражение */ 
саісіі(ех) { г = ех; } /* Или запомнить ошибку */ 

} \ѵПі1е(е); /* продолжать, пока не будет введено пустое выражение */ 

/* или не будет выполнен щелчок на кнопке Отмена*/ 
ѵоісі 0; /* Это предотвращает затирание текущего документа */ 

> 

Обработчик ЭаѵаЭсгірі-выражений 
</а> 

Обратите внимание: несмотря на то что этот программный код записан в несколь¬ 
ких строках, синтаксический анализатор разметки НТМЬ обработает его как од- 
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ну строку, а потому однострочные комментарии (//) здесь работать не будут. Кро¬ 
ме того, не забывайте, что весь этот программный код является частью значения 
НТМЬ-атрибута, заключенного в одиночные кавычки, поэтому этот программ; 
ный код не может содержать одиночные кавычки. 

Ссылки, подобные этой, удобны, когда они «зашиты» в тело разрабатываемой 
страницы, но еще более удобны, когда они хранятся как закладки, которые мож¬ 
но запустить из любой страницы. Обычно закладки создаются щелчком правой 
кнопкой мыши на странице и выбором в контекстном меню пункта Добавить стра¬ 
ницу в закладки или подобного ему. В броузере Гігеіох для этого достаточно просто 
перетащить ссылку на панель закладок. 

13.3. Выполнение .ІаѵаБсіірІ-программ 

Вообще говоря, не существует формального определения программы на клиент¬ 
ском языке ЛѵаЗсгірі. Можно лишь сказать, что программой является весь про¬ 
граммный код на языке ^ѵаЗсгірі, присутствующий в веб-странице (встроенные 
сценарии, обработчики событий в разметке НТМЬ и ИКЬ-адреса ^аѵазсгірі::), 
а также внешние сценарии ЛѵаЗсгірі, на которые ссылаются атрибуты зге тегов 
<зсгір1:>. Все эти отдельные фрагменты программного кода совместно используют 
один и тот же глобальный объект Міпсіом. Это означает, что все они видят один 
и тот же объект Ооситепі: и совместно используют один и тот же набор глобальных 
функций и переменных: если сценарий определяет новую глобальную перемен¬ 
ную или функцию, эта переменная или функция будет доступна любому про¬ 
граммному коду на языке ЛѵаЗсгірі, который будет выполняться после этого 
сценария. 

Если веб-страница содержит встроенный фрейм (элемент <іГгате>), Лѵа8сгірІ-код 
во встроенном документе будет работать с другим глобальным объектом, отлич¬ 
ным от глобального объекта в объемлющем документе, и его можно рассматривать 
как отдельную ЛѵаЗсгірі-программу. Однако напомню, что не существует фор¬ 
мального определения, устанавливающего границы ЛѵаЗсгірі-программы. Если 
оба документа, вмещающий и вложенный, получены с одного сервера, то про¬ 
граммный код в одном документе сможет взаимодействовать с программным ко¬ 
дом в другом документе и их можно считать взаимодействующими частями одной 
программы. Подробнее о глобальном объекте Міпдсм и о взаимодействии программ, 
выполняющихся в разных окнах и фреймах, рассказывается в разделе 14.8.3. 

ШИгадреса заѵазегірі;: в букмарклетах существуют за пределами какого-либо 
документа, и их можно рассматривать, как своего рода пользовательские расши¬ 
рения или дополнения к другим программам. Когда пользователь запускает бук- 
марклет, программный код в букмарклете получает доступ к глобальному объек¬ 
ту и содержимому текущего документа и может манипулировать им как угодно. 

Программы на языке ЛѵаЗсгірі выполняются в два этапа. На первом этапе про¬ 
изводится загрузка содержимого документа и запускается программный код 
в элементах <зсгір1;> (и встроенные сценарии, и внешние). Обычно (но не всегда - 
подробнее об этом рассказывается в разделе 13.3.1) сценарии выполняются в по¬ 
рядке их следования в документе. Внутри каждого сценария программный код 
выполняется последовательно, от начала до конца, с учетом условных инструк¬ 
ций, циклов и других инструкций управления потоком выполнения. 
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После загрузки документа и выполнения всех сценариев начинается второй этап 
выполнения ЛѵаЗсгірі-программы, асинхронный и управляемый событиями. На 
протяжении этого этапа, управляемого событиями, веб-броузер вызывает функ¬ 
ции обработчиков (которые определены в НТМЬ-атрибутах обработчиков собы¬ 
тий, установлены сценариями, выполненными на первом этапе, или обработчика¬ 
ми событий, вызывавшимися ранее) в ответ на события, возникающие асинхрон¬ 
но. Обычно обработчики событий вызываются в ответ на действия пользователя 
(щелчок мышью, нажатие клавиши и т. д.), но могут также вызываться в ответ на 
сетевые взаимодействия, по истечении установленного промежутка времени или 
при возникновении ошибочных ситуаций в Лѵа8сгірі-коде. Подробнее о событи¬ 
ях и обработчиках событий рассказывается в главе 17. Некоторая дополнитель¬ 
ная информация о них будет также приводиться в разделе 13.3.2. Обратите вни¬ 
мание, что ІШЬ-адреса ^аѵазсгірі::, встроенные в веб-страницу, также можно от¬ 
нести к категории обработчиков событий, т. к. они не выполняются, пока не бу¬ 
дут активированы действиями пользователя, такими как щелчок мышью на 
ссылке или отправка формы на сервер. 

Одно из первых событий, возникающих на управляемом событиями этапе выпол¬ 
нения, является событие Іоасі, которое сообщает, что документ полностью загру¬ 
жен и готов к работе. ЛѵаЗсгірі-программы нередко используют это событие как 
механизм запуска. На практике часто можно увидеть программы, сценарии кото¬ 
рых определяют функции, но не выполняют никаких действий, кроме определе¬ 
ния обработчика события опіоасі, вызываемого по событию Іоасі и запускающего 
управляемый событиями этап выполнения. Именно обработчик события опіоасі 
выполняет операции с документом и реализует все, что должна делать программа. 
Этап загрузки ЛѵаЗсгірі-программы протекает относительно быстро, обычно он 
длится не более одной-двух секунд. Управляемый событиями этап выполнения, 
наступающий сразу после загрузки документа, длится на протяжении всего време¬ 
ни, пока документ отображается веб-броузером. Поскольку этот этап является 
асинхронным и управляемым событиями, он может состоять из длительных пе¬ 
риодов отсутствия активности, когда не выполняется никакой программный код 
ЛѵаЗсгірі, перемежающихся всплесками активности, вызванной действиями 
пользователя или событиями, связанными с сетевыми взаимодействиями. Подроб¬ 
нее оба этапа выполнения ЛаѵаЗсгірі-программ рассматриваются в разделе 13.3.4. 

Обе разновидности языка, базовый ЛаѵаЗсгірі и клиентский ЛаѵаЗсгірі, поддер¬ 
живают однопоточную модель выполнения. Сценарии и обработчики событий вы¬ 
полняются последовательно, не конкурируя друг с другом. Такая модель выпол¬ 
нения обеспечивает простоту программирования на языке ЛаѵаЗсгірі и обсужда¬ 
ется в разделе 13.3.3. 

13.3.1. Синхронные, асинхронные 
и отложенные сценарии 

Когда поддержка ЛаѵаЗсгірі впервые появилась в веб-броузерах, не существовало 
никаких инструментов обхода и управления структурой содержимого докумен¬ 
та. Единственный способ, каким Лѵа8сгірі-код мог влиять на содержимое доку¬ 
мента, - это генерировать содержимое в процессе загрузки документа. Делалось 
это с помощью метода сіоситепі:.\л/гіі;е( ). В примере 13.3 показано, как выглядел 
ультрасовременный Лѵа8сгірі-код в 1996 году. 
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Пример 13,3, Генерация содержимого документа во время загрузки 

<М>Таблица факториалов</М> 

<5сгірі:> 

Гцпсііоп ^асіогіаі(п) { // Функция вычисления факториалов 

ІГ (п <= 1) геіцгп п; 
еізе геішгп п*Гас1:огіа1(п-1 ); 


йосшіепі:. ѵѵгііе( "<1аЫе>" ); 

сіосшіепі:. ѵѵгііе( "<1: г><і;Іі>п</1:Ь><1:Іі>п! <АЬ><А г> 

Гог(ѵаг і = 1; і <= 10; і++) { 

Росцтеп1:.мгіі:е("<1:г><1:сІ>" + і + "<Ас1><*й>" 

} 

сіоситепі;. ѵѵгі*е( "<АаЫе>"); 

сіоситепі;.ѵѵгіі;е("6епега1;есі аі: " + пем Эаі:е()); 

</зсгірі> 


// Начало НТМІ_-таблицы 
); // Вывести заголовок таблицы 
// Вывести 10 строк 
+ Гасіогіаі(і) + "<АсІ><Аг>"); 

// Конец таблицы 
// Вывести время 


Когда сценарий передает текст методу йоситепЬмггЬеО, этот текст добавляется во 
входной поток документа, и механизм синтаксического анализа разметки НТМЬ 
действует так, как если бы элемент <зсгір*> был замещен этим текстом. Использо¬ 
вание метода с!оситеп1;.\л/гіі;е( ) более не считается хорошим стилем программирова¬ 
ния, но его применение по-прежнему возможно (раздел 15.10.2), и этот факт имеет 
важное следствие. Когда механизм синтаксического анализа разметки НТМЬ 
встречает элемент <зсгір*>, он должен, по умолчанию, выполнить сценарий, преж¬ 
де чем продолжить разбор и отображение документа. Это не является проблемой 
для встроенных сценариев, но если сценарий находится во внешнем файле, на ко¬ 
торый ссылается атрибут зге, это означает, что часть документа, следующая за сце¬ 
нарием, не появится в окне броузера, пока сценарий не будет загружен и выполнен. 

Такой синхронный , или блокирующий , порядок выполнения действует только по 
умолчанию. Тег <зсгір*> может иметь атрибуты сіе^ег и азупс, которые (в броузе¬ 
рах, поддерживающих их) определяют иной порядок выполнения сценариев. Это 
логические атрибуты - они не имеют значения; они просто должны присутство¬ 
вать в теге <зсгір*>. Согласно спецификации НТМЬб, эти атрибуты принимаются 
во внимание, только когда используются вместе с атрибутом зге, однако некото¬ 
рые броузеры могут поддерживать атрибут сіе^ег и для встроенных сценариев: 


<зс гірі: йеГег згс="с!еГеггесІ.із"х/зсгірі;> 
<зс гірі; азупс згс="азупс. зз"></зсгір*> 


Оба атрибута, сІеГег и азупс, сообщают броузеру, что данный сценарий не исполь¬ 
зует метод йосшпепЬюгИеО и не генерирует содержимое документа, и что броузер 
может продолжать разбор и отображение документа, пока сценарий загружает¬ 
ся. Атрибут с!е*Рег заставляет броузер отложить выполнение сценария до момента, 
когда документ будет загружен, проанализирован и станет готов к выполнению 
операций. Атрибут азупс заставляет броузер выполнить сценарий, как только это 
станет возможно, но не блокирует разбор документа на время загрузки сценария. 
Если тег <зсгір*> имеет оба атрибута, броузер, поддерживающий оба этих атрибу¬ 
та, отдаст предпочтение атрибуту азупс и проигнорирует атрибут сІе^ег. 

Обратите внимание, что отложенные сценарии выполняются в порядке их следо¬ 
вания в документе. Асинхронные сценарии выполняются сразу же, как только 
будут загружены, т. е. они могут выполняться в произвольном порядке. 
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На момент написания этих строк атрибуты азупс и сіе^ег поддерживались не все¬ 
ми броузерами, поэтому их следует рассматривать лишь как подсказки для опти¬ 
мизации: веб-страницы должны проектироваться так, чтобы они продолжали 
корректно работать, даже если отложенные и асинхронные сценарии выполня¬ 
ются броузером синхронно. 

Имеется возможность загружать и выполнять сценарии асинхронно, даже если 
броузер не поддерживает атрибут азупс, для чего достаточно динамически создать 
элемент <зсгірі;> и вставить его в документ. Это действие реализует функция Іоасі- 
азупс(), представленная в примере 13.4. Используемые ею приемы описываются 
в главе 15. 

Пример 13.4. Асинхронная загрузка и выполнение сценария 

// Асинхронная загрузка сценария из указанного иві_-адреса и его выполнение 
^ипсИоп Іоасіазупс(игі) { 

ѵаг ИеасІ = сіоситепі:. де1:Е1етеп1:зВуТадМате( "Ііеасі”)[0]; // Отыскать <ИеаР> 
ѵаг з = 0осцтепі:.сгеа1:еЕ1етепі:("зсгірі:"); // Создать элемент <зсгірі:> 

з.згс = игі; // Установить атрибут зге 

МеаР.аррепсЮШсКз); // Вставить <зсгір1:> в <ІіеаР> 

} 

Примечательно, что данная функция 1оас1а5упс() загружает сценарии динамиче¬ 
ски - сценарии, не включенные в веб-страницу, и на которые отсутствуют стати¬ 
ческие ссылки из веб-страницы, загружаются в документ и становятся частью 
выполняемой ЛѵаЗсгірі-программы. 

13.3.2. Выполнение, управляемое событиями 

Древняя ^ѵаЗсгірі-программа, представленная в примере 13.3, является син¬ 
хронной: она запускается на выполнение в процессе загрузки страницы, произво¬ 
дит вывод и завершается. Такие программы редко используются в наши дни. Про¬ 
граммы, которые пишутся в настоящее время, регистрируют функции обработ¬ 
чиков событий. Эти функции вызываются асинхронно, по событиям, для обработ¬ 
ки которых они были зарегистрированы. Веб-приложения, в которых требуется 
реализовать поддержку горячих комбинаций клавиш для выполнения типичных 
операций, могут, например, регистрировать обработчики событий нажатия кла¬ 
виш. Даже неинтерактивные программы используют события. Представьте, что 
требуется написать программу, которая должна проанализировать структуру до¬ 
кумента и автоматически сгенерировать оглавление. В этом случае не требуется 
обрабатывать события, возникающие в результате действий пользователя, однако 
программа все же должна зарегистрировать обработчик события опіоасі, чтобы 
поймать момент, когда закончится загрузка документа и он будет готов к созда¬ 
нию оглавления. 

События и обработка событий - это тема главы 17, а данный раздел содержит 
лишь краткий обзор. События имеют имена, такие как «сііск», «сЬап^е», «Іоасі», 
«тоизеоѵег», «кеургезз» или «геасіузіаіесЬап^е», указывающие общий тип собы¬ 
тия. События также имеют адресата - объект, в котором возникло событие. Ведя 
речь о событии, необходимо указывать не только его тип (имя), но и адресата, на¬ 
пример: событие «сііск» вобъектеНТМ1Ви1:1:опЕ1етеп1: или событие «геасіузіаіесЬап^е» 
в объекте ХМШІіІірВедиезІ:. 
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Если необходимо, чтобы программа откликалась на какое-то событие, необходи¬ 
мо написать функцию, которая называется «обработчиком событий», «приемни¬ 
ком событий» или просто «функцией обратного вызова». После этого функции 
нужно зарегистрировать, чтобы она вызывалась при появлении события. Как от¬ 
мечалось выше, это можно сделать с помощью НТМЬ-атрибутов, но такое смеши¬ 
вание Лѵа8сгірі-кода с разметкой НТМЬ может приводить к путанице. Поэтому 
обычно лучше регистрировать обработчики событий путем присваивания Лаѵа- 
8сгірі-функций свойствам целевого объекта, как показано ниже: 

міпсісм.опіоас] = ^шісііоп() { ... }; 

йосишепІ.деіЕІетепІіВуІсІС'ЬиІІопІ'^.опсІіск = ^ипс*іоп() { ... }; 

^ипсііоп ИапсЛеВезропзе() { ... } 

гедиезі: . оп геасіуз1:а1:есГіапде = ИапсЛеВезропзе; 

Обратите внимание, что свойства обработчиков событий имеют имена, которые 
в соответствии с соглашениями начинаются с префикса «оп», за которым следует 
имя события. Отметьте также, что в примере выше не производится вызов функ¬ 
ций: здесь выполняется присваивание функций соответствующим свойствам. 
Броузер автоматически будет вызывать эти функции при появлении событий. При 
создании асинхронных обработчиков событий часто используются вложенные 
функции, и на практике достаточно часто приходится писать программный код, 
который определяет функции внутри функций, вложенных в другие функции. 

В большинстве броузеров для большинства типов событий обработчики получа¬ 
ют в виде аргумента объект, свойства которого содержат информацию о событии. 
Например, объект, передаваемый обработчику события «сііск», будет иметь свой¬ 
ство, определяющее кнопку мыши, которой был выполнен щелчок. (В ІЕ инфор¬ 
мация о событии хранится в глобальном объекте и не передается функции-обра¬ 
ботчику.) Иногда значение, возвращаемое обработчиком события, используется, 
чтобы определить, достаточно ли ограничиться выполненной обработкой собы¬ 
тия и следует ли предотвратить выполнение действий по умолчанию, предусмат¬ 
риваемых броузером. 

События, адресатом которых является элемент документа, часто распространя¬ 
ются вверх по дереву документа и этот процесс называется «всплытием». Если, 
например, пользователь щелкнет мышью на элементе <ЬыИоп>, событие «сііск» бу¬ 
дет передано кнопке. Если это событие останется необработанным (и его распро¬ 
странение не будет остановлено) функцией, зарегистрированной в элементе кноп¬ 
ки, событие всплывет до элемента, в который вложена эта кнопка, и будет вызван 
обработчик события «сііск», зарегистрированный в этом контейнерном элементе. 

Если для одного элемента требуется зарегистрировать более одного обработчика 
единственного события или если требуется написать модуль, который мог бы без¬ 
опасно регистрировать обработчики событий, даже если для этих же событий 
и в этих же объектах уже были зарегистрированы обработчики другим модулем, 
можно воспользоваться другим приемом регистрации обработчиков. Большинство 
объектов, которые могут выступать в роли адресата события, имеют метод с именем 
ас1с1Еѵеп1:1_і5І:епег(), который позволяет регистрировать множество обработчиков: 

ѵ»/іпсІо\ѵ.ас]сІЕѵеп1:Іізі:епег("1оасІ", ^ипс*іоп() {...}, Шзе); 

гериезі:.асІсІЕѵепІіІізІіепегС'геасІузІіаііесііапде', ?ипс*іоп() {...}, Шзе); 

Обратите внимание, что первым аргументом этой функции передается имя собы¬ 
тия. Несмотря на то что метод асІ(1Еѵеп*І_із*епег() был определен стандартом уже 
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более десяти лет тому назад, корпорация Місгозоіі только недавно реализовала 
его в ІЕ9. В ІЕ8 и в. более ранних версиях необходимо использовать похожий ме¬ 
тод, который называется аИасИЕѵеп*( ): 

хѵіпсіоѵѵ.а«асііЕѵепі:("оп1оасГ, ?ііпсІіоп() {...}); 

Подробнее о функциях асісіЕѵепі:І_із1:епег() и а**асІіЕѵеп*() рассказывается в главе 17. 

Клиентские ЛаѵаЗсгірі-программы используют еще одну разновидность асин¬ 
хронных извещений, которые, строго говоря, не являются событиями. Если свой¬ 
ству опеггог объекта Міпсіом присвоить функцию, она будет вызываться при появ¬ 
лении ошибочных ситуаций (или необработанных исключений) в программном 
коде (раздел 14.6). Кроме того, функции зеШтеоцШ и зе*Іп*егѵа1() (они являют¬ 
ся методами глобального объекта Міпсіом и потому в клиентском ЛаѵаЗсгірі счита¬ 
ются глобальными функциями) вызывают указанные им функции по истечении 
определенного интервала времени. Функции, которые передаются зеШтеоиШ, 
регистрируются не так, как настоящие обработчики событий, и обычно они на¬ 
зываются «функциями обратного вызова», а не «обработчиками», но они, как 
и обработчики событий, выполняются асинхронно. Подробнее о функциях зеШ- 
теоиШ и зеІІпІегѵаІО рассказывается в разделе 14.1. 

Пример 13.5 демонстрирует применение функций зеШтеоиШ, ас!сІЕѵепі:1_і5І:епег() 
и а**асИЕѵеп*() внутри функции опІ_оас1(), которая регистрирует обработчик собы¬ 
тия окончания загрузки документа. опІ_оас!() - весьма полезная функция, и мы 
часто будем использовать ее в примерах на протяжении оставшейся части книги. 

Пример 13.5 . опЬоад(): вызов функции по окончании загрузки документа 

// Регистрирует функцию которая должна вызываться по окончании загрузки документа. 

// Если документ уже загружен, функция Т будет вызвана асинхронно и в кратчайшие сроки. 
^ипсИоп опІ_оасКО { 

ІР (опІ_оасІ.ІоасІесІ) // Если документ уже загружен 

тпдсм. зеІТітеоцКР, 0); // Вызвать Р, как можно скорее 

еізе і? (міпсіом. асІсІЕѵеп 1 :І_і 5 І:епег) // Стандартный метод регистрации событий 
міпйом.асісіЕѵепІІізіепегГ'ІоасГ, ^аізе); 
еізе Н (міпсіом. аіІасііЕѵепі:) // В ІЕ8 и в более ранних версиях 

міпс1ом.аиасІіЕѵеп{('‘оп1оасГ 1 О; // используется этот метод 

} 

// Сначала установить флаг, указывающий, что документ еще не загружен. 
опІ_оасІ. ІоасІесІ = Раізе; 

// И зарегистрировать функцию, которая сбросит флаг после загрузки документа. 
опІоасКРцпсІііопС ) { опІ_оасІ.ІоасІесІ = Ігііе; }); 

13.3.3. Модель потоков выполнения 
в клиентском .ІаѵаЗсгірі 

Ядро языка ЛаѵаЗсгірі не имеет механизма одновременного выполнения несколь¬ 
ких потоков управления, и клиентский язык ЛѵаЗсгірі не добавляет такой воз¬ 
можности. Стандарт НТМЬб определяет механизм поддержки фонового потока 
выполнения «АѴеЪ АѴогкегз» (подробнее об этом механизме рассказывается ниже), 
тем не менее Лѵа8сгірі-код на стороне клиента выполняется в единственном по¬ 
токе управления. Даже когда параллельное выполнение возможно, интерпрета¬ 
тор ЛаѵаЗсгірі не может обнаружить этот факт. 
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Выполнение в единственном потоке существенно упрощает разработку сценари¬ 
ев: можно писать программный код, пребывая в полной уверенности, что два об¬ 
работчика событий никогда не запустятся одновременно. Можно манипулиро; 
вать содержимым документа, точно зная, что никакой другой поток выполнения 
не попытается изменить его в то же самое время, и вам никогда не придется бес¬ 
покоиться о блокировках, взаимоблокировках или о состояниях гонки за ресур¬ 
сами при разработке своих программ. 

Выполнение в единственном потоке означает, что веб-броузер должен прекратить 
откликаться на действия пользователя на время выполнения сценария или обра¬ 
ботчика события. Это накладывает определенные требования: сценарии и обра¬ 
ботчики событий в ЛѵаЗсгірі не должны исполняться слитком долго. Если сце¬ 
нарий производит объемные и интенсивные вычисления, это вызовет задержку во 
время загрузки документа, и пользователь не увидит его содержимое, пока сцена¬ 
рий не закончит свою работу. Если продолжительные по времени операции выпол¬ 
няются в обработчике события, броузер может оказаться неспособным откликать¬ 
ся на действия пользователя, заставляя его думать, что программа «зависла». 1 

Если приложение должно выполнять достаточно сложные вычисления, вызы¬ 
вающие заметные задержки, то перед выполнением таких вычислений следует 
дать документу возможность полностью загрузиться. Кроме того, полезно преду¬ 
предить пользователя, что будут производиться длительные вычисления, в про¬ 
цессе которых броузер может не откликаться на его действия. Если есть такая 
возможность, длительные вычисления следует разбить на несколько подзадач, 
используя такие методы, как зеНітеоиШ и зеІІпІегѵаІО, для запуска подзадач 
в фоновом режиме с одновременным обновлением индикатора хода вычислений, 
предоставляющего обратную связь с пользователем. 

Стандарт НТМЬб определяет управляемую форму параллельного выполнения - 
механизм фонового потока выполнения под названием «дѵеЪ дѵогкег». ^еЪ >ѵог- 
кег - это фоновый поток выполнения, предназначенный для выполнения продол¬ 
жительных вычислений и предотвращения блокирования пользовательского 
интерфейса. Программный код, выполняемый в фоновом потоке игеЪ ѵѵогкег, не 
имеет доступа к содержимому документа, к информации, используемой главным 
потоком выполнения или другими потоками ^еЪ ^огкег, и может взаимодейство¬ 
вать с главным потоком и другими фоновыми потоками только посредством 
асинхронных событий. Благодаря этому параллельное выполнение не оказывает 
влияния на главный поток, а фоновые потоки не меняют базовую однопоточную 
модель выполнения ЛѵаЗсгірі-программ. Подробнее о фоновых потоках выпол¬ 
нения рассказывается в разделе 22.4. 

13.3.4. Последовательность выполнения 
клиентских сценариев 

Мы уже знаем, что выполнение ЛѵаЗсгірі-программ начинается с этапа выполне¬ 
ния сценариев и затем переходит к этапу выполнения, управляемому событиями. 


1 В некоторых броузерах имеется механизм предотвращения атак типа отказа в обслу¬ 
живании и случайных зацикливаний, который выводит перед пользователем окно за¬ 
проса, если сценарий или обработчик события выполняется слишком долго, и позво¬ 
ляет прервать выполнение зациклившегося сценария. 
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Этот раздел более подробно описывает последовательность выполнения Лѵа- 

Зсгірі-программ. 

1. Веб-броузер создает объект Роситепі; и начинает разбор веб-страницы, добав* 
ляя в документ объекты Еіетепі и текстовые узлы в ходе синтаксического ана¬ 
лиза НТМЬ-элементов и их текстового содержимого. На этой стадии свойство 
сіоситепі. геайуЗіаІе получает значение «Іоасііпё». 

2. Когда механизм синтаксического анализа НТМЬ встречает элементы <зсгір!>, 
не имеющие атрибута азупс и/или сіе^ег, он добавляет эти элементы в документ 
и затем выполняет встроенные или внешние сценарии. Эти сценарии выпол¬ 
няются синхронно, а на время, пока сценарий загружается (если это необходи¬ 
мо) и выполняется, синтаксический анализ документа приостанавливается. 
Такие сценарии могут использовать метод сіоситепі;.\л/гііе() для вставки текста 
во входной поток. Этот текст станет частью документа, когда синтаксический 
анализ продолжится. Синхронные сценарии часто просто определяют функ¬ 
ции и регистрируют обработчики событий для последующего использования, 
но они могут исследовать и изменять дерево документа, доступное на момент 
их запуска. То есть синхронные сценарии могут видеть собственный элемент 
<зсгір1;> и содержимое документа перед ним. 

3. Когда механизм синтаксического анализа встречает элемент <зсгір1;>, имею¬ 
щий атрибут азупс, он начинает загрузку сценария и продолжает разбор доку¬ 
мента. Сценарий будет выполнен сразу же по окончании его загрузки, но син¬ 
таксический анализ документа не приостанавливается на время загрузки сце¬ 
нария. Асинхронные сценарии не должны использовать метод сіоситепі;.\л/гі!е(). 
Они могут видеть собственный элемент <зсгір!>, все элементы документа, пред¬ 
шествующие ему и, возможно, дополнительное содержимое документа. 

4. По окончании анализа документа значение свойства сіоситепі;. геайуЗіаІе изме¬ 
няется на «іпіегасііѵе». 

5. Выполняются все сценарии, имеющие атрибут сІе'Гег, в том порядке, в каком 
они встречаются в документе. В этот момент также могут выполняться асин¬ 
хронные сценарии. Отложенные сценарии имеют доступ к полному дереву до¬ 
кумента и не должны использовать метод сіоситепі. \л/гііе( ). 

6. Броузер возбуждает событие «БОМСопіепіЬоасіесі» в объекте Ооситепі. Это со¬ 
бытие отмечает переход от этапа синхронного выполнения сценариев к управ¬ 
ляемому событиями асинхронному этапу выполнения программы. Следует, 
однако, отметить, в этот период также могут выполняться асинхронные сце¬ 
нарии, которые не были еще выполнены. 

7. К этому моменту синтаксический анализ документа завершен, но броузер все 
еще может ожидать окончания загрузки дополнительного содержимого, тако¬ 
го как изображения. Когда все содержимое будет загружено и все асинхрон¬ 
ные сценарии будут выполнены, свойство сіоситепі. геайуЗіаІе получит значе¬ 
ние «сотріеіе» и веб-броузер возбудит событие «ІоасЬ в объекте Міпсіом. 

8. С этого момента будут асинхронно вызываться обработчики событий в ответ 
на действия пользователя, сетевые операции, истечение таймера и т. д. 

Это идеализированная последовательность выполнения, и не все броузеры при¬ 
держиваются ее в точности. Событие «Іоасі» поддерживается повсеместно: его воз¬ 
буждают все броузеры, и оно является универсальным инструментом определе- 
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ния момента окончания загрузки документа и его готовности к выполнению опе¬ 
раций. Событие « БОМСопіепіЬоасІесІ » возбуждается перед событием «ІоасЬ и под¬ 
держивается всеми текущими броузерами, кроме ІЕ. Свойство йоситепі:. геайу51:а1:е 
реализовано в большинстве текущих броузеров на момент написания этих строк, 
но значения, которые получает это свойство, отличаются между броузерами. Ат¬ 
рибут йеГег поддерживается всеми современными версиями ІЕ, но только недавно 
был реализован в других броузерах. Поддержка атрибута азупс до сих пор не по¬ 
лучила широкого распространения, но асинхронное выполнение сценариев с ис¬ 
пользованием приема, представленного в примере 13.4, поддерживается всеми 
текущими броузерами. (Однако имейте в виду, что возможность динамической 
загрузки сценариев с помощью функции, такой как ІоасіазупсО, размывает гра¬ 
ницы между этапом загрузки сценариев и этапом выполнения программы, управ¬ 
ляемым событиями.) 

Данная последовательность не определяет момент, когда документ станет видим 
пользователю или когда веб-броузер должен начать откликаться на его действия. 
Все это - особенности каждой конкретной реализации. В случае очень больших 
документов или очень медленных сетевых подключений теоретически возможно, 
что веб-броузер будет отображать часть документа и позволять пользователю 
взаимодействовать с ним до того, как будут выполнены все сценарии. В этом слу¬ 
чае действия пользователя могут возбуждать события до начала управляемого 
событиями этапа выполнения программы. 

13.4. Совместимость на стороне клиента 

Веб-броузер - это своего рода операционная система для веб-приложений, но Все¬ 
мирная паутина - это разнородная среда, и ваши веб-документы и приложения 
будут просматриваться и выполняться в броузерах разных возрастов (от ультрасо¬ 
временных бета-версий до броузеров, возраст которых исчисляется десятилетия¬ 
ми, таких как ІЕ6), разных производителей (МісгозоН, Могіііа, Арріе, Соо&іе, 
Орега) и выполняющихся в разных операционных системах (АУіжкпѵз, Мае 08, 
Ілпих, іРЬопе 08, Апбгоіб). Поэтому достаточно сложно написать нетривиальную 
клиентскую программу на языке ^ѵаЗсгірі, которая будет корректно работать 
на таком многообразии платформ. 

Проблемы совместимости на стороне клиента делятся на три основные категории: 
Эволюционные 

Веб-платформа постоянно развивается и расширяется. Органы по стандарти¬ 
зации предлагают новые возможности или прикладные интерфейсы. Если ка¬ 
кая-то особенность кажется полезной, производители броузеров стремятся 
реализовать ее. Если достаточно большое число производителей обеспечивают 
ее совместимость, разработчики начинают ее использовать и опираться на эту 
особенность, что обеспечивает ей прочное положение в веб-платформе. Иногда 
инициативу берут на себя производители броузеров и веб-разработчики, и ор¬ 
ганы по стандартизации включают новую особенность в официальную версию 
после того, как эта особенность станет стандартом де-факто. В любом случае 
новая особенность добавляется в Веб. Новые броузеры поддерживают ее, а ста¬ 
рые - нет. Веб-разработчики разрываются между желанием использовать но¬ 
вую мощную особенность и стремлением сделать свои веб-страницы пригод- 
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ными к использованию для как можно более широкого круга посетителей - 
даже для тех, кто пользуется устаревшими броузерами. 

Отсутствие реализации 

Иногда мнения производителей броузеров относительно полезности той или 
иной особенности расходятся. Некоторые производители реализуют ее, дру¬ 
гие - нет. Это не проблема отличий между новыми версиями броузеров, под¬ 
держивающих особенность, и старыми версиями, не поддерживающими ее. 
Эта проблема связана с производителями броузеров, одни из которых решили 
реализовать особенность, а другие - нет. Например, ІЕ8 не поддерживает эле¬ 
мент <сапѵаз>, хотя все остальные броузеры реализовали его поддержку. Еще 
более вопиющий пример: корпорация МісгозоН долго отказывалась от наме¬ 
рений реализовать спецификацию БОМ Ьеѵеі 2 Еѵепіз (которая определяет 
метод ас№Еѵепі:І_і5І:епег() и связанные с ним). Эта спецификация была выпуще¬ 
на почти десять лет тому назад, и другие производители давно реализовали ее 
поддержку. 1 

Ошибки 

Все броузеры содержат ошибки, и ни один из них не реализует ЛѵаЗсгірі АРІ 
в полном объеме и в точном соответствии со спецификациями. Иногда созда¬ 
ние совместимых клиентских сценариев на языке ЛѵаЗсгірі является вопро¬ 
сом знания о существовании ошибок в броузерах и умения обходить их. 

К счастью, реализации самого языка ЛѵаЗсгірі, выполненные различными про¬ 
изводителями броузеров, являются совместимыми и не являются источником 
описываемых проблем. Все броузеры имеют совместимые реализации ЕСМА- 
Зсгірі 3, и к моменту написания этих строк все производители уже работали над 
реализацией ЕСМАЗсгірі 5. Переход от ЕСМАЗсгірі 3 к ЕСМАЗсгірі 5 также мо¬ 
жет породить проблемы несовместимости из-за того, что одни броузеры будут 
поддерживать строгий режим, а другие - нет, но, как ожидается, производители 
броузеров обеспечат совместимость своих реализаций ЕСМАЗсгірі 5. 

При решении проблем несовместимости в клиентских сценариях на языке Лѵа- 
Зсгірі в первую очередь необходимо идентифицировать проблему. Цикл выпуска 
новых версий веб-броузеров примерно в три раза короче цикла выпуска новых 
изданий этой книги, поэтому здесь невозможно с достаточной степенью надежно¬ 
сти сообщить, какие особенности и в каких версиях броузеров реализованы, тем 
более невозможно описать ошибки или отличия реализации особенностей в раз¬ 
ных броузерах. Такие подробности лучше всего искать в Сети. В процессе работы 
над стандартом НТМЬб рано или поздно должны появиться испытательные тес¬ 
ты. На момент написания этих строк таких тестов еще не существовало, но, как 
только они появятся, любой желающий сможет получить богатую информацию 
о совместимости того или иного броузера. А пока я приведу список веб-сайтов, где 
вы сможете отыскать полезные сведения: 

Нирз://(ІеѵеІорег.то2іІІа.огё 

Центр разработчиков МогШа (Могіііа Беѵеіорег Сепіег) 


1 Справедливости ради следует отметить, что версия ІЕ9 поддерживает и элемент 

<сапѵаз>, и метод асМЕѵеп1:І_із1:епег( ). 
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кіір://т8(Іп.тісго8о{і.сот 

Сообщество разработчиков, использующих продукты МісгозоН; (МісгозоН; Бе- 
ѵеіорег Кеіѵѵогк) 

Ніір://(ІеѵеІорег.аррІе.сот/8а{агі 

Центр разработки Заіагі (8а?агі Беѵ Сепіег) на сайте по связям с разработчи¬ 
ками, использующими продукты Арріе (Арріе Беѵеіорег Соппесііоп) 

кир://со(1е.ёооё1е.сот/йос1уре 

Компания Соо^іе описывает свой проект Босіуре как «энциклопедию откры¬ 
той Сети». Этот сайт, содержимое которого доступно пользователям для ре¬ 
дактирования, включает обширные таблицы совместимости для клиентского 
ЛѵаЗсгірі. К моменту написания этих строк данные таблицы содержали 
только сведения о существовании различных свойств и методов в каждом бро¬ 
узере: они фактически ничего не сообщают о том, насколько корректно рабо¬ 
тают эти особенности. 

кіір://еп.іѵікіре(Ііа.огё/іѵікі/СотрагІ80п_о{_Іауоиіепёіпе8_(НТМЬ_5) 1 

Статья в Википедии, в которой оценивается степень реализации особенностей 
и АРІ стандарта НТМЬб в различных броузерах. 

кіір://еп.іѵікіре<Ііа.огё/іѵікі/Сотрагі 80 п_о{_Іауоиі_епёіпе 8 __(Воситепі_ОЪіесі_ 

Мойеі) 

Аналогичная статья, в которой оценивается степень реализации особенностей 
БОМ. 

кіір://а.(іеѵегіа.сот/сапіи8е 

Сайт «Когда я смогу воспользоваться...» предоставляет информацию о реали¬ 
зации важных веб-особенностей, позволяя фильтровать ее по различным кри¬ 
териям, и дает рекомендации по их использованию, когда останется достаточ¬ 
но мало броузеров, не поддерживающих их. 

кир://іѵіѵіѵ.диігк8то<іе.огё/йот 

Содержит таблицы совместимости различных броузеров со спецификациями 
\УЗС БОМ. 

кіІр://іѵеЬ(іеѵоиі.пеі/Ьгоіѵ8ег-8иррогі 

Еще один сайт, созданный с целью предоставить информацию о реализации 
веб-стандартов различными производителями броузеров. 

Обратите внимание, что последние три сайта сопровождаются конкретными людь¬ 
ми. Несмотря на то что эти люди являются опытными разработчиками на клиент¬ 
ском ЛѵаЗсгірі, эти сайты могут содержать не самую последнюю информацию. 

Конечно, понимание проблем несовместимости между броузерами - это только 
первый шаг. Далее необходимо решить, как обращаться с этими проблемами. Од¬ 
на из стратегий заключается в том, чтобы ограничиться использованием только 
тех особенностей, которые одинаково хорошо реализованы (или легко имитиру¬ 
ются) во всех броузерах, поддержку которых вам требуется обеспечить. На эту 
стратегию опирается веб-сайт «Когда я смогу воспользоваться...», упомянутый 


1 Похожая статья в Википедии на русском языке: кіір:, Ц ги.іѵікірейіа.огё/іѵік^ /Сравне¬ 
ние-браузеров_(НТМЬ5). - Прим . перев . 
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выше 0 Ніір://а.(іеѵегіа.сот/сапіи8е): здесь перечислены особенности, ставшие при¬ 
годными к широкому использованию после того, как сократилась доля броузера 
ІБ6 и он перестал занимать ведущее положение на рынке. В следующих подраз» 
делах описывается несколько менее пассивных стратегий, которые можно ис¬ 
пользовать для обхода несовместимостей на стороне клиента. 


Несколько слов о «текущих броузерах» 

Тема клиентского ЛѵаЗсгірі изменчива, что стало особенно заметно с по¬ 
явлением Б85 и НТМЬб. Поскольку платформа развивается очень быстро, 
я не буду ограничиваться рекомендациями, касающимися конкретных 
версий тех или иных броузеров: любые такие рекомендации устареют за¬ 
долго до того, как появится новое издание этой книги. Поэтому вы часто 
будете видеть, что я специально подстраховываюсь, используя достаточно 
расплывчатую фразу «все текущие броузеры» (или иногда «все текущие 
броузеры, кроме ІЕ»). Чтобы добавить конкретики, замечу, что на тот мо¬ 
мент, когда я писал эту главу, текущими броузерами (здесь не имеются 
в виду бета-версии) были: 

• Іпіегпеі Ехріогег 8 

• Еіге&эх 3.6 

• За^агі 5 

• СЬготе 5 

• Орега 10.10 

Когда эта книга поступит в продажу, текущими броузерами, скорее всего, 
будут: Іпіегпеі Ехріогег 9, Еіге^ох 4, Заіагі 5, СЬготе 11 и Орега 11. 

Нет никаких гарантий, что каждое сделанное в книге утверждение о «те¬ 
кущих броузерах» в равной степени будет верным для каждого из этих кон¬ 
кретных броузеров. Но вы хотя бы будете знать, какие броузеры считались 
текущими, когда писалась эта книга. 

В пятом издании этой книги вместо выражения «текущие броузеры» ис¬ 
пользовалось выражение «современные броузеры». То издание было опуб¬ 
ликовано в 2006 году, когда текущими броузерами были Еігеіох 1.5, ІЕ6, 
Ваіагі 2 и Орега 8.5 (броузер СЬготе, созданный компанией Соо^іе, тогда 
еще не существовал). Любые ссылки на «современные броузеры», оставшие¬ 
ся в этой книге, теперь можно интерпретировать как «все броузеры», пото¬ 
му что версии, более старые, чем эти, практически вышли из употребления. 

Многие новейшие особенности клиентского ЛѵаВсгірі, описываемые в этой 
книге (в частности, в главе 22), реализованы пока не во всех броузерах. Осо¬ 
бенности, которые я выбрал для описания в этом издании, - это особенно¬ 
сти, для которых процесс стандартизации еще не завершен, но они уже 
реализованы как минимум в одном выпущенном в свет броузере и находят¬ 
ся в разработке, по крайней мере, еще в одном броузере и, скорее всего, бу¬ 
дут приняты всеми производителями броузеров (возможно, за исключени¬ 
ем Місговоіі). 
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13.4.1. Библиотеки обеспечения совместимости 

Один из самых простых способов избавиться от проблемы несовместимости за¬ 
ключается в использовании библиотек, реализующих обходные решения. Рас¬ 
смотрим в качестве примера элемент <сапѵа8>, предназначенный для создания гра¬ 
фических изображений на стороне клиента (эта тема обсуждается в главе 21). Бро¬ 
узер ІБ является единственным текущим броузером, не поддерживающим эту осо¬ 
бенность. Однако он поддерживает собственный, малоизвестный язык создания 
графических изображений на стороне клиента, который называется ѴМЬ, с помо¬ 
щью которого можно было бы имитировать действие элемента <сапѵаз>. Открытым 
проектом « ехріогегсапѵаз » (НИр://сойе.§ооё1е.сот/р/ехр1огегсапоа8) была выпуще¬ 
на библиотека, реализующая эту имитацию: достаточно подключить к веб-стра¬ 
нице единственный файл ехсапѵаз.]8 с программным кодом на языке ^ѵаЗсгірі, 
и броузер ІЕ будет вести себя так, как если бы он поддерживал элемент <сапѵаз>. 

Библиотека ехсапѵа,8.]8 может служить ярким примером библиотеки обеспечения 
совместимости. Точно так же можно написать другие библиотеки, реализующие 
конкретные особенности. Методы массивов, введенные стандартом Б85 (раздел 7.9), 
такие как "ГогЕасМС), тар() и гесІисеО, с успехом можно реализовать в Е83, и добав¬ 
ляя соответствующую библиотеку к страницам, можно получить возможность ис¬ 
пользовать эти мощные методы как часть базовой платформы любого броузера. 

Однако иногда невозможно создать полноценную (или эффективную) реализа¬ 
цию особенности в броузерах, не поддерживающих ее. Как уже упоминалось, 
ІЕ - единственный броузер, который не реализует стандартный АРІ обработки 
событий, включая метод асісіЕѵепі:І_і5І:епег() регистрации обработчиков. Броузер 
ІЕ поддерживает похожий метод с именем а!ІасНЕѵепі( ). Однако метод а11асНЕѵепі( ) 
не такой мощный, как ас№Еѵеп1:І_і5І:епег(), и в действительности не существует 
очевидного способа реализовать все стандартные методы на основе возможно¬ 
стей, предоставляемых броузером ІЕ. Вместо этого разработчики иногда опреде¬ 
ляют компромиссный метод обработки событий - часто давая ему имя ас!сіЕѵепі:( ) - 
который переносимым способом может использовать либо асісіЕѵепі:І_і5І:епег(), ли¬ 
бо а!1асИЕѵепі(). Затем они пишут свой программный код, использующий метод 
ас№Еѵепі:() вместо асісіЕѵеп1:І_і5І:епег() или а1іасйЕѵеп1(). 

На деле многие веб-разработчики в своих веб-страницах используют фреймворки 
на языке ЛѵаЗсгірі, такие как і(}иегу (описывается в главе 19). Одна из функций, 
которая делает эти фреймворки такими необходимыми, - определение нового кли¬ 
ентского прикладного интерфейса, совместимого со всеми броузерами. В зС^иегу, 
например, регистрация обработчиков событий выполняется с помощью метода 
Ыпс1(). Если вы начнете использовать іС^иегу во всех своих разработках, вам нико¬ 
гда не придется задумываться о несовместимости методов асісіЕѵеп 1 :І_і 5 І:епег() и аі:- 
*асНЕѵеп!(). Подробнее о клиентских фреймворках рассказыватся в разделе 13.7. 

13.4.2. Классификация броузеров 

Классификация броузеров - это прием тестирования и оценки качества, введен¬ 
ный и отстаиваемой компанией УаЬоо!, который привносит определенную долю 
здравомыслия в иначе неуправляемое разрастание вариантов броузеров разных 
версий от разных производителей и для разных операционных систем. В двух 
словах, классификация возможностей броузеров подразумевает выделение на ос- 
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нове тестирования броузеров категории «А», которые обеспечивают полную под¬ 
держку всех возможностей, и менее мощных броузеров категории «С». Броузеры 
категории * А» получают полнофункциональные веб-страницы, а броузеры катет 
гории 4сС» — минимальные НТМЬ-версии страниц, в которых не используются 
сценарии ЛѵаВсгірі и каскадные таблицы стилей С88. Броузеры, которые не мо¬ 
гут быть отнесены к категории «А» или «С», попадают в категорию «X»: обычно 
это совершенно новые или особенно редкие броузеры. Считается, что броузеры 
этой категории обеспечивают полную поддержку всех возможностей, и они полу¬ 
чают полнофункциональные веб-страницы, однако официально они не поддер¬ 
живаются и не тестируются. 

Подробности о системе классификации возможностей броузеров, используемой 
компанией ѴаЬоо!, можно найти на странице Мір://<іеѵеІорег.уакоо.сот/уиі/агііс- 
Іез/ёЪз. На этой же странице приводится текущий список броузеров, включенных 
компанией УаЬоо! в категории «А» и «С» (этот список обновляется ежекварталь¬ 
но). Даже если вы не собираетесь использовать прием классификации броузеров, 
список броузеров категории * А» может пригодиться для определения, какие бро¬ 
узеры являются текущими и занимают значительную долю рынка. 

13.4.3. Проверка особенностей 

Проверка особенностей (иногда называемая проверкой функциональных возмож¬ 
ностей) - это очень мощная методика, позволяющая справиться с проблемами 
несовместимости. Особенность, или функциональная возможность, которую вы 
собираетесь использовать, может поддерживаться не всеми броузерами, поэтому 
необходимо включать в свои сценарии программный код, который будет прове¬ 
рять факт поддержки данной особенности. Если требуемая особенность не под¬ 
держивается на текущей платформе, то можно либо не использовать эту особен¬ 
ность на данной платформе, либо разработать альтернативный программный 
код, одинаково работоспособный на всех платформах. 

В следующих главах вы часто будете видеть, что та или иная особенность прове¬ 
ряется снова и снова. Например, в главе 17 приводится программный код, кото¬ 
рый выглядит, как показано ниже: 

іі (еіетепі:. асШЕѵеп 1 :І_і 5 І:епе г) { // Проверить наличие метода Ѵл/ЗС перед вызовом 
еіетепи . ас!с1Еѵеп1:Ііз1:епег( ” кеусіоѵѵп" , ПапсЛег, Іаізе); 
еіетепі. асЮЕѵепІ: І_із1:епе г ("кеургезз", ПапсЛег, Шзе); 

} 

еізе іі (еіетепі:. аІІасНЕѵепІ:) { // Проверить наличие метода ІЕ перед вызовом 
еіетепі. аІІасНЕѵепК "опкеуйомп" , ПапсЛег ); 
еіетепі. аіІасНЕѵепІ("опкеургезз", ІгапсЛег); 

} 

еізе { // В противном случае использовать универсальный прием 
еіетепі. опкеускмп = еіетепі:. опкеургезз = ПапсЛег; 

} 

Самое главное, что дает проверка особенностей, - программный код, который не 
привязан к конкретным броузерам или их версиям. Этот прием работает со всеми 
броузерами, существующими ныне, и должен продолжить работать с будущими 
версиями броузеров независимо от того, какой набор особенностей они реализу¬ 
ют. Это означает, что производители броузеров должны определять свойства и ме- 
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тоды, обладающие полной функциональностью. Если бы корпорация Місговоіі 
определила метод асісіЕѵепі:1_ізі:епег(), реализовав спецификации ^УЗС лишь час¬ 
тично, это привело бы к нарушениям работоспособности большого числа сценаі 
риев, в которых перед вызовом асісіЕѵеп1:І_і5І:епег() реализован механизм проверки 
особенностей. 

13.4.4. Режим совместимости и стандартный режим 

Когда корпорация Місгозо?! выпустила броузер ІЕ6, в него была добавлена под¬ 
держка некоторых стандартных особенностей С88, которые не поддерживались 
в ІЕ5. Однако чтобы обеспечить обратную совместимость с существующими веб¬ 
страницами, в нем было реализовано два режима отображения. В «стандартном 
режиме», или в «режиме совместимости с С88», броузер следует стандартам С88. 
В «режиме совместимости» броузер проявляет нестандартное поведение, свойст¬ 
венное версиям ІЕ4 и ІЕ5. Выбор режима отображения зависит от объявления 
йОСТУРЕ в начале НТМЬ-файла. Страницы, вообще не имеющие объявления ООСТУРЕ 
и страницы с определенными объявлениями типа документа, типичными в эру 
использования ІЕ5, отображаются в режиме совместимости. Страницы со стро¬ 
гими объявлениями типа документа (или, для совместимости снизу вверх, с не¬ 
распознаваемыми объявлениями типа документа) отображаются в стандартном 
режиме. Страницы с объявлением, определяемым стандартом НТМЬб (<! ООСТУРЕ 
И1:т1>), отображаются в стандартном режиме во всех современных броузерах. 

Такое различие между режимом совместимости и стандартным режимом прошло 
проверку временем. Новые версии ІЕ по-прежнему реализуют его, как и другие 
современные броузеры, и существование этих двух режимов было узаконено спе¬ 
цификацией НТМЬб. Различия между режимом совместимости и стандартным 
режимом обычно имеют значение только для тех, кто пишет НТМЬ- и С88-код. 
Однако иногда клиентским сценариям на языке ЛѵаЗсгірі бывает необходимо 
определить, в каком режиме отображается документ. Определить режим отобра¬ 
жения можно с помощью свойства йоситепТ.сотраТМойе. Если оно имеет значение 
«С881Сотраі», документ отображается в стандартном режиме. Если оно имеет 
значение «ВаскСотраі» (или ипсіе^іпесі, если такое свойство вообще не существу¬ 
ет), документ отображается в режиме совместимости. Все современные броузеры 
реализуют свойство сотраііМосіе, и оно стандартизовано спецификацией НТМЬб. 

На практике необходимость проверять свойство сотраііМосіе возникает редко. Тем 
не менее в примере 15.8 демонстрируется один из случаев, когда эта проверка дей¬ 
ствительно необходима. 

13.4.5. Проверка типа броузера 

Методика проверки особенностей прекрасно подходит для определения поддер¬ 
живаемых функциональных возможностей броузера. Ее можно использовать, на¬ 
пример, чтобы выяснить, какая модель обработки событий поддерживается, ѴУЗС 
или ІЕ. В то же время иногда может потребоваться обойти те или иные ошибки, 
свойственные конкретному типу броузеров, когда нет достаточно простого спосо¬ 
ба определить наличие этих ошибок. В этом случае бывает необходимо разрабо¬ 
тать программный код, который должен выполняться только в броузерах опреде¬ 
ленного производителя, определенного номера версии или в конкретной операци¬ 
онной системе (либо в некоторой комбинации всех трех признаков). 
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На стороне клиента сделать это можно с помощью объекта Маѵідаііог, о котором 
рассказывается в главе 14. Программный код, который определяет производите¬ 
ля и версию броузера, часто называют анализатором броузера (Ъгошзег зпі{{ег ) 
или анализатором клиента (< сііепі зпіЦег). Простой анализатор такого типа при¬ 
водится в примере 14.3. Методика определения типа клиента широко использо¬ 
валась на ранних этапах развития Всемирной паутины, когда Кеівсаре и 1Б име¬ 
ли серьезные отличия и были несовместимы. Ныне ситуация с совместимостью 
стабилизировалась, и анализ типа клиента утратил свою актуальность и прово¬ 
дится лишь в тех случаях, когда это действительно необходимо. 

Примечательно, что определение типа клиента может быть выполнено также на 
стороне сервера, благодаря чему веб-сервер на основе строки идентификации бро¬ 
узера, которая передается серверу в заголовке Узег-Адепі:, может выяснить, какой 
Лѵа8сгірі-код требуется отсылать. 

13.4.6. Условные комментарии в Іітіегпеі Ехріогег 

На практике вы можете обнаружить, что большинство несовместимостей, кото¬ 
рые необходимо учитывать при разработке клиентских сценариев, обусловлены 
спецификой броузера 1Б. Вследствие этого иногда возникает необходимость соз¬ 
давать программный код отдельно для ІБ и отдельно для всех остальных броузе¬ 
ров. Броузер ІБ поддерживает нестандартную возможность создания условных 
комментариев (эта возможность появилась в ІЕ5) в Лѵа8сгірІ-коде, что может 
оказаться полезным для решения проблем несовместимости. 

В следующем примере демонстрируется, как выглядят условные комментарии 
в НТМЬ. Примечательно, что вся хитрость заключается в комбинации символов, 
закрывающих комментарий. 

<! —[ Н ІЕ 6]> 

Эти строки фактически находятся внутри НТМІ_- комментария. 

Они будут отображаться только в ІЕ6. 

<! [епсІН]--> 

<!— [Н Не ІЕ 7]> 

Эта строка будет отображена только в IЕ 5. 6, 7 и в более ранних версиях. 

Не обозначает "Іезз Нап о г едііаі" (меньше или равно). Можно также использовать "И", 
"дГ' и "діе”. 

<! [епбН]--> 

<!-[Н ! ІЕ]> <-> 

Это обычное НТМІ_-содержимое, но ІЕ не будет отображать его 
из-за комментариев, что расположены выше и ниже. 

<! --> <! [епб:Н]--> 

Это обычное содержимое, которое будет отображаться всеми броузерами. 

В качестве более конкретного примера возьмем библиотеку ехсапѵаз.із, о которой 
выше говорилось, что она реализует поддержку элемента <сапѵаз> в Іпіегпеі Ехр¬ 
іогег. Поскольку эта библиотека требуется, только когда веб-страница отобража¬ 
ется в ІЕ (и работает только в ІЕ), есть смысл оформлять ее подключение внутри 
условного комментария, чтобы другие броузеры даже не загружали ее: 

<!--[Н ІЕ]><зсгір1: згс=”ехсапѵаз. зз”></зс гірі:>< ! [епбН]--> 
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Условные комментарии также поддерживаются интерпретатором ЛѵаЗсгірі в ІБ. 
Программисты, знакомые с языком С/С++, найдут их похожими на инструкции 
препроцессора #іГсіеГ/#епсііГ. Условные ЛѵаЗсгірі-комментарии в ІЕ начинаются 
с комбинации символов /*@сс_оп и завершаются комбинацией @*/« (Префиксы 
«сс» и «сс_рп» происходят от фразы «сопсііііоп сотрііаііоп», т. е. «условная ком¬ 
пиляция».) Следующий условный комментарий содержит программный код, ко¬ 
торый будет выполняться только в ІБ: 

/*@сс_оп 
@ІГ (@_]зсгір1:) 

// Следующий код находится внутри ^-комментария, но ІЕ выполнит его. 
а1егі("Іп ІЕ”); 

@епс) 

@*/ 

Внутри условных комментариев могут указываться ключевые слова @ІГ, @е1зе 
и @епсі, предназначенные для отделения программного кода, который должен вы¬ 
полняться интерпретатором ЛѵаЗсгірі в ІЕ по определенному условию. В боль¬ 
шинстве случаев вам достаточно будет использовать показанное в предыдущем 
фрагменте условие @ІГ (@_]5сгір1:). ^сгірі- это название интерпретатора Лѵа- 
Всгірі, которое было дано ему в МісгозоЛ, а переменная @_]зсгірі: в ІЕ всегда име¬ 
ет значение *ще. 

При грамотном чередовании условных и обычных ^ѵаЗсгірі-комментариев можно 
определить, какой блок программного кода должен выполняться в ІЕ, а какой - 
во всех остальных броузерах: 

/*@сс_оп 
©Н (@_3 зсгірі: ) 

// Этот блок кода находится внутри условного комментария, 

// который также является обычным ЭаѵаЗсгірІі-комментарием. 

// В ІЕ этот блок будет выполнен, а в других броузерах - нет. 
а1ег(('Вы пользуетесь Іпіегпеі Ехріогег'); 

@е1зе*/ 

// Этот блок уже не находится внутри ЭаѵаЗсгірІі-комментария, 

// но по-прежнему находится внутри условного комментария ІЕ. 

// Вследствие этого данный блок кода будет выполнен всеми броузерами, кроме ІЕ. 
аіе гі: (* Вы не пользуетесь Іпіегпеі Ехріогег'); 

Л@епР 

@*/ 


13.5. Доступность 

Всемирная паутина представляет собой замечательный инструмент распростра¬ 
нения информации, и ЛѵаЗсгірі-сценарии могут сделать эту информацию мак¬ 
симально доступной. Однако ЛѵаЗсгірі-программисты должны проявлять осто¬ 
рожность: слишком просто написать такой Лѵа8сгірі-код, который сделает не¬ 
возможным восприятие информации для пользователей с ограниченными воз¬ 
можностями. 

Пользователи с ослабленным зрением применяют такие «вспомогательные тех¬ 
нологии», как программы чтения с экрана, когда слова, выводимые на экран, 
преобразуются в речевые аналоги. Некоторые программы чтения с экрана спо- 
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собны распознавать Лаѵа8сгірі-код, другие лучше работают, когда поддержка Ла- 
ѵаВсгірі отключена. Если вы разрабатываете сайт, который требует выполнения 
Лѵа8сгірі-кода на стороне клиента для отображения информации, вы ограничив 
ваете доступность своего сайта для пользователей подобных программ чтения 
с экрана. (И ограничиваете тех, кто преднамеренно отключил поддержку Лѵа- 
8сгірі в броузере.) Главная цель ЛѵаЗсгірі заключается в улучшении представ¬ 
ления информации, а не собственно в ее представлении. Основное правило приме¬ 
нения ЛѵаЗсгірі заключается в том, что веб-страница, в которую встроен ^ѵа- 
8сгірі-код, должна оставаться работоспособной (хотя бы ограниченно), даже ко¬ 
гда интерпретатор ЛѵаЗсгірі отключен. 

Другое важное замечание относительно доступности касается пользователей, ко¬ 
торые могут работать с клавиатурой, но не могут (или не хотят) применять указы¬ 
вающие устройства, такие как мышь. Если программный код ориентирован на 
события, возникающие от действий мышью, вы ограничиваете доступность стра¬ 
ницы для тех, кто не пользуется мышью. Веб-броузеры позволяют задействовать 
клавиатуру для перемещения по веб-странице и выполнять операции с элемента¬ 
ми графического интерфейса в них, то же самое должен позволять делать и ваш 
Лѵа8сгірі-код. Как демонстрируется в главе 17, наряду с поддержкой событий, 
зависящих от типа устройства, таких как оптоизеоѵег или оптоизейсмп, ЛѵаЗсгірі 
обладает поддержкой событий, не зависящих от типа устройства, таких как 
огѵРосиз и опсМапде. Для достижения максимальной доступности следует отдавать 
предпочтение событиям, не зависящим от типа устройства. 

Создание максимально доступных веб-страниц - нетривиальная задача, а обсуж¬ 
дение проблем обеспечения доступности выходит за рамки этой книги. Разработ¬ 
чики веб-приложений, для которых проблемы доступности имеют немаловажное 
значение, должны ознакомиться со стандартами ДѴАІ-АКІА (ЛѴеЬ АссеззіЬіІііу 
Іпіііаііѵе - АссеззіЫе КісЬ Іпіегпеі Арріісаііопз) Нир://іѵіѵіѵ.іѵ3.огё/М^АІ/іпіго/агіа. 

13.6. Безопасность 

Наличие интерпретаторов ЛѵаЗсгірі в веб-броузерах означает, что загружаемая 
веб-страница может вызвать на выполнение произвольный Лѵа8сгірі-код. Это 
требует обеспечения надлежащей безопасности, и производители броузеров при¬ 
лагают немалые усилия для достижения двух противоречивых целей: 

• Реализовать мощный прикладной программный интерфейс на стороне клиен¬ 
та, позволяющий писать полезные веб-приложения. 

• Воспрепятствовать злонамеренному программному коду читать или изменять 
персональные данные пользователя, получать доступ к конфиденциальным 
данным, обманывать пользователя или тратить его время. 

Как и во многих других областях, обеспечение безопасности в ЛѵаЗсгірі пред¬ 
ставляет собой непрерывный процесс обнаружения и решения проблем. В самом 
начале развития Всемирной паутины в броузеры была добавлена возможность от¬ 
крывать и перемещать окна, изменять их размеры и выводить произвольный текст 
в строке состояния броузера. Когда недобросовестные рекламодатели и жулики 
начали злоупотреблять этой возможностью, производители броузеров начали ог¬ 
раничивать или вообще запрещать использование соответствующих функций. 
В настоящее время, работая над стандартом НТМЬб, производители броузеров 
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с осторожностью (открыто и совместно) отменяют некоторые давнишние ограни¬ 
чения, связанные с безопасностью и расширяют возможности клиентского Лаѵа- 
8сгірі, не добавляя (хотелось бы надеяться) новых дыр в системе безопасности. , 

В следующих подразделах рассматриваются ограничения Лаѵа8сгірі и проблемы 
безопасности, с которыми вы, как веб-разработчик, должны быть знакомы. 

13.6.1. Чего не может іаѵаБсгір* 

Броузеры - это первая линия обороны против злонамеренного кода, поэтому они 
просто не поддерживают некоторые функциональные возможности. Например, 
клиентский ЛаѵаЗсгірі не предоставляет никакого способа записи или удаления 
файлов и каталогов на клиентском компьютере. То есть программа на языке 
ЛаѵаЗсгірі не может удалить данные или установить вирус. (Тем не менее в раз¬ 
деле 22.6.5 вы узнаете, как на языке Лаѵа8сгірі реализовать чтение файлов, вы¬ 
бранных пользователем, а в разделе 22.7 - как настроить безопасную частную фай¬ 
ловую систему, в пределах которой программы на языке ЛаѵаЗсгірі смогут рабо¬ 
тать с файлами.) 

Аналогично клиентский ЛаѵаЗсгірі не имеет универсальных механизмов сетевых 
взаимодействий. Клиентский сценарий на языке Лаѵа8сгірі может управлять 
протоколом НТТР (как описывается в главе 18). А другой стандарт, примыкаю¬ 
щий к стандарту НТМЬб, известный как АѴеЬЗоскеіз, определяет прикладной 
программный интерфейс, напоминающий сокеты, позволяющий взаимодейство¬ 
вать со специализированными серверами. Но ни один из этих интерфейсов не по¬ 
зволяет получить непосредственный доступ к сети. На клиентском ЛаѵаЗсгірі 
нельзя написать программу универсального сетевого клиента или сервера. 

Вторая линия обороны против злонамеренного программного кода - это наложе¬ 
ние ограничений на некоторые поддерживаемые функциональные возможности. 
Ниже перечислены некоторые ограничения: 

• ЛѵаЗсгірі-программа может открыть новое окно броузера, но из-за того, что 
многие рекламодатели злоупотребляют этой возможностью, большинство бро¬ 
узеров позволяют ограничить эту возможность так, чтобы всплывающие окна 
могли появиться только в ответ на действия пользователя, такие как щелчок 
мыши. 

• ЛаѵаЗсгірі-программа может закрыть окно броузера, открытое ею же, но она 
не может закрыть другое окно без подтверждения пользователя. 

• Свойство ѵаіие НТМЬ-элемента Рііеиріоасі не может быть установлено программ¬ 
но. Если бы это свойство было доступно, сценарий мог бы установить его зна¬ 
чение равным любому желаемому имени файла и заставить форму выгрузить 
на сервер содержимое любого указанного файла (например, файла паролей). 

• Сценарий не может прочитать содержимое документов с других серверов, от¬ 
личных от сервера, откуда был получен документ с данным сценарием. Анало¬ 
гичным образом сценарий не может зарегистрировать обработчики событий 
в документах, полученных с других серверов. Это предотвращает возмож¬ 
ность подсматривания данных, вводимых пользователем (таких как комбина¬ 
ции символов, составляющих пароль) в других страницах. Это ограничение 
известно как политика общего происхождения (зате-огіёіп роіісу ) и более под¬ 
робно описывается в следующем разделе. 
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Обратите внимание, что это далеко не полный список ограничений, имеющихся 
в клиентском ЛѵаЗсгірі. Различные броузеры используют различные стратегии 
безопасности и могут накладывать различные ограничения. Кроме того, некото* 
рые броузеры могут также предоставлять возможность ужесточать или ослаб¬ 
лять ограничения с помощью пользовательских настроек. 

13.6.2. Политика общего происхождения 

Политикой общего происхождения называется радикальное ограничение, связан¬ 
ное с безопасностью, накладываемое на веб-содержимое, с которым может взаимо¬ 
действовать Лѵа8сгірі-код . Обычно политика общего происхождения вступает 
в игру, когда веб-страница содержит элементы <і1тате> или открывает другие окна 
броузера. В этом случае политика общего происхождения ограничивает возмож¬ 
ность Лѵа8сгірі-кода в одном окне взаимодействовать с содержимым в других 
окнах и фреймах. В частности, сценарий может читать только свойства окон и до¬ 
кументов, имеющих общее с самим сценарием происхождение (о том, как исполь¬ 
зовать ЛѵаЗсгірі для работы с несколькими окнами и фреймами, рассказывает¬ 
ся в разделе 14.8). 

Происхождение документа определяется протоколом, именем хоста и номером 
порта ШІЬ-адреса, откуда был загружен документ. Документы, загружаемые 
с других веб-серверов, имеют другое происхождение. Документы, загруженные 
с разных портов одного и того же хоста, также имеют другое происхождение. На¬ 
конец, документы, загруженные по протоколу МИр:, по происхождению отлича¬ 
ются от документов, загруженных по протоколу мирз:, даже если загружены 
с одного и того же веб-сервера. 

Важно понимать, что происхождение самого сценария не имеет никакого отно¬ 
шения к политике общего происхождения: значение имеет происхождение доку¬ 
мента, в который встраивается сценарий. Предположим, что сценарий, храня¬ 
щийся на сервере А, включается (с помощью атрибута зге элемента <зсгір1:>) в веб¬ 
страницу, обслуживаемую сервером В. С точки зрения политики общего происхо¬ 
ждения будет считаться, что этот сценарий происходит с сервера В и он получит 
иметь полный доступ ко всему содержимому этого документа. Если этот сцена¬ 
рий откроет второе окно и загрузит в него документ с сервера В, он также будет 
иметь полный доступ к содержимому этого второго документа. Но если сценарий 
откроет третье окно и загрузит в него документ с сервера С (или даже с сервера А), 
в дело вступит политика общего происхождения и ограничит сценарий в доступе 
к этому документу. 

Политика общего происхождения на самом деле применяется не ко всем свойст¬ 
вам всех объектов в окне, имеющем другое происхождение, но она применяется 
ко многим из них, в частности, практически ко всем свойствам объекта Ооситепі. 
В любом случае можно считать, что любое окно или фрейм, содержащий доку¬ 
мент, полученный с другого сервера, для ваших сценариев будут закрыты. Если 
такое окно было открыто самим сценарием, он сможет закрыть его, но не может 
«заглянуть внутрь» окна. Кроме того, политика общего происхождения действу¬ 
ет при работе по протоколу НТТР с применением объекта ХМЬНИрРедиез! (гла¬ 
ва 18). Этот объект позволяет ЛѵаЗсгірі-сценариям, выполняющимся на стороне 
клиента, отправлять произвольные НТТР-запросы, но только тому веб-серверу, 
откуда был загружен документ, содержащий сценарий. 
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Политика общего происхождения необходима, чтобы не допустить хищение кон¬ 
фиденциальной информации. Без этого ограничения злонамеренный сценарий 
(возможно, загруженный в броузер, расположенный в защищенной брандмау¬ 
эром корпоративной сети) мог бы открыть пустое окно, в надежде обмануть поль¬ 
зователя и заставить его задействовать это окно для поиска файлов в локальной 
сети. После этого злонамеренный сценарий мог бы прочитать содержимое этого 
окна и отправить его обратно на свой сервер. Политика общего происхождения 
предотвращает возможность возникновения такого рода ситуаций. 

13.6.2.1. Ослабление ограничений политики 
общего происхождения 

В некоторых ситуациях политика общего происхождения оказывается слишком 
строгой. Поэтому в этом разделе описывается, как можно ослабить накладывае¬ 
мые ею ограничения. 

Политика общего происхождения создает определенные проблемы для крупных 
веб-сайтов, которые функционируют на нескольких серверах. Например, сцена¬ 
рий с сервера Ноте.ехатріе.сот мог бы на вполне законных основаниях читать 
свойства документа, загруженного с йеѵеіорег.ехатріе.сот , а сценариям с огйегз. 
ехатріе.сот может потребоваться прочитать свойства из документов с саіаіоц. 
ехатріе.сот. Для поддержки таких крупных веб-сайтов можно использовать 
свойство сіотаіп объекта Ооситепі:. По умолчанию свойство сіотаіп содержит имя 
сервера, с которого был загружен документ. Это свойство можно установить толь¬ 
ко равным строке, являющейся допустимым доменным суффиксом первоначаль¬ 
ного значения. Другими словами, если значение свойства сіотаіп первоначально 
было равно строке «Ноте.ехатріе.сот», то можно установить его равным «ехатр¬ 
іе.сот», но не «Ьоте.ехатріе» или «атріе.сот». Кроме того, значение свойства 
сіотаіп должно содержать, по крайней мере, одну точку, чтобы его нельзя было ус¬ 
тановить равным «сот» или другому имени домена верхнего уровня. 

Если два окна (или фрейма) содержат сценарии, установившие одинаковые значе¬ 
ния свойства сіотаіп, политика общего происхождения для этих двух окон ослаб¬ 
ляется, и каждое из окон может читать значения свойств другого окна. Напри¬ 
мер, взаимодействующие сценарии в документах, загруженных с серверов огйегз. 
ехатріе.сот и саіаІо§.ехатрІе.сот , могут установить свойства сіоситепі:.сіотаіп 
равными «ехатріе.сот», тем самым указывая на общность происхождения доку¬ 
ментов и разрешая каждому из документов читать свойства другого. 

Второй прием ослабления ограничений политики общего происхождения предпо¬ 
лагается стандартизовать под названием «Сговз-Огі&іп Кезоигсе 8Ьагіп&» ( Ыір :// 
іѵіѵіѵ.іѵЗ.огё/ТЕ/согз/). Этот проект стандарта дополняет протокол НТТР новым 
заголовком запроса Огідіп: и новым заголовком ответа Ассезз-Сопіго1-А11о\л/-0гідіп. 
Он позволяет серверам использовать заголовок для явного определения списка 
доменов, которые могут запрашивать файл, или использовать шаблонные симво¬ 
лы, чтобы обеспечить возможность получения файла любым сайтом. Броузеры, 
такие как Еігеічэх 3.5 и 8аі:агі 4, используют этот новый заголовок, чтобы разре¬ 
шить выполнение междоменных НТТР-запросов с использованием объекта ХМІ_- 
НіірРедиезі, которые иначе были бы невозможны из-за ограничений политики об¬ 
щего происхождения. 
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Еще один новый прием, известный как «обмен сообщениями между документа¬ 
ми» (сговв-боситепі тезза&іп&), позволяет сценарию из одного документа переда¬ 
вать текстовые сообщения сценарию в другом документе независимо от домена 
происхождения сценария. Вызов метода розі:Меззаде() объекта іл/іпсіом производит 
асинхронную отправку сообщения (получить которое можно в обработчике собы¬ 
тия оптеззаде) документу в этом окне. Сценарий в одном документе по-прежнему 
лишен возможности вызывать методы или читать свойства другого документа, но 
они могут безопасно взаимодействовать друг с другом, используя прием обмена 
сообщениями. Подробнее АРІ обмена сообщениями между документами рассмат¬ 
ривается в разделе 22.3. 

13.6.3. Взаимодействие с модулями расширения 
и элементами управления АсІіѵеХ 

Хотя в базовом языке Лѵа8сгірі и базовой объектной модели на стороне клиента 
отсутствуют средства для работы с сетевым окружением и файловой системой, ко¬ 
торые необходимы наихудшему злонамеренному программному коду, тем не менее 
ситуация не такая простая, как кажется на первый взгляд. Во многих броузерах 
Лѵа8сгірі-код используется как «механизм выполнения» других программных 
компонентов, таких как элементы управления АсііѵеХ (в ІЕ) и модули расшире¬ 
ния (в других броузерах). Самыми распространенными примерами являются мо¬ 
дули расширения, обеспечивающие поддержку ИавЬ и Лѵа, и они предоставляют 
в распоряжение клиентских сценариев дополнительные мощные возможности. 

Вопросы безопасности приобретают особую важность, когда речь заходит о пере¬ 
даче управления элементам АсііѵеХ и модулям расширения. Апплеты Лѵа, на¬ 
пример, могут иметь низкоуровневый доступ к сетевым возможностям. Защит¬ 
ная «песочница» для Лѵа не позволяет апплетам взаимодействовать с серверами, 
отличными от того, откуда они были получены; тем самым закрывается брешь 
в системе безопасности. Но остается основная проблема: если модуль расширения 
может управляться из сценария, необходимо полное доверие не только системе 
безопасности броузера, но и системе безопасности самого модуля расширения. На 
практике модули расширения ^ѵа и РІазЬ, похоже, не имеют проблем с безопас¬ 
ностью и не вызывают появление этих проблем в клиентских сценариях на языке 
ЛѵаЗсгірі. Однако элементы управления АсііѵеХ имеют более пестрое прошлое. 
Броузер ІЕ обладает возможностью доступа из сценариев к самым разным эле¬ 
ментам управления АсііѵеХ, которые являются частью операционной системы 
ДѴіп(іо>ѵ8 и которые раньше уже были источниками проблем безопасности. 

13.6.4. Межсайтовый скриптинг 

Термин межсайтовый скриптинг (сго88-8Ііе 8сгірііп&), или Х88, относится к об¬ 
ласти компьютерной уязвимости, когда атакующий внедряет НТМЬ-теги или сце¬ 
нарии в документы на уязвимом веб-сайте. Организация защиты от Х88-атак - 
обычное дело для веб-разработчиков, занимающихся созданием серверных сцена¬ 
риев. Однако программисты, разрабатывающие клиентские ^ѵаЗсгірі-сценарии, 
также должны знать о Х88-атаках и предпринимать меры защиты от них. 

Веб-страница считается уязвимой для Х88-атак, если она динамически создает 
содержимое документа на основе пользовательских данных, не прошедших пред¬ 
варительную обработку по удалению встроенного НТМЬ-кода. В качестве триви- 
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ального примера рассмотрим следующую веб-страницу, которая использует Л- 
ѵаЗсгірі-сценарий, чтобы приветствовать пользователя по имени: 

<зсгірі:> 

ѵаг пате = с!есосІеІ)РІСотропепі:(\л/іпсІо\л/.Іосаіііоп.зеагсМ.зиЬвІ;гіпд( 1)) || 

с!оситеп1:.\л/гіі:е( "Привет, " + пате); 

</зсгірі:> 

В этом двустрочном сценарии используется метод міпсісм. Іосаіііоп. зеагсМ. зиЬзШпд, 
с помощью которого извлекается часть адресной строки, начинающаяся с симво¬ 
ла ?. Затем с помощью метода сІоситеп1:.\л/гі1:е() добавляется динамически сгенери¬ 
рованное содержимое документа. Этот сценарий предполагает, что обращение 
к веб-странице будет производиться с помощью следующего ІІНЬ-адреса: 

ППрѴ/мѵм. ехатріе. сот/д гееі. П1:т1?пате=Давид 

В этом случае будет выведен текст «Привет, Давид». Но что произойдет, если 
страница будет запрошена с использованием следующего ГГКЬ-адреса: 

НПр://ѵмѵі/.ехатріе.сот/дгееі. П1т1?пате=%ЗСзсгірі:%ЗЕа1ег1:( 'Давид' )%ЗС/зсгір1:%ЗЕ 

С таким содержимым ІЖЬ-адреса сценарий динамически сгенерирует другой 
сценарий (коды %ЗС и %ЗЕ - это угловые скобки)! В данном случае вставленный сце¬ 
нарий просто отобразит диалоговое окно, которое не представляет никакой опас¬ 
ности. Но представьте себе такой случай: 

Пир: //зііеА/дгееі . П1:т1?пате=%ЗСзс гірі згс=зі1:еВ/еѵі1. ] з%ЗЕ%ЗС/зсгірі%ЗЕ 

Межсайтовый скриптинг потому так и называется, что в атаке участвует более 
одного сайта. Сайт В (или даже сайт С) включает специально сконструированную 
ссылку (подобную только что показанной) на сайт А, в которой содержится сцена¬ 
рий с сайта В. Сценарий еѵіІ.]8 размещается на сайте злоумышленника В, но те¬ 
перь этот сценарий оказывается внедренным в сайт А и может делать все, что ему 
заблагорассудится с содержимым сайта А. Он может стереть страницу или вы¬ 
звать другие нарушения в работе сайта (такие как отказ в обслуживании, о чем 
рассказывается в следующем разделе). Это может отрицательно сказаться на по¬ 
сетителях сайта А. Гораздо опаснее, что такой злонамеренный сценарий может 
прочитать содержимое соокіев, хранящихся на сайте А (возможно, содержащих 
учетные номера или другие персональные сведения), и отправить эти данные об¬ 
ратно на сайт В. Внедренный сценарий может даже отслеживать нажатия кла¬ 
виш и отправлять эти данные на сайт В. 

Универсальный способ предотвращения Х88-атак заключается в удалении НТМЬ- 
тегов из всех данных сомнительного происхождения, прежде чем использовать их 
для динамического создания содержимого документа. Чтобы исправить эту про¬ 
блему в показанном ранее файле ёгееі.МтпІ , нужно добавить следующую строку 
в сценарий, которая призвана удалять угловые скобки, окружающие тег <зсгір1:>: 

пате = пате. гер1асе(/</д, "Ш;"). гер1асе(/>/д, "&д*;"); 

Простейшая операция, представленная выше, заменит в строке все угловые скоб¬ 
ки на соответствующие им мнемоники языка НТМЬ, тем самым экранировав 
и деактивировав любые НТМЬ-теги, присутствующие в строке. ІЕ8 определяет 
более точный метод ІюЗіаііісНТМЦ ), который удаляет все теги <зсгір1:> (и любое дру¬ 
гое выполняемое содержимое) без изменения невыполняемой разметки НТМЬ. 
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Метод іо8*а*ісНТМІ_( ) не является стандартным, но для вас не составит труда само¬ 
стоятельно написать аналогичную функцию экранирования разметки НТМЬ на 
базовом ^ѵаВсгірі. 

Стандарт НТМЬб пошел еще дальше по пути развития стратегий защиты и опре¬ 
деляет атрибут запсЯэох в элементе <і1тате>. Когда этот атрибут будет реализован, 
он должен будет обеспечивать безопасное отображение непроверенного содержи¬ 
мого, автоматически запрещая выполнения сценариев, имеющихся в нем. 

Межсайтовый скриптинг представляет собой уязвимость, глубоко уходящую 
корнями в архитектуру Всемирной паутины. Вы должны осознавать всю глубину 
этой уязвимости, но дальнейшее ее обсуждение выходит далеко за рамки темы 
данной книги. В Интернете есть немало ресурсов, которые помогут вам организо¬ 
вать защиту от атак подобного рода. Наиболее важный из них принадлежит 
группе компьютерной «скорой помощи» СЕКТ Асіѵізогу: Ыір://іѵіѵшсегі.огё/айѵі- 
8Огіе8/СА-2000-02МтІ. 

13.6.5. Атаки типа отказа в обслуживании 

Политика общего происхождения и другие меры безопасности прекрасно защи¬ 
щают данные клиента от посягательств со стороны злонамеренного программно¬ 
го кода, но не могут предотвратить атак типа отказа в обслуживании. При посе¬ 
щении злонамеренного веб-сайта ваш броузер может получить Лѵа8сгірі-сцена- 
рий, который в бесконечном цикле вызывает метод а1ег1:(), выводящий диалого¬ 
вое окно или нагружающий центральный процессор компьютера бесконечным 
циклом с бессмысленными вычислениями. 

Некоторые типы броузеров автоматически определяют наличие циклов, выводя¬ 
щих диалоговые окна или имеющих продолжительное время работы, и предостав¬ 
ляют пользователю возможность прервать их. Но злонамеренный программный 
код для обхода этой защиты может использовать прием на основе метода зеПпІег- 
ѵа1( ), загружая процессор, а также атаковать систему клиента, вызывая огромный 
расход памяти. В веб-броузерах не существует универсального способа предот¬ 
вращения таких атак. На самом деле это не является распространенной пробле¬ 
мой Всемирной паутины, т. к. никто второй раз не посетит злонамеренный сайт! 

13.7. Клиентские фреймворки 

Многие веб-разработчики считают удобным конструировать свои веб-приложе- 
ния на основе библиотек клиентских фреймворков. Эти библиотеки являются 
«основой» в том смысле, что они создают новый, высокоуровневый прикладной 
интерфейс для клиентских сценариев, действующий поверх стандартного и соб¬ 
ственного АРІ веб-броузеров: приняв за основу какой-либо фреймворк, вам оста¬ 
ется только использовать определяемый им прикладной интерфейс в своем про¬ 
граммном коде. Одним из очевидных преимуществ использования фреймворков 
является высокоуровневый прикладной интерфейс, позволяющий выполнять 
больше операций за счет меньшего объема программного кода. Кроме того, доб¬ 
ротно выполненные фреймворки решают многие проблемы совместимости, без¬ 
опасности и доступности, описанные выше. 
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В главе 19 мы познакомимся с іСіиегу - одним из наиболее популярных фрейм- 
ворков. Если вы решите использовать іС^иегу в своих проектах, вам все равно же¬ 
лательно прочитать главы, предшествующие главе 19, - понимание низкоуровне; 
вых прикладных интерфейсов повысит ваш профессиональный уровень, даже 
если вам редко придется использовать эти интерфейсы. 

Помимо іСіиегу существует еще множество фреймворков на языке ЛѵаЗсгірі - их 
слишком много, чтобы перечислять здесь. Тем не менее ниже я перечислил неко¬ 
торые из наиболее известных и широко используемых фреймворков: 

Ргоіоіуре 

Как и іСіиегу, библиотека Ргоіоіуре ( кІір://ргоіоІуре]8.ог& г) основное внимание 
уделяет работе с БОМ и Азах и добавляет довольно много вспомогательных 
функций в базовый язык. В дополнение к ней можно добавить библиотеку 
8сгіріаси1оиз ( кіір://8Сгірі.асиІо.и8 /), которая реализует анимационные и ви¬ 
зуальные эффекты. 

Боу о 

Боіо (Ніір://йо]ОіооІкіі.огё) - это огромный фреймворк, имеющий «невероят¬ 
ную глубину*. Он включает обширный набор графических элементов пользо¬ 
вательского интерфейса, системный пакет, уровень абстракции данных и мно¬ 
гое другое. 

ѴШ 

УТЛ (кІір://<ІеѵеІорег.уакоо.сот/уиі/) - это библиотека, созданная компанией 
УаЬоо! для внутренних нужд и используемая ею в своих веб-страницах. По¬ 
добно ^о}о 9 это большая, всеохватывающая библиотека утилит и функций 
для работы с БОМ, виджетами и т. д. Существует две несовместимые версии, 
известные как УШ 2 и УТЛ 3. 

Сіозиге 

Библиотека Сіозиге (кіІр://со<іе.ёоо8Іе.сот/с108иге/ІіЪгагу/)- это клиентская 
библиотека, которую компания Соо&1е использует в своих веб-приложениях 
Стаіі, Ооо&іе Босз и в других. Эта библиотека предназначена для использова¬ 
ния совместно с компилятором Сіозиге (кіір://сосІе.ёооёІе.сот/с108иге/сотрі- 
Іег/) 9 который удаляет из библиотеки неиспользуемые функции. Благодаря 
тому, что перед развертыванием веб-приложения из него удаляется весь не¬ 
нужный программный код, создатели библиотеки Сіозиге избежали необхо¬ 
димости заботиться о ее компактности и добавили в библиотеку Сіозиге об¬ 
ширный набор утилит. 

<ЖТ 

САУТ, Соо&іе АУеЪ Тооікіі (кіір://сосІе.ёооёІе.сот/іѵеЫооІкіі/) 9 - это совершенно 
иной тип клиентских фреймворков. Он определяет прикладной интерфейс 
веб-приложений на языке Лѵа и предоставляет компилятор для преобразова¬ 
ния ^ѵа-программ в совместимые сценарии на клиентском ЛѵаЗсгірі. Фрейм¬ 
ворк САУТ используется в некоторых программных продуктах компании Со- 
о&іе, но не так широко, как библиотека Сіозиге. 
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В главе 13 был представлен объект іл/іпсіом и отмечена центральная роль, которую 
этот объект играет в клиентском ЛѵаВсгірі: объект Міпсісм является глобальным 
объектом для клиентских ЛѵаВсгірі-программ. В этой главе будут рассмотрены 
свойства и методы объекта Іл/іпсісм. Эти свойства определяют множество различ¬ 
ных АРІ, из которых лишь немногие имеют отношение к окну броузера, в честь 
которого этот объект получил имя Іл/іпсісм. В этой главе рассматриваются следую¬ 
щие темы: 

• В разделе 14.1 демонстрируется, как с помощью функций зе!Тітеои1:( ) и зеіііп- 
ІегѵаІО зарегистрировать собственную функцию для вызова в определенные 
моменты времени в будущем. 

• В разделе 14.2 описывается, как использовать свойство ІосаНоп, чтобы полу¬ 
чить ИНЬ-адрес текущего документа и загрузить новый документ. 

• В разделе 14.3 описывается свойство Мізііогу и демонстрируется, как переме¬ 
щаться взад и вперед по списку ранее посещавшихся страниц. 

• В разделе 14.4 демонстрируется, как использовать свойство паѵідаіог для по¬ 
лучения информации о производителе броузера и как использовать свойство 
зсгееп для определения размеров рабочего стола. 

• В разделе 14.5 демонстрируется, как выводить простые диалоги с текстовыми 
сообщениями, используя методы а1ег1:(), соп^ігт( ) и рготрі:( ), и как отображать 
диалоги с разметкой НТМЬ с помощью метода 5ііомМосІа10іа1од(). 

• В разделе 14.6 описывается, как регистрировать обработчик опеггог, который 
будет вызываться при появлении необработанных исключений. 

• В разделе 14.7 рассказывается о том, что идентификаторы и имена НТМЬ-эле- 
ментов используются в качестве свойств объекта Іл/іпсісм. 

• В самом длинном разделе 14.8 описывается, как открывать и закрывать окна 
броузера и как писать ^ѵа8сгірі-код, призванный взаимодействовать с не¬ 
сколькими окнами и фреймами. 
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14.1. Таймеры 

Функции зеТТітеоиТО и зеТІпТегѵаІО позволяют зарегистрировать функцию, ко; 
торая будет вызываться один или более раз через определенные интервалы време¬ 
ни. Это очень важные функции для клиентского ^ѵаВсгірі, и поэтому они были 
определены как методы объекта Іл/іпсісм, несмотря на то что являются универсаль¬ 
ными функциями, не выполняющими никаких действий с окном. 

Метод зеТТітеоиТ( ) объекта Іл/іпсісм планирует запуск функции через определенное 
число миллисекунд. Метод зеТТітеоиТО возвращает значение, которое может 
быть передано методу с1еагТітеоиТ( ), чтобы отменить запланированный ранее за¬ 
пуск функции. 

Метод зеІІпІегѵаІО похож на зеІТітеоиіО, за исключением того, что он автомати¬ 
чески заново планирует повторное выполнение через указанное количество мил¬ 
лисекунд: 

зеІІпІегѵаКирсІаІеСІоск, 60000); // Вызывать ырс!а1;еС1оск() через каждые 60 сек. 

Подобно зеІТітеоиіО, метод зеІІпІегѵаІО возвращает значение, которое может 
быть передано методу сіеагіпіегѵаіо, чтобы отменить запланированный запуск 
функции. 

В примере 14.1 определяется вспомогательная функция, которая ожидает ука¬ 
занный интервал времени, многократно вызывает указанную функцию и затем 
отменяет запланированные вызовы по истечении другого заданного интервала 
времени. Этот пример демонстрирует использование методов зеШтеоиШ, зеііп- 
ІегѵаІО и с1еагІп1егѵа1(). 

Пример 14.1. Вспомогательная функция для работы с таймером 

Л 

* Планирует вызов или вызовы функции ^() в будущем. 

* Ожидает перед первым вызовом зіагі миллисекунд, затем вызывает ^() 

* каждые іпіегѵаі миллисекунд и останавливается через зіагі+епсі миллисекунд. 

* Если аргумент іпіегѵаі указан, а аргумент епсі нет, повторяющиеся вызовы функции Т 

* никогда не прекратятся. Если отсутствуют оба аргумента, іпіегѵаі и епсі, 

* тогда функция { будет вызвана только один раз, через зіаг* миллисекунд. 

* Если указан только аргумент функция будет вызвана немедленно, как если бы 

* в аргументе зіагі: было передано число 0. Обратите внимание, что вызов іпѵокеО 

* не блокируется: она сразу же возвращает управление. 

*/ 

^ііпсііоп іпѵоке^, з*аг*. іпіегѵаі, епсі) { 

Н (!з*аг*) з*аг* = 0; //По умолчанию через 0 мс 

іТ (агдіітепіз. ІепдІИ <= 2) // Случай однократного вызова 

зе*Тітеоіі*(^. з*аг*); // Вызвать 1 раз через зіагі: мс. 

еізе { // Случай многократного вызова 

зеШтеоиК гереаі:, з*аг*); // Начать вызовы через з*аг* мс 
^ипсііоп гереаі: () { // Планируется на вызов выше 

ѵаг Н = зе*Іп*егѵа1(^, іпіегѵаі); // Вызывать Т через іпііегѵаі мс. 

// Прекратить вызовы через епсі мс, если значение епсі определено 
Н (епсі) 5е*Тітеои*(?ііпс*іоп() { сіеагіпііегѵаі(И); }, епсі); 

} 

} 

} 
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По исторически сложившимся причинам в первом аргументе методам зе1Тітеоіі1:( ) 
и зе1Іп*егѵа1() допускается передавать строку. В этом случае строка будет интер¬ 
претироваться (как с применением функции еѵа1()) через указанный интервал, 
времени. Спецификация НТМЬб (и все броузеры, кроме ІЕ) допускает передавать 
методам зеШтеоиШ и зеІІпіегѵаІО дополнительные аргументы после первых 
двух. Все эти дополнительные аргументы будут передаваться функции, вызов ко¬ 
торой планируется этими методами. Однако если требуется сохранить совмести¬ 
мость с ІЕ, эту возможность использовать не следует. 

Если методу зеІТітеоиіО указать величину интервала 0 миллисекунд, указанная 
функция будет вызвана не сразу, а «как только такая возможность появится», 
т. е. как только завершат работу все обработчики событий. 

14.2. Адрес документа и навигация по нему 

Свойство Іосаііоп объекта іл/іпсіом ссылается на объект І_оса1ііоп, представляющий 
текущий ІІНЬ-адрес документа, отображаемого в окне и определяющий методы, 
инициирующие загрузку нового документа в окно. 

Свойство Іосаіііоп объекта Ооситепі также ссылается на объект І_оса1ііоп: 
тпдоѵі. Іосаііоп === йосіішепі. Іосаііоп // всегда верно 

Кроме того, объект Ооситепі имеет свойство УНІ_, хранящее статическую строку 
с адресом ІЖЬ документа. При перемещении по документу с использованием 
идентификаторов фрагментов (таких как «#іаЫе-оі:-сопіепІ8») внутри документа 
объект ЬосаНоп будет обновляться, отражая факт перемещения, но свойство сіоси- 
тепіі.ині. останется неизменным. 

14.2.1. Анализ ІЖІ_ 

Свойство Іосаііоп окна является ссылкой на объект Іосаіііоп и представляет ІГОЬ- 
адрес документа, отображаемого в данный момент в текущем окне. Свойство \\геТ 
объекта Іосаіііоп - это строка, содержащая полный текст ІЖЬ-адреса. Метод 
ІоЗІгіпдО объекта Іосаіііоп возвращает значение свойства Мге'Г, поэтому в контек¬ 
стах, где неявно подразумевается вызов метода іоЗіігіпдО, вместо конструкции 
ІосаІііоп.ПгеІ 1 можно писать просто Іосаііоп. 

Другие свойства этого объекта, такие как ргоііосоі, Позі, Мозііпате, рогі, раіМпате, 
зеагсіі и ІіазМ, определяют отдельные части ІЖЬ-адреса. Они известны как свойст¬ 
ва «декомпозиции ІЖЬ» и также поддерживаются объектами І_іпк (которые соз¬ 
даются элементами <а> и <агеа> в НТМЬ-доку ментах). Полное описание объектов 
І-осаІіоп и І_іпк приводится в четвертой части книги. 

Свойства МазМ и зеагсіп объекта Іосаіііоп представляют особый интерес. Свойство 
МазИ возвращает «идентификатор фрагмента» из адреса ІЖЬ, если он имеется: 
символ решетки (#) со следующим за ним идентификатором. Свойство зеагсіі со¬ 
держит часть ІІКЬ-адреса, следующую за вопросительным знаком, если таковая 
имеется, включая сам знак вопроса. Обычно эта часть ІІКЬ-адреса является стро¬ 
кой запроса. В целом эта часть ІІНЬ-адреса используется для передачи парамет¬ 
ров и является средством встраивания аргументов в ІШЬ-адрес. Хотя эти аргу¬ 
менты обычно предназначены для сценариев, выполняющихся на сервере, нет 
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никаких причин, по которым они не могли бы также использоваться в страни¬ 
цах, содержащих Лаѵа8сгірі-код. В примере 14.2 приводится определение уни¬ 
версальной функции иг1Агд§(), позволяющей извлекать аргументы из свойства 
зеагсП ІШЬ-адреса. В примере используется глобальная функция сіесосІеІІВІСопіро- 
пепТО, имеющаяся в клиентском ЛаѵаЗсгірі. (Смотрите справочную статью «Сіо- 
ЬаЬ в третьей части книги.) 


Пример 14.2. Извлечение аргументов из строки зеагсН 17КЬ-адреса 


Эта функция выделяет в УРІ--адресе разделенные амперсандами 

пары аргументов имя/значение из строки запроса. Сохраняет эти пары 

в свойствах объекта и возвращает этот объект. Порядок использования: 


* ѵаг агдз = іігІАгдзО; // Извлечь аргументы из СІПЪ 

* ѵаг д = агдз.д || // Использовать аргумент, если определен, 

// или значение по умолчанию 

* ѵаг п = агдз.п ? рагзеІп1:(агдз. п) : 10; 


^цпсТіоп іігІАгдзО { 
ѵаг агдз = {}; 

ѵаг дьегу = 1осаііоп.зеагсИ.зьЬз1:гіпд(1); 
ѵаг раігз = дьегу. зрШ("&" ); 

^ог(ѵаг і = 0; і < раігз.ІепдТИ; і++) { 
ѵаг роз = раігз[і].іпРехОГ( 
іТ (роз == -1) сопііпье; 
ѵаг пате = раігз[і].зьЬз1:гіпд(0, роз); 
ѵаг ѵаіье = раігз[ і]. зиЬзІ: гіпд(роз+1); 
ѵаіііе = сІесосІеипІСотропепі: (ѵаіье); 
агдз[пате] = ѵаіье; 

} 

геТьгп агдз; 


// Создать пустой объект 
// Строка запроса без '?' 

// Разбить по амперсандам 
// Для каждого фрагмента 
// Отыскать пару имя/значение 
// Не найдено - пропустить 
// Извлечь имя 
// Извлечь значение 
// Преобразовать значение 
// Сохранить в виде свойства 

// Вернуть полученные аргументы 


} 


14.2.2. Загрузка нового документа 

Метод аззідп() объекта І_оса1:іоп заставляет окно загрузить и отобразить документ 
по указанному ІШЬ-адресу. Метод гер1асе() выполняет похожую операцию, но пе¬ 
ред открытием нового документа он удаляет текущий документ из списка посе¬ 
щавшихся страниц. Когда сценарию просто требуется загрузить новый документ, 
часто предпочтительнее использовать метод герІасеО, а не аззідп(). В противном 
случае кнопка Васк (Назад) броузера вернет оригинальный документ и тот же са¬ 
мый сценарий снова загрузит новый документ. Метод Іосаііоп. герІасеО можно 
было бы использовать для загрузки версии веб-страницы со статической размет¬ 
кой НТМЬ, если сценарий обнаружит, что броузер пользователя не обладает 
функциональными возможностями, необходимыми для отображения полноцен¬ 
ной версии: 

// Если броузер не поддерживает объект ХМІНіірПедьезІ:. выполнить 
// переход к статической странице, которая не использует его. 
і? (!ХМ1_НПрПедьез1:) Іосаііоп. герІасеС'зіаіісраде. ШтГ'); 
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Примечательно, что строка ІШЬ-адреса в этом примере, переданная методу 
гер1асе(), представляет относительный адрес. Относительные ІШЬ-адреса интер¬ 
претируются относительно страницы, в которой они появляются, точно так же, 
как если бы они использовались в гиперссылке. 

Кроме методов аззідп( ) и гер1асе() объект 1_осаіііоп определяет также метод геІоасК), 
который заставляет броузер перезагрузить документ. 

Однако более традиционный способ заставить броузер перейти к новой странице 
заключается в том, чтобы просто присвоить новый ІШЬ-адрес свойству Іосаіііоп: 

Іосаііоп = ' , Піір://ѵмѵ.огеі11у.сопГ; // Перейти, чтобы купить несколько книг! 

Свойству Іосаіііоп можно также присваивать относительные ІШЬ-адреса. Они 
разрешаются относительно текущего ІШЬ: 

Іосаіііоп = "раде2. Піті"; // Загрузить следующую страницу 

Идентификатор фрагмента - это особый вид относительного ІШЬ-адреса, кото¬ 
рый заставляет броузер просто прокрутить страницу, чтобы отобразить новый 
раздел, а не загружать новый документ. Идентификатор #іор имеет специальное 
назначение: если в документе отсутствует элемент с идентификатором «іор», он 
вынудит броузер перейти в начало документа: 

Іосаіііоп = "иііор"; // Перейти в начало документа 

Свойства декомпозиции ІШЬ объекта Іосаіііоп доступны для записи, и их измене¬ 
ние влечет за собой изменение ІШЬ-адреса в свойстве Іосаіііоп и вынуждает бро¬ 
узер загрузить новый документ (или, в случае изменения свойства ИазИ, выпол¬ 
нить переход внутри текущего документа): 

Іосаііоп.зеагсП = "?раде=" + (радепііт+1 ); // загрузить следующую страницу 

14.3. История посещений 

Свойство Пізііогу объекта Ѵ\ііпРо\л/ ссылается на объект Нізіогу данного окна. Объект 
Нізіогу хранит историю просмотра страниц в окне в виде списка документов и све¬ 
дений о них. Свойство ІепдіР объекта Нізіогу позволяет узнать количество элемен¬ 
тов в списке, но по причинам, связанным с безопасностью, сценарии не имеют 
возможности получить хранящиеся в нем ІШЬ-адреса. (Иначе любой сценарий 
смог бы исследовать историю посещения веб-сайтов.) 

Методы Ьаск() и 1 = ог\л/агс1() действуют подобно кнопкам Васк (Назад) и РогѵѵагсІ (Вперед) 
броузера: они заставляют броузер перемещаться на один шаг назад и вперед по 
истории просмотра данного окна. Третий метод, до(), принимает целочисленный 
аргумент и пропускает заданное число страниц, двигаясь вперед (если аргумент 
положительный) или назад (если аргумент отрицательный) в списке истории. 

Нізіогу. до(-2); // Переход назад на 2 элемента, как если бы пользователь 

// дважды щелкнул на кнопке Васк (Назад) 

Если окно содержит дочерние окна (такие как элементы <і1тате> - подробности 
смотрите в разделе 14.8.2), истории посещений в дочерних окнах хронологически 
чередуются с историей посещений в главном окне. То есть вызов Иізііогу. Ьаск() (на¬ 
пример) в главном окне может вызвать переход назад, к ранее отображавшемуся 
документу, в одном из дочерних окон, оставив главное окно в текущем состоянии. 




374 


Глава 14. Объект ѴѴіпсІоѵѵ 


Современные веб-приложения способны динамически изменять содержимое стра¬ 
ницы без загрузки нового документа (примеры приводятся в главах 15 и 18). При¬ 
ложениям, действующим подобным образом, может потребоваться предоставить 
пользователям возможность использовать кнопки Васк и РогѵѵагсІ для перехода меж¬ 
ду этими динамически созданными состояниями приложения. Стандарт НТМЬб 
определяет два способа реализации, и оба они описываются в разделе 22.2. 

Управление историей посещений до появления стандарта НТМЬб представляло 
собой довольно сложную задачу. Приложение, управляющее собственной истори¬ 
ей, должно было создавать новые записи в списке истории окна, связывать эти за¬ 
писи с информацией о состоянии, определять момент щелчка на кнопке Васк, что¬ 
бы перейти к другой записи в списке, получать информацию, связанную с этой 
записью и воссоздавать предыдущее состояние приложения в соответствии с этой 
информацией. Один из приемов реализации такого поведения опирается на ис¬ 
пользование скрытого элемента <іГгате>, в котором сохраняется информация о со¬ 
стоянии и создаются записи в списке истории просмотра. Чтобы создать новую 
запись, в этот скрытый фрейм динамически записывается новый документ, с по¬ 
мощью методов ореп() и мгі1:е( ) объекта йоситепі: (раздел 16.10.2). Документ должен 
включать всю информацию, необходимую для воссоздания соответствующего со¬ 
стояния приложения. Когда пользователь щелкнет на кнопке Васк, содержимое 
скрытого фрейма изменится. До появления стандарта НТМЬб не предусматрива¬ 
лось никаких событий, которые извещали бы об этом изменении, поэтому, чтобы 
определить момент щелчка на кнопке Васк, приходилось использовать функцию 
зеІІпІегѵаІО (раздел 14.1) и с ее помощью 2-3 раза в секунду проверять наличие 
изменений в скрытом фрейме. 

Однако на практике разработчики, когда требуется реализовать подобное управ¬ 
ление историей просмотра, предпочитают использовать готовые решения. Мно¬ 
гие фреймворки ЛѵаЗсгірі включают такие решения. Например, для библиоте¬ 
ки зСіиегу существует расширение Ьізіогу. Существуют также автономные биб¬ 
лиотеки управления историей. Например, одной из наиболее популярных явля¬ 
ется библиотека К8Н (Кеаііу 8ітр1е Нізіогу - действительно простое управление 
историей). Найти ее можно по адресу кіір://соёе.ёооёІе.сот/р/геаІІу8ітрІекШогу/. 
В разделе 22.2 описывается, как реализуется управление историей в НТМЬб. 

14.4. Информация о броузере и об экране 

Иногда сценариям бывает необходимо получить информацию о веб-броузере, 
в котором они выполняются, или об экране, на котором отображается броузер. 
В этом разделе описываются свойства паѵідаіюг и зсгееп объекта Міпсісм. Эти свой¬ 
ства ссылаются, соответственно, на объекты Маѵідаіог и Зсгееп, содержащие ин¬ 
формацию, которая дает возможность подстроить поведение сценария под суще¬ 
ствующее окружение. 

14.4.1. Объект Маѵідаіог 

Свойство паѵідаіюг объекта Міпйсм ссылается на объект Маѵідаіюг, содержащий об¬ 
щую информацию о номере версии и о производителе броузера. Объект Маѵіда1:ог 
назван «в честь» броузера Кеізсаре Каѵі^аіог, но он также поддерживается во 
всех других броузерах. (Кроме того, ІЕ поддерживает свойство с1іепі;ІпГогтаі:іоп 
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как нейтральный синоним для паѵідаіог. К сожалению, другие броузеры свойство 
с таким именем не поддерживают.) 

В прошлом объект №ѵіда1:ог обычно использовался сценариями для определений 
типа броузера - Іпіегпеі Ехріогег или Кеізсаре. Однако такой подход к опреде¬ 
лению типа броузера сопряжен с определенными проблемами, т. к. требует по¬ 
стоянного обновления с появлением новых броузеров или новых версий сущест¬ 
вующих броузеров. Ныне более предпочтительным считается метод на основе 
проверки функциональных возможностей (раздел 13.4.3). Вместо того чтобы де¬ 
лать какие-либо предположения о броузерах и их возможностях, гораздо проще 
прямо проверить наличие требуемой функциональной возможности (например, 
метода или свойства). 

Однако иногда определение типа броузера может представлять определенную 
ценность. Один из таких случаев - возможность обойти ошибку, свойственную оп¬ 
ределенному типу броузера определенной версии. Объект Маѵідаіог имеет четыре 
свойства, предоставляющих информацию о версии работающего броузера, и вы 
можете использовать их для определения типа броузера: 

аррМате 

Название веб-броузера. В ІЕ это строка «Місгозоіі Іпіегпеі Ехріогег». В Гігеіох 
значением этого свойства является строка «Кеізсаре». Для совместимости с су¬ 
ществующими реализациями определения типа броузера значением этого 
свойства в других броузерах часто является строка «Кеізсаре». 

аррѴегзіоп 

Обычно значение этого свойства начинается с номера версии, за которым сле¬ 
дует другая информация о версии броузера и его производителе. Обычно в на¬ 
чале строки указывается номер 4.0 или 5.0, свидетельствующий о совмести¬ 
мости с четвертым или пятым поколением броузеров. Формат строки в свойст¬ 
ве аррѴегзіоп не определяется стандартом, поэтому невозможно организовать 
разбор этой строки способом, не зависящим от типа броузера. 

изегАдепі: 

Строка, которую броузер посылает в Ьіір-заголовке УЗЕР-АСЕМТ. Это свойство 
обычно содержит ту же информацию, что содержится в свойстве аррѴегзіоп, 
а также может включать дополнительные сведения. Как и в случае со свойст¬ 
вом аррѴегзіоп, формат представления этой информации не стандартизован. 
Поскольку это свойство содержит больше информации, именно оно обычно ис¬ 
пользуется для определения типа броузера. 

ріаі^огт 

Строка, идентифицирующая операционную систему (и, возможно, аппарат¬ 
ную платформу), в которой работает броузер. 

Сложность свойств объекта Маѵідаіог делает невозможной универсальную реали¬ 
зацию определения типа броузера. На раннем этапе развития Всемирной паути¬ 
ны было написано немало программного кода, зависящего от типа броузера, про¬ 
веряющего свойства, такие как паѵідаііог.аррМате. Создавая новые броузеры, про¬ 
изводители обнаружили, что для корректного отображения содержимого суще¬ 
ствующих веб-сайтов они должны устанавливать значение «Кеізсаре» в свойстве 
аррМате. По тем же причинам потерял свою значимость номер в начале значения 
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свойства аррѴегзіоп, и в настоящее время реализация определения типа броузера 
должна опираться на строку в свойстве паѵідаіог. изегАдепі:, имеющую более слож¬ 
ный формат, чем ранее. Пример 14*.3 демонстрирует, как с помощью регулярны* 
выражений (взятых из библиотеки і()иегу) можно получить из свойства паѵідаТог. 
изегАдепі: название броузера и номер версии. 

Пример 14.3. Определение типа броузера с помощью свойства паѵіёаіог.изегАёепІ 

// Определяет свойства Ьгомзег.пате и Ьгомзег. ѵегзіоп, позволяющие выяснить 
// тип клиента. За основу взят программный код из библиотеки зОііегу 1.4.1. 

// Оба свойства, пате и ѵегзіоп, возвращают строки, и в обоих случаях 
// значения могут отличаться от фактических названий броузеров и версий. 

// Определяются следующие названия броузеров: 

// 

// "ѵѵеЬкіІ:": ЗаТа гі или СИ готе: ѵегзіоп содержит номер сборки Іл/еЬКіІ 
// "орега": Орега; ѵегзіоп содержит фактический номер версии броузера 
// "тогіііа": Рігеі'ох или другие броузеры, основанные на механизме деско; 

// ѵегзіоп содержит номер версии Сеско 

// "тзіе": ІЕ; ѵегзіоп содержит фактический номер версии броузера 

// 

// Например, для РігеРох 3.6 возвращаются: {пате: " тогіііа", ѵегзіоп: "1.9.2"} 
ѵаг Ьгомзег = (РііпсііопС ) { 

ѵаг з = паѵідаіог. іізегАдепі.ІоІ_омегСазе(): 
ѵаг таісН = /(ѵѵеЬкіТ)[ \/]([\ѵѵ. ]+)/. ехес(з) || 

/(орега)(?:. *ѵегзіоп)?[ \/]([\ѵѵ. ]+)/.ехес(з) || 

/(тзіе) ([\м. ]+)/.ехес(з) || 

!/сотраііЫе/.1:ез1:(з) && /(тогі11а)(?:. *? гѵ: ([\м. ]+))?/. ехес(з) || 

[]; 

геііігп { пате: таісИ[1] || "", ѵегзіоп: таісИ[2] || "О" }; 

}()): 

В дополнение к свойствам с информацией о версии и производителе броузера, 
объект МаѵідаТог имеет еще несколько свойств и методов. В число стандартных 
и часто реализуемых нестандартных свойств входят: 

оШіпе 

Свойство паѵідаііог.опііпе (если существует) определяет, подключен ли броузер 
к сети. Приложениям может потребоваться сохранять информацию о состоя¬ 
нии локально (с использованием приемов, описываемых в главе 20), если бро¬ 
узер не подключен к сети. 

део1осаі:іоп 

Объект Сеоіосаіііоп, определяющий АРІ для выяснения географического поло¬ 
жения пользователя. Подробнее об этом рассказывается в разделе 22.1. 

]аѵаЕпаЫесі() 

Нестандартный метод, который должен возвращать 1:гие, если броузер спосо¬ 
бен выполнять Лаѵа-апплеты. 

соокіезЕпаЬІесіО 

Нестандартный метод, который должен возвращать іігие, если броузер спосо¬ 
бен сохранять соокіез. Если броузер настроен на сохранение соокіез только для 
определенных сайтов, этот метод может возвращать некорректное значение. 
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14.4.2. Объект Зсгееп 

Свойство зсгееп объекта Ѵ\ііпсіо\л/ ссылается на объект Зсгееп, предоставляющий ин; 
формацию о размере экрана на стороне пользователя и доступном количестве 
цветов. Свойства місИГі и НеідНІ: возвращают размер экрана в пикселах. Свойства 
аѵаіІЫісІііІі и аѵаіІНеідІтІ: возвращают фактически доступный размер экрана; из 
них исключается пространство, требуемое для таких графических элементов, 
как панель задач. Свойство соІогОерІИ возвращает количество битов на пиксел, 
определяющих цвет. Типичными значениями являются 16, 24 и 32. 

Свойство ѵѵ/іпсіоѵѵ/. зсгееп и объект Зсгееп, на который оно ссылается, являются не¬ 
стандартными, но они реализованы практически во всех броузерах. Объект Зсгееп 
можно использовать, чтобы определить, не выполняется ли веб-приложение на 
устройстве с маленьким экраном, таком как нетбук. При ограниченном простран¬ 
стве экрана, например, можно было бы использовать шрифты меньшего размера 
и маленькие изображения. 

14.5. Диалоги 

Объект Міпсіом обладает тремя методами для отображения простейших диалогов. 
Метод а1ег1:() выводит сообщение и ожидает, пока пользователь закроет диалого¬ 
вое окно. Метод соп1"ігт() предлагает пользователю щелкнуть на кнопке ОК или 
Сапсеі (Отмена) и возвращает логическое значение. Метод рготрТС) выводит сообще¬ 
ние, ждет ввода строки пользователем и возвращает эту строку. Ниже демонстри¬ 
руется пример использования всех трех методов: 

сіо { 

ѵаг пате = рготрТС"Введите ваше имя"); // Вернет строку 

ѵаг соггесі: = соп^ігтС'Вы ввели '" + пате + '".\п" + // Вернет логин, знач. 

"Щелкните ОК, чтобы продолжить, " + 

"или Отмена, чтобы повторить ввод."); 

} \л/Иі1е( ! соггесі ) 

а1егі( "Привет, " + пате); // Выведет простое сообщение 

Методы а1егі;(), сопІ'ігтО и рготрШ чрезвычайно просты в использовании, но пра¬ 
вила хорошего дизайна требуют, чтобы они применялись как можно реже. Диало¬ 
ги, подобные этим, нечасто используются в Веб, и большинство пользователей со¬ 
чтет диалоговые окна, выводимые этими методами, выпадающими из обычной 
практики. Единственный вариант, когда имеет смысл обращаться к этим мето¬ 
дам, - это отладка. ЛѵаЗсгірІ-программисты часто вставляют вызов метода а1егі:( ) 
в программный код, пытаясь диагностировать возникшие проблемы. 

Обратите внимание, что текст, отображаемый методами а1егі:( ), сопІ'ігтС ) и рготр1:() 
в диалогах, - это обычный неформатированный текст. Его можно форматировать 
только пробелами, переводами строк и различными знаками пунктуации. 

Методы сопІ'ігтО и рготрШ являются блокирующими , т.е. они не возвращают 
управление, пока пользователь не закроет отображаемые ими диалоговые окна. 1 
Это значит, что, когда выводится одно из этих окон, программный код прекраща¬ 
ет выполнение, и текущий загружаемый документ, если таковой существует. 


1 Обычно такие окна называют модальными. - Прим, науч . ред. 





378 


Глава 14. Объект ѴѴіпсІоѵѵ 


прекращает загружаться до тех пор, пока пользователь не отреагирует на запрос. 
В большинстве броузеров метод аІегТО также является блокирующим и ожидает 
от пользователя закрытия диалогового окна, но это не является обязательныя^ 
требованием. Полное описание этих методов приводится в справочных статьях 
Міпйсм.аіегі:, Міпйом.сопГігт и Міпсісил/.рготрі: в четвертой части книги. 

В дополнение к методам аІегіО, сопГігт() и рготр*() в объекте Міпсісм имеется более 
сложный метод, зИсмМосІаШаІодО, отображающий модальный диалог, содержа¬ 
щий разметку НТМЬ, и позволяющий передавать аргументы и получать возвра¬ 
щаемое значение. Метод зГюмМосіаІОіаІодО выводит модальный диалог в отдель¬ 
ном окне броузера. Первым аргументом методу передается ІШЬ, определяющий 
НТМЬ-содержимое диалога. Во втором аргументе может передаваться произ¬ 
вольное значение (допускается передавать массивы и объекты), которое будет 
доступно сценарию в диалоге, как значение свойства \л/іпс1о\ѵ. сІіаІодАгдитепііз. Тре¬ 
тий аргумент - нестандартный список пар имя/значение, разделенных точками 
с запятой, который, если поддерживается, может использоваться для настройки 
размеров и других атрибутов диалогового окна. Для определения размеров окна 
диалога можно использовать параметры «сІіаІоёѵшШі» и «сііаІо^Ьеі^М», а чтобы 
позволить пользователю изменять размеры окна, можно определить параметр 
«гезІ 2 аЫе=уез*. 

Окно, отображаемое эти методом, является модальным, и метод зИомМойаЮШодО 
не возвращает управление, пока окно не будет закрыто. После закрытия окна зна¬ 
чение свойства \л/іпс!о\ѵ.геІіигпѴаІие становится возвращаемым значением метода. 
Обычно разметка НТМЬ диалога должна включать кнопку О К, которая записывает 
желаемое значение в свойство геІигпѴаІиеивызываетміпсіоѵѵ.сІозеО (раздел 14.8.1.1). 

В примере 14.4 приводится разметка НТМЬ для использования с методом зПомМо- 
сіаШа1од(). Комментарий в начале примера включает пример вызова зНомМосіаІ- 
ОіаІодО, а на рис. 14.1 показан диалог, созданный вызовом из примера. Обратите 
внимание, что большая часть текста, отображаемого в диалоге, передается мето¬ 
ду зИо\л/Мос1а10іа1од() во втором аргументе, а не является жестко определенной ча¬ 
стью разметки НТМЬ. 
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Рис, 14,1, Диалог , отображаемый методом зНоіѵМо<іаШіаІоё( ) 
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Пример 14 А, НТМЬ-файл для использования с функцией 8НоюМойаЮіаІоё( ) 

<! — 

Это не самостоятельный НТМЬ-файл. Он должен вызываться методом зИо\ѵМос!а10іа1од( ) 
и ожидает получить в свойстве міпсіоѵу/. сііаІодАгдіітепіз массив строк. 

Первый элемент массива - строка, отображаемая в верхней части диалога. 

Все остальные элементы - метки для однострочных текстовых полей ввода. 

Возвращает массив значений полей ввода после щелчка на кнопке Окау. 

Этот файл используется следующим образом: 

ѵаг р = зЬомМосІаШаІодСтиШргогпрІ:. НТтГ', 

[■'ЕпТег 30 роіпТ соогйіпаіез", "х", "у", " 2 "], 

"сііаіодѵѵісіім :400; сІіаІодІгеідЫ: :300; гезііаЫеіуез*' ): 

<^огт> 

^іеісізеі: ісІ=" 1 : іе1сІз"></1 : іе1сІ5е1:> <!-- Тело, заполняемое сценарием ниже --> 

<йіѵ зТу1е=''1:ех1:-а1ідп:сеп1:ег"> <!-- Кнопки закрытия диалога --> 

<ЬіШоп опс1іск="окау()">0кау</Ьіі1:1:оп> <!— Устанавливает возвращаемое --> 

<!-- значение и закрывает диалог --> 

<Ьііиоп опс1іск="сапсе1( )”>СапсеК/Ьи1:1:оп> <!-- Закрывает диалог, --> 

<!-- не возвращая ничего —> 

</с!іѵ> 

<зсгірі> 

// Создает разметку НТМІ_ тела диалога и отображает ее в элементе Тіеісізеі: 

ѵаг агдз = сііаІодАгдцтепІз; 

ѵаг Тех! = "<іедепсі>" + агдз[0] + "</1едепсі>": 

^ог(ѵаг і = 1; і < агдз.ІепдТН; і++) 

Тех! += "<1аЬе1>" + агдз[і] + <іпри1: і^'Г' + і + ></1аЬе1><Ьг>”; 

сіоситепТ.деТЕІетепТВуІсіС'І'іеІсІз"). іппегНТМЬ = іехі; 

// Закрывает диалог без установки возвращаемого значения 
^цпсТіоп сапсеІО { ѵѵіпсіоѵѵ. с1озе(); } 

// Читает значения полей ввода и устанавливает возвращаемое значение, 

// затем закрывает диалог 
ТііпсТіоп окау() { 

ѵѵіпсіоѵѵ. геІіігпѴаІие = []; // Возвращаемый массив 

^ог(ѵаг і = 1; і < агдз. ІепдІГі; і++) // Значения элементов из полей ввода 
ѵѵіпсіоѵѵ. ге1шгпѴа1ііе[і-1] = йосцтеп1:.де1:Е1етеп1:ВуІсі('Т' + і).ѵа1це: 
ѵѵіпсіоѵѵ.с1озе(): // Закрыть диалог. Это заставит зПомМойаЮіаІодО вернуть управление. 

} 

</зсгірі> 

</Тогт> 

14.6. Обработка ошибок 

Свойство опеггог объекта ѴУіпсІоѵѵ - это обработчик событий, который вызывается 
во всех случаях, когда необработанное исключение достигло вершины стека вы¬ 
зовов и когда броузер готов отобразить сообщение об ошибке в консоли Зесѵа- 
8сгірі. Если присвоить этому свойству функцию, функция будет вызываться вся¬ 
кий раз, когда в окне будет возникать ошибка выполнения программного кода 
ЛѵаЗсгірі: присваиваемая функция станет обработчиком ошибок для окна. 

Исторически сложилось так, что обработчику события опеггог объекта Міпсіом 
передается три строковых аргумента, а не единственный объект события, как 
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в других обработчиках. (Другие объекты в клиентском ЛѵаЗсгірі также имеют 
обработчики опеггог, обрабатывающие различные ошибочные ситуации, но все 
они являются обычными обработчиками событий, которым передается единст% 
венный объект события.) Первый аргумент обработчика ѵѵ/іпсіоѵу/. опеггог - это сооб¬ 
щение, описывающее произошедшую ошибку. Второй аргумент - это строка, со¬ 
держащая ІЖЬ-адрес документа с Лѵа8сгірІ-кодом, приведшим к ошибке. Тре¬ 
тий аргумент - это номер строки в документе, где произошла ошибка. 

Помимо этих трех аргументов важную роль играет значение, возвращаемое обра¬ 
ботчиком опеггог. Если обработчик опеггог возвращает Іігие, это говорит броузеру 
о том, что ошибка обработана и никаких дальнейших действий не требуется; дру¬ 
гими словами, броузер не должен выводить собственное сообщение об ошибке. 
К сожалению, по историческим причинам в Гігеіюх обработчик ошибок должен 
возвращать Іігие, чтобы сообщить о том, что ошибка обработана. 

Обработчик опеггог является пережитком первых лет развития ЛѵаЗсгірі, когда 
в базовом языке отсутствовала инструкция Ігу/саІсИ обработки исключений. 
В современном программном коде этот обработчик используется редко. Однако 
на время разработки вы можете определить свой обработчик ошибок, как показа¬ 
но ниже, который будет уведомлять вас о всех происходящих ошибках: 

// Вывести сообщение об ошибке в виде диалога, но не более 3 раз 
міпсіоѵу/. опеггог = І^псІііопСтзд, іігі, Ііпе) { 

Н (опеггог. пііт++ < опеггог.тах) { 

аІегК "ОШИБКА: " + тзд + "\п" + іігі + + Ііпе): 

геііігп іігие: 

} 

} 

опеггог. тах = 3: 
опеггог. пит = 0: 

14.7. Элементы документа как свойства окна 

Если для именования элемента в НТМЬ-документе используется атрибут ісі и ес¬ 
ли объект іл/іпсіоѵѵ/ еще не имеет свойства, имя которого совпадает со значением это¬ 
го атрибута, объект Ѵ\Ііпсіо\л/ получает неперечислимое свойство с именем, соответ¬ 
ствующим значению атрибута ісі, значением которого становится объект НТМІ_Е1е- 
тепі:, представляющий этот элемент документа. 

Как вы уже знаете, объект Міпсіом играет роль глобального объекта, находящегося 
на вершине цепочки областей видимости в клиентском ЛѵаЗсгірі. Таким обра¬ 
зом, вышесказанное означает, что атрибуты ісі в НТМЬ-документах становятся 
глобальными переменными, доступными сценариям. Если, например, документ 
включает элемент <Ьи1:1:оп ісі=*'окау ’’/>, на него можно сослаться с помощью гло¬ 
бальной переменной окау. 

Однако важно отметить, что этого не происходит, если объект Міпсісм уже имеет 
свойство с таким именем. Элементы с атрибутами ісі, имеющими значение «Ьізіо- 
гу», «Іосаііоп» или «паѵі^аіог», например, не будут доступны через глобальные 
переменные, потому что эти имена уже используются. Аналогично, если НТМЬ- 
документ включает элемент с атрибутом ісі, имеющим значение «х» и в сценарии 
объявляется и используется глобальная переменная х, явно объявленная пере- 
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менная скроет неявную переменную, ссылающуюся на элемент. Если перемен¬ 
ная объявляется в сценарии, который в документе находится выше именованно¬ 
го элемента, наличие переменной будет препятствовать появлению нового свойг 
ства окна. Л если переменная объявляется в сценарии, который находится ниже 
именованного элемента, первая же инструкция присваивания значения этой пе¬ 
ременной затрет значение неявно созданного свойства. 

В разделе 15.2 вы узнаете, что с помощью метода сіоситепі;.де1:Е1етепі;ВуІс1( ) можно 
отыскивать элементы документа по значениям их НТМЬ-атрибутов ісі. Взгляните 
на следующий пример: 

ѵаг іл = ["іпрііі:", "рготрі","Пеасііпд’']; // Массив идентификаторов элементов 

іл. ^огЕасИ( ^ипсі:іоп(ісі) { // Отыскать элемент для каждого ісі 

иі[ісі] = сіоситепі. деіЕ1етеп1:ВуІсі(ісі); // и сохранить его в свойстве 

}); 

После выполнения этого фрагмента свойства иі.іприі, иі. рготрі и иі. Ііеасііпд будут 
ссылаться на элементы документа. Вместо иі.іприі и иі.ііеасііпд сценарий мог бы 
использовать глобальные переменные іприі и ііеасііпд. Но, как вы помните из 14.5, 
объект іл/іпсіоѵѵ/ имеет метод с именем рготрі( ), поэтому сценарий не сможет исполь¬ 
зовать глобальную переменную рготрі вместо свойства иі. рготрі. 

Неявное использование идентификаторов элементов в качестве глобальных пере¬ 
менных - это пережиток истории развития веб-броузеров. Эта особенность необ¬ 
ходима для сохранения обратной совместимости с существующими веб-страни¬ 
цами, но использовать ее сейчас не рекомендуется - в любой момент производи¬ 
тели броузеров могут определить новое свойство в объекте Шпдоѵі, что нарушит 
работу любого программного кода, использующего неявно определяемое свойст¬ 
во с этим именем. Поиск элементов лучше выполнять явно, с помощью метода 
сіоситепі. деіЕІетепіВуІсК ). А его использование будет менее трудоемким, если дать 
ему более короткое имя: 

ѵаг $ = іипсііоп ( ісі ) { геііігп сіоситепі. деіЕІетепіВуІсК ісі); }; 

ьі.рготрі = $("рготрі"); 

Многие клиентские библиотеки определяют функцию $, которая отыскивает эле¬ 
менты по их идентификаторам, как в примере выше. (В главе 19 мы узнаем, что 
функция $ в библиотеке і()иегу является универсальным методом выбора элемен¬ 
тов, который может возвращать один или более элементов, опираясь на их иден¬ 
тификаторы, имена тегов, атрибут сіазз или исходя из других критериев.) 

Любой НТМЬ-элемент с атрибутом ісі становится значением глобальной перемен¬ 
ной, если значение атрибута ісі еще не используется объектом Ѵ\ІіпсІо\л/. Следующие 
НТМЬ-элементы ведут себя подобным образом, если в них определен атрибут пате: 

<а> <арр1еі> <агеа> <етЬесІ> <іогт> <ігате> <1гате5еі> <іігате> <ітд> <оЬ]есі> 

Атрибут ісі элемента необходим для придания ему уникальности внутри доку¬ 
мента: два элемента не могут иметь одинаковые значения атрибута ісі. Однако это 
не относится к атрибуту пате. Если сразу несколько элементов, из перечисленных 
выше, будут иметь одно и то же значение атрибута пате (или, если один элемент 
имеет атрибут пате, а другой - атрибут ісі с тем же значением), неявно созданная 
глобальная переменная с этим именем будет ссылаться на объект, подобный мас¬ 
сиву, хранящий все элементы с этим именем. 
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Элементы <іГгате> с атрибутом пате или ісі обрабатываются иначе. Переменная, не¬ 
явно созданная для таких элементов, будет ссылаться не на объект Еіетепі:, пред¬ 
ставляющий сам элемент, а наобъект іл/іпсіом, представляющий вложенный фрейм» 
созданный элементом <іГгате>. К этой теме мы еще вернемся в разделе 14.8.2. 

14.8. Работа с несколькими окнами и фреймами 

Единственное окно веб-броузера может содержать несколько вкладок. Каждая 
вкладка является независимым контекстом просмотра . Каждая имеет собст¬ 
венный объект Шіпсіом, и каждая изолирована от всех остальных. Сценарий, вы¬ 
полняющийся в одной вкладке, обычно даже не имеет возможности узнать о су¬ 
ществовании других вкладок, и тем более не имеет возможности взаимодейство¬ 
вать с их объектами іл/іпсіом или манипулировать содержащимися в них докумен¬ 
тами. Если вы пользуетесь броузером, который не поддерживает вкладки, или 
поддержка вкладок отключена, вы можете открыть сразу несколько окон веб-бро- 
узера. Как и в случае с вкладками, каждое окно имеет свой собственный объект 
іл/іпсіом, и каждое окно обычно изолировано и не зависит от всех остальных окон. 

Но окна не всегда изолированы друг от друга. Сценарий в одном окне или вкладке 
может открывать новые окна или вкладки, и в этом случае окна могут взаимодейст¬ 
вовать друг с другом и с находящимися в них документами (с учетом ограничений, 
накладываемых политикой общего происхождения, описываемой в разделе 13.6.2). 
Подробнее тема открытия и закрытия окон рассматривается в разделе 14.8.1. 

НТМЬ-документы могут содержать вложенные документы, используя для этого 
элементы <іГгате>. Элемент <іГгате> создает вложенный контекст просмотра, пред¬ 
ставленный отдельным объектом іл/іпсіом. Устаревшие и не рекомендуемые к ис¬ 
пользованию элементы <Ггатезе1:> и <Ггате> также создают вложенные контексты 
просмотра, и каждый элемент <Ггате> представлен собственным объектом іл/іпсіоѵѵ. 
Различия между окнами, вкладками, плавающими фреймами (элемент <іГгате>) 
и фреймами в клиентском ЛѵаВсгірі весьма несущественны: все они являются 
отдельными контекстами просмотра и в сценариях все они представлены объекта¬ 
ми іл/іпсіом. Вложенные контексты просмотра не изолированы друг от друга, как 
обычно бывают изолированы независимые вкладки. Сценарий, выполняющийся 
в одном фрейме, всегда имеет доступ к вмещающим и вложенным фреймам, 
и только политика общего происхождения может не позволять сценарию про¬ 
сматривать документы в этих фреймах. Вложенные фреймы рассматриваются 
в разделе 14.8.2. 

Поскольку в клиентском ^ѵаВсгірі объект Іл/іпйом является глобальным объек¬ 
том, каждое окно или фрейм имеет отдельный контекст выполнения сценариев 
на языке ^ѵаВсгірі. Однако сценарий ^ѵаЗсгірі, выполняющийся в одном окне, 
может, с учетом ограничений политики общего происхождения, использовать объ¬ 
екты, свойства и методы, объявленные в другом окне. Более подробно эта тема об¬ 
суждается в разделе 14.8.3. На тот случай, когда политика общего происхождения 
не позволяет сценариям в двух отдельных окнах взаимодействовать друг с другом 
напрямую, стандарт НТМЬб предусматривает прикладной интерфейс передачи 
сообщений, основанный на механизме событий, который обеспечивает возмож¬ 
ность косвенного взаимодействия. Подробнее эта возможность рассматривается 
в разделе 22.3. 
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14.8.1. Открытие и закрытие окон 

Открыть новое окно веб-броузера (или вкладку, что обычно зависит от настроек 
броузера) можно с помощью метода ореп() объекта Іл/іпгіом. Метод Ѵ\/іпР<жореп() за¬ 
гружает документ по указанному ІІКЬ-адресу в новое или в существующее окно 
и возвращает объект іл/іпсіом, представляющий это окно. Он принимает четыре не¬ 
обязательных аргумента: 

Первый аргумент ореп( ) - это ІІКЬ-адрес документа, отображаемого в новом окне. 
Если этот аргумент отсутствует (либо является пустой строкой), будет открыт 
специальный ІІКЬ пустой страницы аЬои1::Ыапк. 

Второй аргумент ореп() - это строка с именем окна. Если окно с указанным име¬ 
нем уже существует (и сценарию разрешено просматривать содержимое этого ок¬ 
на), используется это существующее окно. Иначе создается новое окно и ему при¬ 
сваивается указанное имя. Если этот аргумент опущен, будет использовано спе¬ 
циальное имя «_Ыапк», т. е. будет открыто новое неименованное окно. 

Обратите внимание, что сценарии не могут просто так указывать имена окон и не 
могут получать контроль над окнами, используемыми другими веб-приложения- 
ми: они могут указывать имена только тех существующих окон, которыми им 
«разрешено управлять» (термин взят из спецификации НТМЬб). Проще говоря, 
сценарий может указать имя существующего окна, только если это окно содер¬ 
жит документ, происходящий из того же источника, или если это окно было от¬ 
крыто самим сценарием (или рекурсивно открытым окном, которое открыло это 
окно). Кроме того, если одно окно является фреймом, вложенным в другое окно, 
сценарии в любом из них получают возможность управлять другим окном. В этом 
случае можно использовать зарезервированные имена «_1ор» (для обозначения 
вмещающего окна верхнего уровня) и «_рагепі» (для обозначения ближайшего 
вмещающего окна). 


Имена окон 

Имя окна играет важную роль, потому что оно позволяет указать сущест¬ 
вующее окно в вызове метода ореп( ), а также потому, что оно может исполь¬ 
зоваться как значение НТМЬ-атрибута іагдеі: элементов <а> и <^огт>, ссы¬ 
лающихся на документ (или результат обработки формы), который должен 
быть отображен в именованном окне. Атрибуту іагдеі: этих элементов мож¬ 
но также присвоить значение «_Ыапк», «_рагепі» или «_іор», чтобы от¬ 
крыть документ в новом пустом окне, родительском окне или фрейме или 
в окне верхнего уровня. 

Имя окна, если оно имеется, хранится в свойстве пате объекта іл/іпсіом. Данное 
свойство доступно для записи, и сценарии могут изменять его по мере необ¬ 
ходимости. Если методу Іл/іпсІ<жореп() передать имя (отличное от «_Ыапк»), 
окно, созданное вызовом этого метода, получит указанное имя, как началь¬ 
ное значение свойства пате. Если элемент <і1тате> имеет атрибут пате, объ¬ 
ект Іл/іпгіом, представляющий этот фрейм, будет использовать значение ат¬ 
рибута пате как начальное значение свойства пате. 
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Глава 14. Объект ѴѴіпсІоѵѵ 


Третий необязательный аргумент ореп() - это список параметров, определяющих 
размер и видимые элементы графического пользовательского интерфейса нового 
окна. Если опустить этот аргумент, окно получает размер по умолчанию и пол¬ 
ный набор графических элементов: строку меню, строку состояния, панель инст¬ 
рументов и т.д. В броузерах, поддерживающих вкладки, это обычно приводит 
к созданию новой вкладки. Указав этот аргумент, можно явно определить размер 
окна и набор имеющихся в нем элементов управления. (Если явно указать раз¬ 
мер, в большинстве случаев это приведет к созданию нового окна, а не вкладки.) 
Например, маленькое окно с изменяемым размером, имеющее строку состояния, 
но не содержащее меню, панели инструментов и адресную строку, можно от¬ 
крыть посредством следующим образом: 

ѵаг ѵі = ѵі/іпс!оѵі/.ореп("зта11\л/іп.Шті ", "зтаііѵі/іп", 

"ѵі/ісіі:П= 400, ЬеідМ:=350, зіа1:ііз=уез, гезі 2 аЫе=уез"); 

Этот третий аргумент является нестандартным, и спецификация НТМЬб требует, 
чтобы броузеры игнорировали его. Подробнее о том, какие параметры можно ука¬ 
зывать в этом аргументе, рассказывается в описании метода 1л/іпсІоѵі/.ореп() в чет¬ 
вертой части книги. Обратите внимание, что, когда указывается третий аргумент, 
любые не заданные явно элементы управления отсутствуют. По ряду причин, 
связанных с проблемами безопасности, броузеры накладывают ограничения на 
характеристики, которые можно передать методу. Так, например, невозможно 
открыть слишком маленькое окно или открыть его за пределами видимой облас¬ 
ти экрана; кроме того, некоторые броузеры не допускают возможности создания 
окон без строки состояния. 

Указывать четвертый аргумент ореп() имеет смысл, только если второй аргумент 
определяет имя существующего окна. Этот аргумент - логическое значение, опре¬ 
деляющее, должен ли ШІЬ -адрес, указанный в первом аргументе, заменить теку¬ 
щую запись в истории просмотра окна (Іігие) или требуется создать новую запись 
(Гаізе). Если этот аргумент опущен, используется значение по умолчанию І'аізе. 

Значение, возвращаемое методом ореп(), является объектом Іл/іпРоѵі/, представляю¬ 
щим вновь созданное окно. Этот объект позволяет сослаться в ^ѵа8сгірі-коде на 
новое окно так же, как исходный объект іл/іпсіоѵі/ ссылается на окно, в котором вы¬ 
полняется сценарий: 

ѵаг ѵі/ = ѵі/іпсіоѵі/. ореп(); // Открыть новое пустое окно 

ѵі/.а1егі;(" Будет открыт сайт ЬПр://ехатр1е.сот"); // Вызвать его метод аіегі: () 
ѵі/. Іосаііоп = "Іі**р://ехатр1е. сот" ; // Установить св-во Іосаііоп 

В окнах, созданных методом ѵі/іпс!оѵі/.ореп(), свойство орепег ссылается на объект 
Іл/іпсіоѵі/ сценария, открывшего его. В других случаях свойство орепег получает зна¬ 
чение пиіі: 

ѵі. орепег !== піііі; // Верно для любого окна ѵі, созданного методом ореп() 
ѵі. ореп(). орепег === ѵі; // Верно для любого окна ѵі 

Метод 1л/іпс1оѵі/.ореп() часто используется рекламодателями для создания «всплы¬ 
вающих окон» с рекламой, когда пользователь путешествует по Всемирной пау¬ 
тине. Такие всплывающие окна могут раздражать пользователя, поэтому боль¬ 
шинство веб-броузеров реализуют механизм блокирования всплывающих окон. 
Обычно вызов метода ореп() преуспевает, только если он производится в ответ на 
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действия пользователя, такие как щелчок мышью на кнопке или на ссылке. По* 
пытка открыть всплывающее окно, которая производится, когда броузер просто 
загружает (или выгружает) страницу, обычно оканчивается неудачей. Попытка 
протестировать представленные выше строки программного кода в консоли ^ѵа- 
Зсгірі вашего броузера также может окончиться неудачей по тем же причинам. 

14.8.1.1. Закрытие окон 

Новое окно открывается при помощи метода ореп() и закрывается при помощи 
метода с1озе(). Если объект іл/іпсіоѵі/ был создан сценарием, то этот же сценарий 
сможет закрыть его следующей инструкцией: 

ѵі/. с1озе(); 

Лѵа8сгірІ-код, выполняющийся внутри данного окна, может закрыть его так: 

ѵі/іпсіоѵі/. с1озе( ); 

Обратите внимание на явное использование идентификатора ѵі/іпсіоѵі/ для устране¬ 
ния неоднозначности между методом с1озе() объекта Іл/іпРоѵі/ и методом с1озе() объ¬ 
екта Эоситепі: - это важно, если метод с1озе() вызывается внутри обработчика со¬ 
бытия. 

Большинство броузеров разрешают программисту автоматически закрывать толь¬ 
ко те окна, которые были созданы его собственным ^ѵа8сгірі-кодом. Если сцена¬ 
рий попытается закрыть любое другое окно, появится диалоговое окно с запро¬ 
сом к пользователю подтвердить (или отменить) закрытие окна. Вызов метода 
с1озе() объекта Іл/іпгіоѵі/, представляющего фрейм, а не окно верхнего уровня или 
вкладку, не выполняет никаких действий: нельзя закрыть фрейм (можно только 
удалить элемент <і1тате> из содержащего его документа). 

Объект іл/іпсіоѵі/ продолжает существовать и после закрытия представляемого им 
окна. Однако не следует использовать какие-либо его свойства или методы, ис¬ 
ключая проверку свойства сіозесі. Если окно было закрыто, это свойство будет 
иметь значение Ігие, свойство сіоситепі: - значение пиіі, а методы окна обычно не 
выполняются. 

14.8.2. Отношения между фреймами 

Мы уже видели, что метод ореп() объекта Іл/іпРоѵі/ возвращает новый объект іл/іпсіоѵ\/, 
свойство орепег которого ссылается на первоначальное окно. Таким образом, два 
окна могут ссылаться друг на друга, и каждое из них может читать свойства и вы¬ 
зывать методы другого. То же самое возможно для фреймов. Сценарий, выпол¬ 
няющийся в окне или фрейме, может ссылаться на объемлющее или вложенное 
окно или фрейм при помощи свойств, описываемых ниже. 

Как вы уже знаете, сценарий в любом окне или фрейме может сослаться на собст¬ 
венное окно или фрейм с помощью свойства ѵі/іпРоѵі/ или зеН. Фрейм может сослать¬ 
ся на объект іл/іпсіоѵі/ вмещающего окна или фрейма с помощью свойства рагепі:: 

рагет. Мізііогу. Ьаск(); 

Объект іл/іпсіоѵі/, представляющий окно верхнего уровня или вкладку, не имеет 
вмещающего окна, поэтому его свойство рагепі: просто ссылается на само окно: 

рагепі: == зеі^ ; // Для любых окон верхнего уровня 
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Если фрейм находится внутри другого фрейма, содержащегося в окне верхнего 
уровня, то он может сослаться на окно верхнего уровня так: рагепі.рагепі. Однако 
в качестве универсального сокращения имеется свойство Іор: независимо от глу; 
бины вложенности фрейма его свойство Іор ссылается на содержащее его окно 
самого верхнего уровня. Если объект Іл/іпсіом представляет окно верхнего уровня, 
свойство Іор просто ссылается на само окно. Для фреймов, непосредственно при¬ 
надлежащих окну верхнего уровня, значение свойства Іор совпадает со значени¬ 
ем свойства рагепі:. 

Свойства рагепі: и Юр позволяют сценариям ссылаться на родительские окна или 
фреймы. Существует несколько способов сослаться на дочерние окна или фрей¬ 
мы. Фреймы создаются с помощью элементов <іГгате>. Получить ссылку на объ¬ 
ект Еіетепі, представляющий элемент <іГгате>, можно точно так же, как на объ¬ 
ект, представляющий любой другой элемент. Допустим, что документ содержит 
тег сіГгате іс!= Т1">. Тогда получить ссылку на объект Еіетепі, представляющий 
этот элемент іГгате можно следующим образом: 

ѵаг іГгатеЕІетепІ = Роситеп1.деІЕ1етепІВуІсІ(''Г1''); 

Элементы <іГгате> имеют свойство сопіепііл/іпсіом, которое ссылается на объект 
Ѵу/іпсіо\л/ фрейма, поэтому ссылку на объект Іл/іпРом этого фрейма можно получить 
так: 

ѵаг сМПРРгате = Роситеп1.де1Е1етеп1Ву1Р(*'Г1").соп1епШпРо\л/; 

Имеется возможность пойти обратным путем - от объекта ілііпсіом, представляю¬ 
щего фрейм, к объекту Еіетепі элемента <іГгате>, содержащего фрейм, - с помо¬ 
щью свойства ГгатеЕІетепІ объекта Іл/іпгіом. Объекты Іл/іпгіом, представляющие окна 
верхнего уровня, а не фреймы, имеют значение пиіі в свойстве ГгатеЕІетепІ: 

ѵаг еіі = с^ос^теп^.де^Е1етеп^ВуIс^("Г1' , ); 
ѵаг ѵі/іп = еіі.сопІепІИіпсІоѵі/; 

ѵі/іп.ГгатеЕІетепІ === еіі // Всегда верно для фреймов 
ѵѵіпсІоѵѵ. ГгатеЕІетепІ === пиіі // Для окон верхнего уровня 

Однако, чтобы получить ссылки на дочерние фреймы, обычно не требуется ис¬ 
пользовать метод деіЕІетепіВуІсІО и свойство сопіепііл/іпсіоѵѵ. Каждый объект Іл/іпсіоѵѵ 
имеет свойство Ггатез, хранящее ссылки на дочерние фреймы, содержащиеся 
в окне или фрейме. Свойство Ггатез ссылается на объект, подобный массиву, кото¬ 
рый может индексироваться числовыми индексами или именами фреймов. По¬ 
лучить ссылку на первый дочерний фрейм в окне можно с помощью выражения 
Г гатез[0]. Сослаться на третий дочерний фрейм во втором дочернем фрейме можно 
с помощью выражения Ггатез[1].Ггатез[2]. Сценарий, выполняющийся во фрей¬ 
ме, может сослаться на соседний фрейм одного с ним уровня, как рагепі. Ггатез[1]. 
Обратите внимание, что элементами массива Ггатез[] являются объекты Іл/іпРом, 
а не элементы <іГгате>. 

Если в элементе <іГгате> указать атрибут пате или ісі, в качестве индекса этого 
фрейма можно будет использовать не только число, но и имя. Например, ссылку 
на фрейм с именем «И» можно получить с помощью выражения Ггатез["Г1"] или 
Ггатез.Г1. 

В разделе 14.7 говорилось, что имена или идентификаторы элементов <іГгате> 
и других автоматически превращаются в свойства объекта Іл/іпсіоѵѵ и что элементы 
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<і1тате> интерпретируются иначе, чем другие элементы: в случае с фреймами зна¬ 
чениями этих автоматически создаваемых свойств становятся ссылки на объек¬ 
ты ілііпсіом, а не на объекты Еіетепі. Это означает, что на фрейм с именем «Я* можно* 
сослаться как на свойство іЛ вместо Ітатез. 14. В действительности, стандарт 
НТМЬб указывает, что свойство Ітатез, подобно свойствам міпсіом и зеИ, ссылается 
на сам объект іл/іпсіом, который действует как массив фреймов. Это означает, что на 
первый дочерний фрейм можно сослаться, как міпйом[0], а получить количество 
фреймов можно, обратившись к свойству ѵу/іпсіоѵѵ. ІепдІіИ или просто ІепдЯі. Однако 
использование свойства Ітатез вместо міпсіом в подобных случаях делает про¬ 
граммный код более понятным. Обратите внимание, что не во всех текущих бро¬ 
узерах выполняется условие 1тате==\л/іпгіом, но даже в броузерах, где это условие 
не выполняется, разрешается индексировать дочерние фреймы числами и имена¬ 
ми, обращаясь к любому из этих двух объектов. 

С помощью атрибута пате или ісі элементу <і1тате> можно присвоить имя, которое 
будет доступно для использования в ^ѵа8сгірі-коде. Однако если использовать ат¬ 
рибут пате, указанное имя также будет использоваться в качестве значения свойст¬ 
ва пате объекта Іл/іпгіом, представляющего фрейм. Имя, указанное таким способом, 
можно использовать в качестве значения атрибута іагдеі: ссылки и передавать ме¬ 
тоду ѵѵіпсІсм.орепО во втором аргументе. 

14.8.3. .ІаѵаЗсгірі во взаимодействующих окнах 

Для каждого окна или фрейма имеется свой собственный объект іл/іпсіоѵѵ, опреде¬ 
ляющий независимый контекст выполнения Лѵа8сгірі-кода. Но если сценарий 
в одном окне или фрейме может сослаться на другое окно или фрейм (и если поли¬ 
тика общего происхождения не препятствует этому), сценарий в одном окне или 
фрейме может взаимодействовать со сценарием в другом окне или фрейме. 

Представим себе веб-страницу с двумя элементами <і1тате>, с именами «А» и «В», 
и предположим, что эти фреймы содержат документы, полученные с одного и то¬ 
го же сервера, и эти документы содержат взаимодействующие сценарии. Сцена¬ 
рий во фрейме А определяет переменную і: 

ѵаг і = 3; 

Это переменная представляет собой свойство глобального объекта, т. е. свойство 
объекта Іл/іпгіом. Сценарий во фрейме А может явно сослаться на эту переменную 
как на свойство с помощью объекта міпйом: 

Ѵі/ІПСІОѴі/. і 

Благодаря тому что сценарий во фрейме В может ссылаться на объект Міпсіом во 
фрейме А, он также может ссылаться на свойства этого объекта окна: 

рагеп1:.А.і = 4; // Изменит значение переменной во фрейме А 

Напомню, что ключевое слово ^ипс^іоп, определяющее функцию, объявляет пере¬ 
менную так же, как ключевое слово ѵаг. Если ^ѵа8сгірі-код во фрейме В объяв¬ 
ляет функцию Т, эта функция станет глобальной переменной во фрейме В, и сце¬ 
нарий во фрейме В сможет вызывать функцию 1" как 14). Однако сценарий во 
фрейме А должен ссылаться на 1" как на свойство объекта іл/іпсіом во фрейме В: 

рагепі:. В. 14); // Вызовет функцию, объявленную во фрейме В 
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Глава 14. Объект ѴѴіпсІоѵѵ 


Если сценарий во фрейме Л часто вызывает эту функцию, ее можно присвоить 
переменной во фрейме Л, чтобы было удобнее ссылаться на функцию: 

ѵаг I = рагепТ.В.Г; 

Теперь сценарий во фрейме А сможет вызывать функцию как Г() точно так же, 
как сценарий во фрейме В. 

Разделяя подобным образом функции между фреймами или окнами, очень важ¬ 
но помнить о правилах лексического контекста. Функции выполняются в том 
контексте, в котором они определены, а не в том, из которого они вызываются. 
Следовательно, если функция Г ссылается на глобальные переменные, поиск этих 
переменных выполняется в свойствах фрейма В, даже когда функция вызывает¬ 
ся из фрейма А. 

Напомню, что конструкторы - это тоже функции, поэтому когда вы определяете 
класс объектов (см. главу 9) с функцией-конструктором и связанным с ним объек¬ 
том-прототипом, этот класс будет определен только для одного окна. Предполо¬ 
жим, что окно, содержащее фреймы А и В, включает класс Зеі: из примера 9.6. 

Сценарии в окне верхнего уровня смогут создавать новые объекты Зеі:, как пока¬ 
зано ниже: 

ѵаг з = пе\л/ ЗеіО; 

Но сценарии в обоих фреймах должны явно ссылаться на конструктор ЗеІ(), как 
на свойство родительского окна: 

ѵаг з = пеѵі/ рагепі: . Зеі:(); 

В качестве альтернативы сценарий в любом фрейме может определить собствен¬ 
ные переменные для более удобного обращения к функции-конструктору: 

ѵаг Зеі: = Іор.ЗеК); 
ѵаг з = пей Зеі:(); 

В отличие от пользовательских классов, предопределенные классы, такие как 
Зеі, Оаіе и РедЕхр, оказываются автоматически определенными во всех окнах. Од¬ 
нако следует заметить, что каждое окно имеет независимую копию конструктора 
и независимую копию объекта-прототипа. Например, каждое окно имеет собст¬ 
венную копию конструктора Зігіпд( )и объекта Зігіпд. ргоіоіуре. Поэтому, если вы 
создадите новый метод для работы с ЛѵаВсгірі-строками и сделаете его методом 
класса Зігіпд, присвоив его объекту Зігіпд.ргоіоіуре в текущем окне, все строки 
в этом окне смогут использовать новый метод, однако этот новый метод будет не¬ 
доступен строкам, определенным в других окнах. 

Тот факт, что каждый объект іл/іпсіом имеет собственные объекты-прототипы, оз¬ 
начает, что оператор іпзІапсеоГ не будет работать с объектами в разных окнах. 
Например, оператор іпзіапсеоі будет возвращать Гаізе при сопоставлении строки 
из фрейма В с конструктором ЗігіпдО из фрейма А. В разделе 7.10 описываются 
похожие сложности с определением типов массивов в разных окнах. 




14.8. Работа с несколькими окнами и фреймами 
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Объект ѴѴіпсІоѵѵРгоху 

Мы неоднократно отмечали, что в клиентском ^ѵаЗсгірі объект Ілііпгіом яв¬ 
ляется глобальным объектом. Однако если смотреть с технической точки 
зрения, это не так. Каждый раз, когда веб-броузер загружает содержимое 
в окно или фрейм, он должен создать новый контекст выполнения Лѵа- 
Всгірі, включая и новый глобальный объект. Но при наличии нескольких 
взаимодействующих окон или фреймов очень важно обеспечить сохран¬ 
ность ссылки на объект Міпсіом, представляющий фрейм или окно, даже ес¬ 
ли в этот фрейм или окно загружается новый документ. 

Таким образом, в клиентском ЛѵаВсгірі имеется два объекта, играющих 
важную роль. Первый - это клиентский глобальный объект, который на¬ 
ходится на вершине цепочки областей видимости и в котором определяют¬ 
ся глобальные переменные и функции. Этот глобальный объект действи¬ 
тельно замещается новым объектом, когда в окно или фрейм загружается 
новый документ. Второй объект, который мы называем объектом Шіпсіом, 
в действительности не является глобальным объектом - это промежуточ¬ 
ный объект. Всякий раз, когда сценарий читает или изменяет значение 
свойства объекта іл/іпсіом, этот объект запрашивает или изменяет свойство 
с тем же именем глобального объекта окна или фрейма. В спецификации 
НТМЬб этот промежуточный объект называется объектом ІлІіпсІомРгоху, но 
далее в этой книге мы продолжим использовать имя Шіпсіом. 

Этот промежуточный объект ведет себя как настоящий глобальный объ¬ 
ект, за исключением того, что живет гораздо дольше. Если бы вы могли 
сравнить эти два объекта, вы едва ли смогли бы отличить их. Однако на са¬ 
мом деле нет никакой возможности сослаться на настоящий клиентский 
глобальный объект. Глобальный объект находится на вершине цепочки об¬ 
ластей видимости, но свойства міпсіом, зеІГ, Іор, рагепі: и Ітатез ссылаются на 
промежуточные объекты. Метод міпсІом.ореп() возвращает промежуточный 
объект. Даже ключевое слово ІМіз в функциях верхнего уровня ссылается 
на промежуточный объект, а не на настоящий глобальный объект. 1 


1 Этот последний пункт является небольшим отступлением от стандартов Е83 и Е85, но 
это необходимо для поддержки взаимодействующих контекстов выполнения в клиент¬ 
ском ^ѵа8сгірі. 



15 

Работа с документами 


Клиентский ^ѵаВсгірі предназначен для того, чтобы превращать статические 
НТМЬ-документы в интерактивные веб-приложения. Работа с содержимым веб¬ 
страниц - главное предназначение ЛѵаЗсгірі. Данная глава является одной из 
наиболее важных в этой книге - здесь рассказывается о том, как это делается. 

В главах 13 и 14 говорилось, что каждое окно, вкладка и фрейм веб-броузера пред¬ 
ставлено объектом ілііпсіом. Каждый объект іл/іпсіом имеет свойство сіоситепі:, ссы¬ 
лающееся на объект Ооситепі:. Этот объект Ооситепі и является темой обсуждения 
данной главы. Однако объект Ооситепі: не является автономным объектом. Он яв¬ 
ляется центральным объектом обширного АРІ, известного как объектная модель 
документа (Боситепі ОЬіесі Мосіеі, БОМ), который определяет порядок доступа 
к содержимому документа. 

Эта глава начинается с описания базовой архитектуры БОМ, а затем она расска¬ 
жет: 

• Как выбирать отдельные элементы документа. 

• Как выполняется обход содержимого документа, представленного в виде дере¬ 
ва узлов, и как отыскивать в нем родительские, дочерние и братские элементы. 

• Как читать и изменять значения атрибутов элементов документа. 

• Как читать и изменять содержимое документа. 

• Как изменять структуру документа, создавая, вставляя и удаляя узлы. 

• Как работать с НТМЬ-формами. 

В заключительном разделе этой главы рассматриваются различные особенности 
документов, включая свойство геіеггег, метод ѵѵгі1:е( ) и приемы получения текста, 
выделенного в документе. 

15.1. Обзор модели РОМ 

Объектная модель документа (Боситепі ОЬіесі Мосіеі, БОМ) - это фундамен¬ 
тальный прикладной программный интерфейс, обеспечивающий возможность 



15.1. Обзор модели РОМ 
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работы с содержимым НТМЬ- и ХМЬ-доку ментов. Прикладной программный ин¬ 
терфейс (АРІ) модели БОМ не особенно сложен, но в нем существует множество 
архитектурных особенностей, которые вы должны знать 

Прежде всего, следует понимать, что вложенные элементы НТМЬ- или ХМЬ-до- 
кументов представлены в виде дерева объектов БОМ. Древовидное представление 
НТМЬ-документа содержит узлы, представляющие элементы или теги, такие как 
<Ьос1у> и <р>, и узлы, представляющие строки текста. НТМЬ-документ также мо¬ 
жет содержать узлы, представляющие НТМЬ-комментарии. Рассмотрим следую¬ 
щий простой НТМЬ-документ: 

<М1:т1> 

<ЬеасІ> 

<Ш1е>8атр1е ОосіітегѵЬ</тіе> 

</Меас1> 

<ЬосІу> 

<М>Ап НТМЬ 0осіітеп1:</М> 

<р>ТНіз із а <і>зітр1е</і> сіосіітепі:. 

</Ыт1> 

БОМ-представление этого документа приводится на рис. 15.1. 

Тем, кто еще не знаком с древовидными структурами в компьютерном программи¬ 
ровании, полезно узнать, что терминология для их описания была заимствована 
у генеалогических деревьев. Узел, расположенный непосредственно над данным 
узлом, называется родительским по отношению к данному узлу. Узлы, располо¬ 
женные на один уровень ниже другого узла, являются дочерними по отношению 
к данному узлу. Узлы, находящиеся на том же уровне и имеющие того же родите¬ 
ля, называются братьями . Узлы, расположенные на любое число уровней ниже 
другого узла, являются его потомками . Родительские, прародительские и лю¬ 
бые другие узлы, расположенные выше данного узла, являются его предками . 



Рис. 15.1. Древовидное представление НТМЬ-документа 
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Глава 15. Работа с документами 


Каждый прямоугольник на рис. 15.1 является узлом документа, который пред¬ 
ставлен объектом Мойе. О свойствах и методах объекта Мойе будет рассказываться 
в некоторых разделах, следующих ниже, кроме того, описания этих свойств ввд 
найдете в справочной статье Мойе в четвертой части книги. Обратите внимание, 
что на рисунке изображено три различных типа узлов. Корнем дерева является 
узел Оосіітепі, который представляет документ целиком. Узлы, представляющие 
НТМЬ-элементы, являются узлами типа Еіетепі, а узлы, представляющие текст, - 
узлами типа Техі. Оосіітепі:, Еіетепі: и Техі - это подклассы класса Мойе, и для них 
имеются отдельные справочные статьи в четвертой части книги. Оосіітепі: и Еіетепі 
являются двумя самыми важными классами в модели БОМ, и большая часть 
главы посвящена знакомству с их свойствами и методами. 

Тип Мойе и его подтипы образуют иерархию типов, изображенную на рис. 15.2. Об¬ 
ратите внимание на формальные отличия между обобщенными типами Оосіітепі 
и Еіетепі, и типами НТМЮосіітепі и НТМІ_Е1етеп1. Тип Оосіітепі представляет НТМЬ- 
и ХМЬ-документ, а класс Еіетепі представляет элемент этого документа. Под¬ 
классы НТМЮосіітепі и НТМІ_Е1етеп1 представляют конкретно НТМЬ-документ и его 
элементы. В этой книге часто используются имена обобщенных классов Оосіітепі 
и Еіетепі, даже когда подразумеваются НТМЬ-документы. То же самое относится 
и к справочному разделу книги: свойства и методы типов НТМЮосіітепі и НТМІ_Е1е- 
тепі описываются в справочных статьях Оосіітепі и Еіетепі. 
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Рис . 15.2. Неполная иерархия классов узлов документов 


На рис. 15.2 следует также отметить наличие большого количества подтипов 
класса НТМІ_Е1етеп1, представляющих конкретные типы НТМЬ-элементов. Каж¬ 
дый из них определяет ЛѵаВсгірі-свойства, отражающие НТМЬ-атрибуты кон¬ 
кретного элемента или группы элементов (раздел 15.4.1). Некоторые из этих спе¬ 
цифических классов определяют дополнительные свойства или методы, которые 
не являются отражением синтаксиса языка разметки НТМЬ. Более подробно эти 
классы и их дополнительные особенности рассматриваются в справочном разде¬ 
ле книги. 
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Наконец, обратите внимание, что на рис. 15.2 изображены некоторые типы узлов, 
которые нигде до сих пор не упоминались. Узлы СоттеггЕ представляют НТМЬ- или 
ХМЬ-комментарии. Поскольку комментарии являются обычными текстовыми 
строками, эти узлы во многом подобны узлам Тех!, представляющим отображае¬ 
мый текст документа. Тип СМагасІіегОаііа, обобщенный предок типов Техі: и Соттепі:, 
определяет методы, общие для узлов этих двух типов. Узлы типа АТТг представля¬ 
ют ХМЬ- или НТМЬ-атрибуты, но они практически никогда не используются, по¬ 
тому что класс Еіетепі определяет методы, позволяющие интерпретировать атри¬ 
буты, как пары имя/значение, а не как узлы документа. Объект ОоситепіРгадтепі: 
(не изображен на рисунке) - это разновидность узлов, которая практически нико¬ 
гда не встречается в документах: он представляет последовательность узлов, не 
имеющих общего родителя. Объекты ОоситепІіРгадтепі: удобно использовать при 
выполнении манипуляций над документами, и подробнее об этом типе рассказы¬ 
вается в разделе 15.6.4. Модель БОМ также определяет несколько редко исполь¬ 
зуемых типов, представляющих, например, объявления типа документа и инст¬ 
рукции обработки ХМЬ. 

15.2. Выбор элементов документа 

Работа большинства клиентских программ на языке Лѵа8сгірі так или иначе 
связана с манипулированием элементами документа. В ходе выполнения эти про¬ 
граммы могут использовать глобальную переменную сіоситепі:, ссылающуюся на 
объект Ооситепі. Однако, чтобы выполнить какие-либо манипуляции с элемента¬ 
ми документа, программа должна каким-то образом получить, или выбрать , 
объекты Еіетепі:, ссылающиеся на эти элементы документа. Модель БОМ опреде¬ 
ляет несколько способов выборки элементов. Выбрать элемент или элементы до¬ 
кумента можно: 

• по значению атрибута ісі; 

• по значению атрибута пате; 

• по имени тега; 

• по имени класса или классов С88; или 

• по совпадению с определенным селектором С88. 

Все эти приемы выборки элементов описываются в следующих подразделах. 

15.2.1. Выбор элементов по значению атрибута ісі 

Все НТМЬ-элементы имеют атрибуты ісі. Значение этого атрибута должно быть 
уникальным в пределах документа - никакие два элемента в одном и том же до¬ 
кументе не должны иметь одинаковые значения атрибута ісі. Выбрать элемент по 
уникальному значению атрибута ісі можно с помощью метода деіЕІетепіВуІсІО 
объекта Ооситепі. Этот метод уже использовался в примерах глав 13 и 14: 

ѵаг зесііопі = сіоситепі:.деІіЕІетепІВуІсІС'зесІіопІ "); 

Это самый простой и самый распространенный способ выборки элементов. Если 
сценарию необходимо иметь возможность манипулировать каким-то определен¬ 
ным множеством элементов документа, присвойте значения атрибутам ісі этих 
элементов и используйте возможность их поиска по этим значениям. Если потре- 
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буется отыскать более одного элемента по значению атрибута ій, можно восполь¬ 
зоваться удобной функцией деіЕІетепІізС), реализация которой приводится в при¬ 
мере 15.1. 

Пример 15.1. Поиск нескольких элементов по значениям атрибута ій 
! * * 

* Эта функция принимает произвольное количество строковых аргументов. 

* Каждый аргумент интерпретируется как значение атрибута іб элемента, 

* и для каждого из них вызывается метод босшпепі:. деТЕІешепіВуІсК ). 

* Возвращает объект, который отображает значения атрибута іб 

* в соответствующие объекты Еіешепі:. Если какое-то значение атрибута іб 

* не будет найдено в документе, возбуждает исключение Еггог. 

*/ 

Гітсііоп де{Е1етеп1:з(Л значения атрибутов ісі...*/) { 

ѵаг еіешепіз = {}; // Создать пустое отображение 

І : ог(ѵаг і = 0; і < агдіішепіз. ІепдіП; і++) { // Для каждого аргумента 
ѵаг іб = агдіішепІзЕі]; // Аргумент - іб элемента 

ѵаг еіі = доситепІ.деіЕІетепІВуІсКісІ); // Отыскать элемент 
іГ (еіі == піііі) // Если не найден, 

ІПгом пе\ѵ Еггог("Мо еіешепі: ѵѵіІИ іб: + іб); // возбудить ошибку 
еІетепІізГ ісі ] = еіі; // Отобразить ісі в элемент 

} 

геііігп еіешепіз; // Вернуть отображение іб в элементы 

} 

В версиях Іпіегпеі Ехріогег ниже ІЕ8 метод де1:Е1етеп1:ВуІ(К) выполняет поиск зна¬ 
чений атрибутов ісі без учета регистра символов и, кроме того, возвращает эле¬ 
менты, в которых будет найдено совпадение со значением атрибута пате. 

15.2.2. Выбор элементов по значению атрибута пате 

НТМЬ-атрибут пате первоначально предназначался для присваивания имен эле¬ 
ментам форм, и значение этого атрибута использовалось, когда выполнялась от¬ 
правка данных формы на сервер. Подобно атрибуту ісі, атрибут пате присваивает 
имя элементу. Однако, в отличие от ісі, значение атрибута пате не обязано быть 
уникальным: одно и то же имя могут иметь сразу несколько элементов, что впол¬ 
не обычно при использовании в формах радиокнопок и флажков. Кроме того, 
в отличие от ісі, атрибут пате допускается указывать лишь в некоторых НТМЬ- 
элементах, включая формы, элементы форм и элементы <іГгате> и <ітд>. 

Выбрать НТМЬ-элементы, опираясь на значения их атрибутов пате, можно с по¬ 
мощью метода деіЕІетепізВуМатеО объекта Оосіітепі:: 

ѵаг гасІіоЬііПопз = босцтепІ.деіЕІетепізВуМатеГІ'аѵогііе.соІог"); 

Метод деіЕІетепІізВуМатеО определяется не классом Оосіітепі:, а классом НТМЮоси- 
тепі, поэтому он доступен только в НТМЬ-документах и не доступен в ХМЬ-доку- 
ментах. Он возвращает объект Мос1еІ_ізі:, который ведет себя, как доступный толь¬ 
ко для чтения массив объектов Еіетепі. В ІЕ метод де1:Е1етеп1:5ВуМате() возвращает 
также элементы, значения атрибутов ісі которых совпадает с указанным значени¬ 
ем. Чтобы обеспечить совместимость с разными версиями броузеров, необходимо 
внимательно подходить к выбору значений атрибутов и не использовать одни и те 
же строки в качестве значений атрибутов пате и ісі . 
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Мы видели в разделе 14.7, что наличие атрибута пате в некоторых НТМЬ-элемен- 
тах приводит к автоматическому созданию свойств с этими именами в объекте 
Міпсісм. То же относится и к объекту Оосіітепі:. Наличие атрибута пате в элементе 
<^огт>, <ітд>, <і1гате>, <арр1е1:>, <етЬей> или <оЬ]есі:> (но только в элементе <оЬ]ес1:>, 
который не имеет вложенных объектов с альтернативным содержимым) приво¬ 
дит к созданию свойства в объекте Росіітепі:, имя которого совпадает со значением 
атрибута (при этом предполагается, что объект документа еще не имеет свойства 
с этим именем). 

Если существует только один элемент с указанным именем, значением автомати¬ 
чески созданного свойства документа станет сам элемент. Если таких элементов 
несколько, значением свойства будет объект МосІеНзІ:, играющий роль массива 
элементов. Как было показано в разделе 14.7, для именованных элементов <і1тате> 
создаются особые свойства документа: они ссылаются не на объекты Еіетепі:, а на 
объекты Міпсіом, представляющие фреймы. 

Это означает, что некоторые элементы могут быть выбраны по их именам про¬ 
стым обращением к свойствам объекта Ооситепі:: 

// Получить ссылку на объект Еіетепі: для элемента <1Ч)гт пате="зПірріпд_асІсІгезз"> 
ѵаг ^огт = Росіітепі:.зЬірріпд_асІсІге55 : 

Причины, почему не следует использовать автоматически создаваемые свойства 
окна, которые описываются в разделе 14.7, в равной степени применимы и к авто¬ 
матически создаваемым свойствам документа. Если вам потребуется отыскать 
именованные элементы, лучше всего это сделать явно, с помощью метода де1:Е1е- 
теп1:5ВуМате(). 

15.2.3. Выбор элементов по типу 

Метод де1:Е1етеп1:зВуТадМате() объекта Оосіітепі: позволяет выбрать все НТМЬ- или 
ХМЬ-элементы указанного типа (или по имени тега). Например, получить подоб¬ 
ный массиву объект, доступный только для чтения, содержащий объекты Еіетепі: 
всех элементов <зрап> в документе, можно следующим образом: 

ѵаг зрапз = РосіітепІ.деІіЕІетепІізВуТад^теС'зрап''); 

Подобно методу деІіЕІетепіізВуМатеО, деІіЕІетепІзВуТадМатеО возвращает объект N 0 
СІеНзІ. (Подробнее класс МосІеНзІ: описывается во врезке, в этом же разделе.) Эле¬ 
менты документа включаются в массив МосІеНз* в том же порядке, в каком они 
следуют в документе, т. е. первый элемент <р> в документе можно выбрать так: 

ѵаг І'ігзірага = Росшпепі:.деіЕ1етепІ5ВуТад^те("р")[0]; 

Имена НТМЬ-тегов не чувствительны к регистру символов, и когда де1:Е1етепі:з- 
ВуТад№те() применяется к НТМЬ-документу, он выполняет сравнение с именем 
тега без учета регистра символов. Переменная зрапз, созданная выше, например, 
будет включать также все элементы <зрап>, которые записаны как <8РАМ>. 

Можно получить МогіеНз*, содержащий все элементы документа, если передать 
методу де1:Е1етепі:зВуТад№те() шаблонный символ «*». 

Кроме того, классом Еіетепі: также определяет метод де1:Е1етепі:5ВуТад№те(). Он 
действует точно так же, как и версия метода в классе Оосіітепі:, но выбирает толь¬ 
ко элементы, являющиеся потомками для элемента, относительно которого вы- 
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зывается метод. То есть отыскать все элементы <$рап> внутри первого элемента 
<р> можно следующим образом: 

ѵаг Гігзірага = сіосіітепі:.де1:Е1етеп1:5ВуТадМате( ,, р")[0]; 
ѵаг ГігзІіРагаЗрапз = ГігзІрага.деІЕІетепізВуТадМатеС’зрап"); 

По историческим причинам класс НТМЮосіітепі: определяет специальные свойства 
для доступа к узлам определенных типов. Свойства ітадез, Гогтз и Ііпкз, напри¬ 
мер, ссылаются на объекты, которые ведут себя как массивы, доступные только 
для чтения, содержащие элементы <ітд>, <Гогт> и <а> (но только те теги <а>, кото¬ 
рые имеют атрибут ИгеГ). Эти свойства ссылаются на объекты НТМЮоПесИоп, ко¬ 
торые во многом похожи на объекты МосІеНзІ, но дополнительно могут индексиро¬ 
ваться значениями атрибутов ісі и пате. Ранее мы узнали, как можно получить 
ссылку на именованный элемент <Гогт> с помощью такого выражения: 

сіосіітепі:. зИірріпд_ас1с1гез5 

С помощью свойства сіосіітепі:. -Рогтз обращение к форме, имеющей атрибут пате 
(или ІР), можно записать более явно: 

сіосіітепі:. Гогтз. зИірріпд_аРРгезз; 

Объект НТМЮоситепІ: также определяет свойства-синонимы етЬеРз и ріидіпз, яв¬ 
ляющиеся коллекциями НТМІ_Со11ес1:іоп элементов <етЬеР>. Свойство апсіпогз явля¬ 
ется нестандартным, но с его помощью можно получить доступ к элементам <а>, 
имеющим атрибут пате, но не имеющим атрибут ИгеГ. Свойство зсгіріз определено 
стандартом НТМЬб и является коллекцией НТМЮоПесИоп элементов <зсгір1:>, но 
к моменту написания этих строк оно было реализовано не во всех броузерах. 

Кроме того, объект НТМЮосіітепі: определяет два свойства, каждое из которых ссы¬ 
лается не на коллекцию, а на единственный элемент. Свойство сіосіітепі:. ЬоРу пред¬ 
ставляет элемент <ЬоРу> НТМЬ-документа, а свойство сіосіітепі:. ИеаР - элемент <1пеаР>. 
Эти свойства всегда определены в документе: даже если в исходном документе от¬ 
сутствуют элементы <ИеаР> и <ЬоРу>, броузер создаст их неявно. Свойство Росіітепі:- 
Еіетепі: объекта Ооситепі: ссылается на корневой элемент документа. В НТМЬ-до- 
кументах он всегда представляет элемент <Іі*т1>. 


Объекты ІЧосіеиБ* и НТМЬСоИесИоп 

Методы деіЕІетепізВуМатеО и деіЕІетепізВуТадМатеО возвращают объекты 
МосІеНзі, а такие свойства, как сіосіітепі:.ітадез и сіосіітепі:. Гогтз, являются 
объектами НТМІ_Со11ес1:іоп. 

Эти объекты являются объектами, подобными массивам, доступным толь¬ 
ко для чтения (раздел 7.11). Они имеют свойство 1епд1:Гі и могут индексиро¬ 
ваться (только для чтения) подобно настоящим массивам. Содержимое объ¬ 
екта МоРеИзІ: или НТМЮоІІесііоп можно обойти с помощью стандартного 
цикла, например: 

Гог(ѵаг і = 0; і < сіосіітепі:. ітадез. ІепдІИ; і++) // Обойти все изобр. 
сіосіітепі:. Ітадез[і].з1:у1е.с1ізр1ау = "попе"; // ...и скрыть их. 
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Для объектов Мойеілзі: и НТМІ_Со11ес*іоп нельзя непосредственно вызывать 
методы класса Аггау, но их можно вызывать косвенно: 

ѵаг сотепі = Аггау. ргоіоіуре. шар.са11( 

сіосіішепі: . деіЕ1етеп1:5ВуТад№те( "р"), 

І'ііпсІіопСе) { геііігп е. ігтегНТМ!.; }); 

Объекты НТМІ_Со11ес1:іоп могут иметь дополнительные именованные свойст¬ 
ва и могут индексироваться не только числами, но и строками. 

По историческим причинам оба объекта, Мойеілз* и НТМЮоІІесІііоп, могут 
также играть роль функций: вызов их с числовым или строковым аргумен¬ 
том равносилен операции индексирования числом или строкой. Однако ис¬ 
пользование этой причудливой особенности может сбивать с толку. 

Интерфейсы обоих объектов, МосІеНз* и НТМЮоІІесІііоп, проектировались 
под другие языки программирования, не такие динамические, как Лѵа- 
Всгірі. Оба определяют метод І1:ет(). Он принимает целое число и возвра¬ 
щает элемент с этим индексом. Однако в программах на языке Лѵа8сгірі 
нет нужды использовать этот метод, так как можно использовать простую 
операцию индексирования массива. Аналогично НТМІ_Со11ес1:іоп определяет 
метод патесШ:ет(), возвращающий значение именованного свойства, но 
в программах на языке Лѵа8сгірі вместо него можно использовать опера¬ 
ции индексирования массива и обращения к свойствам. 

Одна из наиболее важных и интересных особенностей объектов МосІеНзі: 
и НТМІ_Со11ес1:іоп состоит в том, что они не являются статическими слепками 
документа, а продолжают «жить», и списки элементов, которые они пред¬ 
ставляют, изменяются по мере изменения документа. Если вызвать метод 
деі:Е1етепі:зВуТадМате( сііѵ' ) для документа, в котором отсутствуют элементы 
<с!іѵ>, он вернет объект МосІеІ_і5*, свойство ІепдІіИ которого будет равно 0. Ес¬ 
ли затем вставить в документ новый элемент <с!іѵ>, этот элемент автомати¬ 
чески станет членом коллекции МойеИзІ:, а ее свойство ІепдііИ станет равно 1. 

Обычно такая динамичность элементов МосІеНз* и НТМЮоІІесІііоп бывает 
весьма полезна. Однако если добавлять или удалять элементы из докумен¬ 
та в процессе итераций по коллекции МоСІеНзі, потребуется предваритель¬ 
но создать статическую копию объекта МосІеНзІ: 

ѵаг зпарзііоі: = Аггау. ргоіоіуре.зіісе.саЩпосІеІізІ:, 0); 


15.2.4. Выбор элементов по классу С55 

Значением НТМЬ-атрибута сіазз является список из нуля или более идентифика¬ 
торов, разделенных пробелами. Он дает возможность определять множества свя¬ 
занных элементов документа: любые элементы, имеющие в атрибуте сіазз один 
и тот же идентификатор, являются частью одного множества. Слово сіазз заре¬ 
зервировано в языке ^ѵаЗсгірі, поэтому для хранения значения НТМЬ-атрибута 
сіазз в клиентском Лѵа8сгірі используется свойство сІаззМате. Обычно атрибут 
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сіазз используется вместе с каскадными таблицами стилей С88, с целью приме¬ 
нить общий стиль отображения ко всем членам множества, и мы еще будем рас¬ 
сматривать эту тему в главе 16. Однако кроме этого, стандарт НТМЬб определяет 
метод деІЕІетепІізВуСІаззМатеО, позволяющий выбирать множества элементов до¬ 
кумента на основе идентификаторов в их атрибутах сіазз. 

Подобно методу деШетеп1:зВуТадМате(), метод деШетепі:зВуС1аззМате() может вы¬ 
зываться и для НТМЬ-документов, и для НТМЬ-элементов, и возвращает «жи¬ 
вой» объект МосІеІ_і5*, содержащий все потомки документа или элемента, соответ¬ 
ствующие критерию поиска. Метод деІЕІетепІізВуСІаззМатеО принимает единст¬ 
венный строковый аргумент, но в самой строке может быть указано несколько 
идентификаторов, разделенных пробелами. Соответствующими будут считаться 
все элементы, атрибуты сіазз которых содержат все указанные идентификаторы. 
Порядок следования идентификаторов не имеет значения. Обратите внимание, 
что и в атрибуте сіазз, и в аргументе метода де1:Е1етеп1:зВуС1аззМате() идентифика¬ 
торы классов разделяются пробелами, а не запятыми. Ниже приводится несколь¬ 
ко примеров использования метода деі:Е1етеп1:зВуС1аззМате(): 

// Отыскать все элементы с идентификатором "магпіпд" в атрибуте сіазз 
ѵаг магпіпдз = сІосишепі.деіЕІешепІзВуСІаззМашеС'ѵѵагпіпд"); 

// Отыскать всех потомков элемента с именем "Іод" с идентификаторами "еггог" 

// и "■Ра*аГ' в атрибуте сіазз 

ѵаг Іод = Роситеп1.деІЕ1ешепІВуІс1("1од"); 

ѵаг Га1:а1 = Іод. деІЕІетепізВуСІаззМатеС’І'аіаІ еггог"); 

Современные броузеры отображают НТМЬ-документы в «режиме совместимо¬ 
сти» или в «стандартном режиме», в зависимости от строгости объявления <! ПОС¬ 
ТУ РЕ> в начале документа. Режим совместимости поддерживается для сохранения 
обратной совместимости, и одна из его особенностей состоит в том, что идентифи¬ 
каторы классов в атрибуте сіазз и каскадных таблицах стилей С88 нечувстви¬ 
тельны к регистру символов. Метод деІЕІетепІізВуСІаззМатеО следует алгоритму 
сопоставления, используемому таблицами стилей. Если документ отображается 
в режиме совместимости, метод сравнивает строки без учета регистра символов. 
В противном случае сравнение выполняется с учетом регистра символов. 

К моменту написания этих строк метод де1:Е1етеп1:5ВуС1аззМате() был реализован 
во всех текущих броузерах, за исключением ІЕ8 и более ранних версий. Однако 
ІЕ8 поддерживает метод дііегу8е1ес1:огА11(), описываемый в следующем разделе, 
на основе которого можно реализовать метод деІЕІетепіізВуСІаззМатеО. 

15.2.5. Выбор элементов с использованием 
селекторов С55 

Каскадные таблицы стилей С88 имеют очень мощные синтаксические конструк¬ 
ции, известные как селекторы , позволяющие описывать элементы или множест¬ 
ва элементов документа. Полное описание синтаксиса селекторов С88 выходит 
далеко за рамки этой книги 1 , однако несколько примеров помогут прояснить их 
основы. Элементы можно описать с помощью имени тега и атрибутов ій и сіазз: 


1 Определение селекторов С883 можно найти по адресу НИр://ююіи.іѵ3.огд/ТЕ/с883-8еІес- 

ІОГ8/. 
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#паѵ // Элемент с атрибутом ігі=”паѵ*‘ 

сііѵ // Любой элемент <сііѵ> 

.магпіпд // Любой элемент с идентификатором "магпіпд" в атрибуте сіазз 

В более общем случае элементы можно выбирать, опираясь на значения атрибутов: 

р[1апд="1т'' ] // Абзац с текстом на французском языке: <р 1апд="1 : г"> 

*[паше="х"] // Любой элемент с атрибутом паше= "х’' 

Эти простейшие селекторы можно комбинировать: 

зрап. ^а*а1. еггог // Любой элемент <зрап> с классами "Раіаі" и "еггог" 

зрап[1апд="1 : г , '].\ѵагпіпд // Любое предупреждение на французском языке 

С помощью селекторов можно также определять взаимоотношения между эле¬ 
ментами: 

#1од зрап // Любой элемент <зрап>, являющийся потомком элемента с іс!="1од" 

#1од>5рап // Любой элемент <зрап>, дочерний по отношению к элементу с ісІ=”1од" 

Ьойу>М: Рігзі-сИіісі // Первый элемент <М>, дочерний по отношению к <ЬосІу> 

Селекторы можно комбинировать для выбора нескольких элементов или мно¬ 
жеств элементов: 

сііѵ, #1од // Все элементы <сііѵ> плюс элемент с ісІ= ' Іод" 

Как видите, селекторы С88 позволяют выбирать элементы всеми способами, опи¬ 
санными выше: по значению атрибута ісі и пате, по имени тега и по имени класса. 
Наряду со стандартизацией селекторов С883, другой стандарт консорциума АѴЗС, 
известный как «8е1есіогз АРІ» (АРІ селекторов), определяет методы Лѵа8сгірі 
для получения элементов, соответствующих указанному селектору. 1 Ключевым 
в этом АРІ является метод диегуЗе1ес1:огА11() объекта Оосіітепі:. Он принимает един¬ 
ственный строковый аргумент с селектором С88 и возвращает объект Мосіеілзі:, 
представляющий все элементы документа, соответствующие селектору. В отли¬ 
чие от ранее описанных методов выбора элементов, объект МосіеИзІ:, возвращае¬ 
мый методом диегуЗе1есі:огА11( ), не является «живым»: он хранит элементы, кото¬ 
рые соответствовали селектору на момент вызова метода, и не отражает после¬ 
дующие изменения в документе. В случае отсутствия элементов, соответствую¬ 
щих селектору, метод дііегуЗе1ес1:огА11() вернет пустой МосіеИзІ:. Если методу 
диегуЗе1ес1:огА11() передать недопустимую строку, он возбудит исключение. 

В дополнение к методу дііегуЗе1ес1:огА11( ) объект документа также определяет ме¬ 
тод дііегуЗе1ес1:ог(), подобный методу дііегуЗе1ес1:огА11(), - с тем отличием, что он 
возвращает только первый (в порядке следования в документе) соответствующий 
элемент или пиіі, в случае отсутствия соответствующих элементов. 

Эти два метода также определяются классом Е1етепі:з (и классом 0осіітеп1:Ргадтеп1:, 
о котором рассказывается в разделе 15.6.4). Когда они вызываются относительно 
элемента, поиск соответствия заданному селектору выполняется во всем докумен¬ 
те, а затем результат фильтруется так, чтобы в нем остались только потомки ис¬ 
пользованного элемента. Такой подход может показаться противоречащим здра¬ 
вому смыслу, так как он означает, что строка селектора может включать предков 
элемента, для которого выполняется сопоставление. 


1 Стандарт «Зеіесіогз АРІ» не является частью стандарта НТМЬб, но тесно связан с ним. 
Подробности смотрите по адресу Ніір://іѵіѵіѵ.іѵ3.ог§/ТЕ/8еІесіог8-арі/. 
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Обратите внимание, что стандарт С88 определяет псевдоэлементы :Гіг$1:-1іпе 
и :Гігз*-1е**ег. В С88 им соответствуют не фактические элементы, а части тексто¬ 
вых узлов. Они не будут обнаруживать совпадений, если использовать их вместе 
с методом діюгу8е1ес1:огА11() или діюгуЗе1ес1:ог(). Кроме того, многие броузеры не 
возвращают результатов сопоставления с псевдоклассами :1іпк и : ѵівіііесі, потому 
что в противном случае это позволило бы получить информацию об истории посе¬ 
щений страниц пользователем. 

Методы дііегуЗе1есі:ог() и диегуЗе1ес1:огА11() поддерживают все текущие броузеры. 
Тем не менее обратите внимание, что спецификации этих методов не требуют под¬ 
держки селекторов С883: производителям броузеров предлагается реализовать 
поддержку того же набора селекторов, который поддерживается в каскадных 
таблицах стилей. Текущие броузеры, кроме ІЕ, поддерживают селекторы С883. 
ІЕ7 и 8 поддерживают селекторы С882. (Ожидается, что ІЕ9 будет поддерживать 
С883.) 

Метод дііегуЗе1ес1:огА11() является идеальным инструментом выбора элементов: 
это очень мощный механизм, с помощью которого клиентские программы на 
языке Лѵа8сгірі могут выбирать элементы документа для выполнения операций 
над ними. К счастью, селекторы С88 можно использовать даже в броузерах, не 
имеющих собственной поддержки метода дііегу5е1есі:огА11(). Похожий механизм 
запросов на основе селекторов в библиотеке іС^иегу (глава 19) является централь¬ 
ной парадигмой программирования. Веб-приложения на основе іС^иегу могут ис¬ 
пользовать переносимый, совместимый с разными типами броузеров эквивалент 
метода діюгуЗе1ес1:огА11(), который называется $(). 

Программный код, выполняющий в библиотеке іС^иегу сопоставление с селекто¬ 
рами С88, был реструктурирован и вынесен в самостоятельную библиотеку с име¬ 
нем Зіггіе, которая была заимствована фреймворком Боіо и другими клиентски¬ 
ми библиотеками. 1 Преимущество использования библиотек, таких как Зіггіе 
(или библиотек, использующих Зіггіе), в том, что выбор элементов можно произ¬ 
водить даже в старых броузерах, и при этом обеспечивается поддержка базового 
набора селекторов, которые гарантированно будут работать во всех броузерах. 

15.2.6. сІоситеп1.аІІ[] 

До того, как модель БОМ была стандартизована, в ІЕ4 была реализована коллек¬ 
ция сіоситепі:. а11[], представляющая все элементы (кроме текстовых узлов Тех*) 
в документе. Впоследствии коллекцию сіоситепі:. а11[] заменили стандартные ме¬ 
тоды, такие как де*Е1етеп1:ВуІсі() и де*Е1етеп1:$ВуТад№те(), и теперь она считается 
устаревшей и не должна использоваться. Однако в свое время появление этой 
коллекции произвело целую революцию, и даже сейчас все еще можно встретить 
сценарии, использующие ее следующими способами: 

сіоситепі: . аіі [ 0 ] // Первый элемент документа 

сіоситепі:.а11["паѵЬаг"] // Элемент (или элементы) со значением "паѵЬаг” 

// в атрибуте ісі или пате 
сіоситепі:.аіі.паѵЬаг // То же самое 

сіоситепі:. аіі. ІадзС'сііѵ" ) // Все элементы <с!іѵ> в документе 
сіоситепі.аіі.*адз("р”)[0] // Первый элемент <р> в документе 


1 Самостоятельная версия библиотеки Зіггіе доступна по адресу Мір://8іггІе]8.сот . 
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15.3. Структура документа и навигация 
по документу 

После выбора элемента документа иногда бывает необходимо отыскать структур¬ 
но связанные части документа (родитель, братья, дочерний элемент). Объект Ооси- 
тепі можно представить как дерево объектов Мойе, как изображено на рис. 15.1. 
Тип Мойе определяет свойства, позволяющие перемещаться по такому дереву, ко¬ 
торые будут рассматриваться в разделе 15.3.1. Существует еще один прикладной 
интерфейс навигации по документу, как дерева объектов Еіетепі. Этот более но¬ 
вый (и часто более простой в использовании) прикладной интерфейс рассматри¬ 
вается в разделе 15.3.2. 

15.3.1. Документы как деревья узлов 

Объект Оосіітепі, его объекты Еіетепі и объекты Техі, представляющие текстовые 
фрагменты в документе, - все они являются объектами Мойе. Класс Мойе определя¬ 
ет следующие важные свойства: 

рагепІМойе 

Родительский узел данного узла или піііі для узлов, не имеющих родителя, 
таких как Оосіітепі. 

сІпіІйМойез 

Доступный для чтения объект, подобный массиву (МойеІ_із1), обеспечивающий 
«живое» представление дочерних узлов. 

1іг$і(М1й, 1а$1(М1й 

Первый и последний дочерние узлы или піііі, если данный узел не имеет до¬ 
черних узлов. 

пехІЗіЬІіпд, ргеѵіоизЗіЬІіпд 

Следующий и предыдущий братские узлы. Братскими называются два узла, 
имеющие одного и того же родителя. Порядок их следования соответствует 
порядку следования в документе. Эти свойства связывают узлы в двусвязный 
список. 

пойеТуре 

Тип данного узла. Узлы типа Оосіітепі: имеют значение 9 в этом свойстве. Узлы 
типа Еіетепі - значение 1. Текстовые узлы типа Техі - значение 3. Узлы типа 
Соттепіз - значение 8 и узлы типа ОоситепіРгадтепі - значение 11. 

пойеѴаІие 

Текстовое содержимое узлов Техі и Соттепі. 
пойеМате 

Имя тега элемента Еіетепі, в котором все символы преобразованы в верхний 
регистр. 

С помощью этих свойств класса Мойе можно сослаться на второй дочерний узел 
первого дочернего узла объекта Оосіітепі, как показано ниже: 

йоситепі . сІіі1йМойез[0] . сІчі1йМойез[ 1 ] 
йоситепі. ІігзіСІііІй. ІігзіСПіІй. пехІЗіЬІіпд 
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Допустим, что рассматриваемый документ имеет следующий вид: 

<^1т1><йеай><1і11е>Те5І</1і11е></Гіеай><Ьойу>Не11о Ѵі/огій! </ЬосІу></И1:т1> , 

Тогда вторым дочерним узлом первого дочернего узла будет элемент <Ьойу>. В свой¬ 
стве пойеТуре он содержит значение 1 и в свойстве пойеМате - значение «ВСЮѴ». 

Однако, обратите внимание, что этот прикладной интерфейс чрезвычайно чувст¬ 
вителен к изменениям в тексте документа. Например, если в этот документ доба¬ 
вить единственный перевод строки между тегами <Іп1т1> и <Иеасі>, этот символ пе¬ 
ревода строки станет первым дочерним узлом (текстовым узлом Тех!) первого до¬ 
чернего узла, а вторым дочерним узлом станет элемент <Иеай>, а не <Ьойу>. 

15.3.2. Документы как деревья элементов 

Когда основной интерес представляют сами элементы документа, а не текст в них 
(и пробельные символы между ними), гораздо удобнее использовать прикладной 
интерфейс, позволяющий интерпретировать документ как дерево объектов Еіе¬ 
тепі, игнорируя узлы Техі и Соттепі, которые также являются частью документа. 

Первой частью этого прикладного интерфейса является свойство сіпіійгеп объек¬ 
тов Еіетепі. Подобно свойству сІпіІйМойез, его значением является объект МойеІ_і$1. 
Однако, в отличие от свойства сІпіІйМойез, список сіпіійгеп содержит только объек¬ 
ты Еіетепі. Свойство сіііійгеп - нестандартное свойство, но оно реализовано во 
всех текущих броузерах. В ІЕ это свойство было реализовано уже очень давно, 
и большинство других броузеров последовали его примеру. Последним основным 
броузером, реализовавшим его, стал ГігеТох 3.5. 

Обратите внимание, что узлы Техі и Соттепі не имеют дочерних узлов. Это означает, 
что описанное выше свойство Мойе. рагепіМойе никогда не возвращает узлы типа Техі 
или Соттепі. Значением свойства рагепіМойе любого объекта Еіетепі всегда будет 
другой объект Еіетепі или корень дерева - объект йоситепі или ОоситепІЕгадтепІ. 

Второй частью прикладного интерфейса навигации по элементам документа яв¬ 
ляются свойства объекта Еіетепі, аналогичные свойствам доступа к дочерним 
и братским узлам объекта Мойе: 

ІігзІЕІетепШііІй, 1а$1Е1етепіСІіі1й 

Похожи на свойства ІігзіСІпіІй и ІазіСИіІй, но возвращают дочерние элементы. 

пехіЕІетепІЗіЫіпд, ргеѵіоизЕІетепІЗіЫіпд 

Похожи на свойства пехІЗіЬІіпд и ргеѵіоизЗіЬІіпд, но возвращают братские эле¬ 
менты. 

сІпіІйЕІетепіСоипІ 

Количество дочерних элементов. Возвращает то же значение, что и свойство 
сіпіійгеп. ІепдІГі. 

Эти свойства доступа к дочерним и братским элементам стандартизованы и реа¬ 
лизованы во всех текущих броузерах, кроме ІЕ. 1 

Поскольку прикладной интерфейс навигации по элементам документа реализо¬ 
ван не во всех броузерах, вам может потребоваться определить переносимые 
функции навигации, как в примере 15.2. 


1 Ніір://іѵіѵіѵ.іѵ3.ог§/ТК/ЕІетпепіТгаѵег8аІ. 
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Пример 15.2. Переносимые функции навигации по документу 

! ** 

* Возвращает ссылку на п-го предка элемента е или піііі, если нет такого предка 

* или если этот предок не является элементом Еіешепі: 

* (например, Оосіітепі: или ОосшпепіРгадтепІ:). 

* Если в аргументе п передать 0, функция вернет сам элемент е. 

* Если в аргументе п передать 1 (или вообще опустить этот аргумент), 

* функция вернет родительский элемент. 

* Если в аргументе п передать 2, функция вернет родителя родительского элемента и т. д. 

V 

ГііпсГіоп рагепКе, п) { 

іГ (п === ііпбеГіпеб) п = 1; 

^і1е(п-- && е) е = е.рагепГМобе; 
іГ (!е || е.побеТуре !== 1) геііігп піііі; 
геііігп е; 

} 

! * * 

* Возвращает п-й братский элемент элемента е. 

* Если в аргументе п передать положительное число, функция вернет следующий 

* п-й братский элемент. 

* Если в аргументе п передать отрицательное число, функция вернет предыдущий 

* п-й братский элемент. 

* Если в аргументе п передать ноль, функция вернет сам элемент е. 

V 

ГііпсГіоп 5іЫіпд(е,п) { 

\л/М1е(е && п !== 0) { // Если е не определен, просто вернуть его 

ІГ (п > 0) { // Отыскать следующий братский элемент 

іГ (е. пехГЕІетепГЗіЫіпд) е = е. пехГЕІетепГЗіЫіпд; 
еізе { 

Гог(е=е. пехГЗіЫіпд; е && е.побеТуре !== 1; е=е. пехГЗіЫіпд) 

/* пустой цикл */ ; 

} 

п—; 

} 

еізе { // Отыскать предыдущий братский элемент 

іГ (е. ргеѵіоіізЕІешепГЗіЬіпд) е = е. ргеѵіоіізЕІешепГЗіЫіпд; 
еізе { 

Гог(е=е. ргеѵіоіізЗіЫіпд; е&&е. побеТуре! ==1; е=е. ргеѵіоіізЗіЫіпд) 

/* пустой цикл */ ; 

} 

п++; 

} 

} 

геііігп е; 

} 

! ** 

* Возвращает п-й дочерний элемент элемента е или піііі, если нет такого 

* дочернего элемента. 

* Если в аргументе п передать отрицательное число, поиск дочернего элемента 

* будет выполняться с конца. О соответствует первому дочернему элементу, 

* но -1 - последнему, -2 - второму с конца и т. д. 

V 
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Гііпсііоп сЬі1сІ(е, п) { 

іГ (е. сіпіісігеп ) { // Если массив сіпіісігеп существует 

і Г (п < 0) п += е. сГііісі геп. ІепдіЬ; // Преобразовать отрицательное 

// число в индекс массива 

іГ (п < 0) геііігп пиіі ; // Если получилось отрицательное число, 

// значит, нет такого дочернего элемента 
геііігп е. сЫ1с!геп[п]; // Вернуть заданный дочерний элемент 

} 

// Если элемент е не имеет массива сЬіІсІгеп, начать поиск с первого 
// дочернего элемента, двигаясь вперед, или начать поиск с последнего 
// дочернего элемента, двигаясь назад. 

іГ(п>=0){//п- положительное: двигаться вперед, начиная с первого 
// Найти первый дочерний элемент элемента е 
іГ (е. ГігзіЕІетепіСЬіІсІ) е = е. ГігзІЕІетепіСЬіІсІ; 
еізе { 

Гог(е = е. ГігзіСЬіісі; е && е.пойеТуре !== 1; е = е. пехіЗіЫіпд) 

/* пустой цикл */; 

} 

геііігп зіЫіпд(е, п); // Вернуть п-го брата первого дочернего элемента 

} 

еізе { // п - отрицательное: двигаться назад, начиная с последнего 
іГ (е. ІазіЕІетепіСЬіІсІ) е = е. ІазіЕІетепіСЬіІсІ; 
еізе { 

Гог(е = е. ІазіСЬіІР; е && е.пойеТуре !== 1; е=е. ргеѵіоіізЗіЫіпд) 

/* пустой цикл */; 

} 

геііігп зіЫіпд(е, п+1); // +1, чтобы преобразовать номер -1 дочернего 

// в номер 0 братского для последнего 


} 


} 


Определение собственных методов элементов 

Все текущие броузеры (включая ІБ8 и выше) реализуют модель БОМ таким 
образом, что такие типы, как Еіетепі: и НТМЮоситеп* 1 , являются классами, та¬ 
кими же как классы Зігіпд и Аггау. Они не имеют конструкторов (как созда¬ 
вать новые объекты Еіетепі:, будет показано далее в этой главе), но они име¬ 
ют объекты-прототипы, которые вы можете расширять своими методами: 

Еіетепі.ргоіоіуре.пехі = ГітсііопО { 

іГ (іЬіз. пехіЕІетепіЗіЫіпд) геііігп ІЬіз. пехіЕІетепіЗіЫіпд; 
ѵаг зіЬ = іЬіз. пехіЗіЫіпд; 

иЬі1е(зіЬ && зіЬ. посІеТуре !== 1) зіЬ = зіЬ.пехіЗіЫіпд; 
геііігп зіЬ; 

>: 


1 ІЕ8 поддерживает возможность расширения прототипов объектов Еіетепі:, НТМЮоситепі 
и Техі, но не поддерживает для объектов N0(16, Ооситепі, НТМІ_Е1етеп1: и всех подтипов ти¬ 
па НТМІ_Е1етеп1:. 
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Функции, представленные в примере 15.2, не были реализованы в виде ме¬ 
тодов объекта Еіетепі лишь по той причине, что такая возможность не под¬ 
держивается в ІБ7. 

Однако возможность расширения типов БОМ может пригодиться для реа¬ 
лизации особенностей, характерных для ІЕ, в других броузерах. Как отме¬ 
чалось выше, нестандартное свойство сіпіісігеп объекта Еіетепі: было впер¬ 
вые реализовано в ІЕ и только потом - в других броузерах. Используя сле¬ 
дующий программный код, можно реализовать это свойство в броузерах, 
не поддерживающих его, таких как Еігеіох 3.0: 

// Реализация свойства Еіетепі:.сйіісігеп в броузерах, 

// не поддерживающих его 

// Обратите внимание, что этот метод возвращает статический 

// массив, а не "живой" І№сІеІ_і8І 

іі (! сіоситепі.сіосіітепі Еіетепі.сіііісігеп) { 

Еіетепі.ргоіоіуре._сіеііпебеііег_("сігіісігеп", ІипсІіопО { 

ѵаг кісіз = []; 

Іог(ѵаг с = ІГііз. ІігзіСМІсІ; с != піііі; с = с. пехіЗіЫіпд) 
іі (с.поРеТуре === 1) кісіз.ріізіі(с); 
геііігп кісіз: 

}): 

} 

Метод _ (ІеІ'іпеОеІІег _(о нем рассказывается в разделе 6.7.1) не является 

стандартным, но его вполне можно использовать для обеспечения перено¬ 
симости в таком программном коде, как этот. 


15.4. Атрибуты 

НТМЬ-элементы состоят из имени тега и множества пар имя/значение, извест¬ 
ных как атрибуты. Например, элемент <а>, определяющий гиперссылку, в качест¬ 
ве адреса назначения ссылки использует значение атрибута Иге^. Значения атри¬ 
бутов НТМЬ-элементов доступны в виде свойств объектов НТМІ_Е1етепІ, представ¬ 
ляющих эти элементы. Кроме того, модель БОМ определяет и другие механизмы 
получения и изменения значений ХМЬ-атрибутов и нестандартных НТМЬ-атри- 
бутов. Подробнее об этом рассказывается в следующих подразделах. 

15.4.1. НТМЬ-атрибуты как свойства объектов Еіетепі 

Объекты НТМІ_Е1етепІ, представляющие элементы НТМЬ-документа, определяют 
свойства, доступные для чтения/записи, соответствующие НТМЬ-атрибутам эле¬ 
ментов. Объект НТМІ_Е1етепІ определяет свойства для поддержки универсальных 
НТТР-атрибутов, таких как ісі, Ііііе, Іапд и сііг, и даже свойства-обработчики со¬ 
бытий, такие как опсііск. Специализированные подклассы класса Еіетепі опреде¬ 
ляют атрибуты, характерные для представляемых ими элементов. Например, уз¬ 
нать ШІЬ-адрес изображения можно, обратившись к свойству зге объекта НТМ1_- 
Еіетепі, представляющего элемент <ітд>: 
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ѵаг ітаде = сіоситепі:. деіЕІетепіВуІсІС'туітаде"); 

ѵаг ітдіігі = ітаде. зге; // Атрибут зге определяет ІЖІ_-адрес изображения 
ітаде. ісі === "туітаде" // Потому что поиск элемента выполнялся по ісі 

Аналогично можно устанавливать атрибуты элемента <Гогт>, определяющие по¬ 
рядок отправки формы: 

ѵаг Г = сіоситепі:. Го гтз[0]; // Первый элемент <Гогт> в документе 

Г.асііоп = "М1р://шм. ехатріе. сот/зиЬтіі. рМр"; // Установить ІІРЬ отправки. 

Г. теТГіосІ = 'РОЗТ"; // Тип НТТР-запроса 

Имена атрибутов в разметке НТМЬ не чувствительны к регистру символов, в от¬ 
личие от имен свойств в языке ЛѵаЗсгірі. Чтобы преобразовать имя атрибута 
в имя свойства в языке ^ѵаЗсгірі, его нужно записать символами в нижнем реги¬ 
стре. Однако, если имя атрибута состоит из более чем одного слова, первый сим¬ 
вол каждого слова, кроме первого, записывается в верхнем регистре, например: 
йеГаиГЕСИескей и ГаЫпйех. 

Имена некоторых НТМЬ-атрибутов совпадают с зарезервированными словами 
языка ЛѵаЗсгірі. Имена свойств, соответствующих таким атрибутам, начинают¬ 
ся с приставки «МтЬ. Например, НТМЬ-атрибуту Гог (элемента <1аЬе1>) в языке 
ЛѵаЗсгірі соответствует свойство с именем ИГтІЕог. Очень важный НТМЬ-атрибут 
сіазг, имя которого совпадает с зарезервированным (но не используемым) в язы¬ 
ке Лѵабсгірі словом «сіазг», является исключением из этого правила: в про¬ 
граммном коде на языке ^ѵа8сгірі ему соответствует свойство сІаззМаше. Мы еще 
встретимся со свойством с1а$з№те в главе 16. 

Свойства, представляющие НТМЬ-атрибуты, обычно имеют строковые значения. 
Если атрибут имеет логическое или числовое значение (например, атрибуты йеГа- 
иІГСвескей и тахЬепдГИ элемента <іприГ>), значением соответствующего свойства бу¬ 
дет логическое или числовое значение, а не строка. Значениями атрибутов обра¬ 
ботчиков событий всегда являются объекты ЕипсГіоп (или пиіі). Спецификация 
НТМЬб определяет несколько атрибутов (таких как атрибут Гогт элемента <іприГ> 
и родственных ему элементов), которые преобразуются в фактические объекты 
Еіешепі:. Наконец, значением свойства $Гу1е любого НТМЬ-элемента является объ¬ 
ект СЗЗЗГуІеОесІагаГіоп, а не строка. Поближе с этим важным свойством мы позна¬ 
комимся в главе 16. 

Обратите внимание, что основанный на свойствах прикладной интерфейс полу¬ 
чения доступа к значениям атрибутов не позволяет удалять атрибуты из элемен¬ 
тов. В частности, для этих целей нельзя использовать оператор йеІеГе. Для этой 
цели можно использовать прием, который описывается в следующем разделе. 

15.4.2. Доступ к нестандартным НТМІ_-атрибутам 

Как описывалось выше, тип НТМ1_Е1етеп1: и его подтипы определяют свойства, со¬ 
ответствующие стандартным атрибутам НТМЬ-элементов. Однако тип Еіетепі: 
определяет дополнительные методы деГАГГгіЬиГеО и зеГАГГгіЬиГе(), которые мож¬ 
но использовать для доступа к нестандартным НТМЬ-атрибутам, а также обра¬ 
щаться к атрибутам элементов ХМЬ-документа: 

ѵаг ітаде = сіоситепі: . ітадез[0]; 

ѵаг місИМ = рагзеІпі(ітаде.деГАПгіЬи1:е("Іл/І0ТН")); 

ітаде. зеГАПгіЬиіеС'сІазз", "ІГштЬпаіІ"); 
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Пример выше демонстрирует два важных отличия между этими методами и при¬ 
кладным интерфейсом, основанным на свойствах и описанным выше. Во-пер¬ 
вых, значения всех атрибутов они интерпретируют как строки. Метод деІАИгі- 
Ьи1е() никогда не вернет число, логическое значение или объект. Во-вторых, эти 
методы принимают стандартные имена атрибутов, даже если они совпадают с за¬ 
резервированными словами языка Лѵабсгірі. Имена атрибутов НТМЬ-элемен- 
тов нечувствительны к регистру символов. 

Класс Еіетепі: также определяет два родственных метода, ІіазАИгіЬЩеО и гетоѵе- 
АИгіЬи1е( ). Первый из них проверяет присутствие атрибута с указанным именем, 
а второй удаляет атрибут. Эти методы особенно удобны при работе с логическими 
атрибутами: для этих атрибутов (таких как атрибут (ІізаЫесІ НТМЬ-форм) важно 
их наличие или отсутствие в элементе, а не их значения. 

Если вам приходится работать с ХМЬ-документами, содержащими атрибуты из 
других пространств имен, вы можете использовать варианты этих четырех мето¬ 
дов, позволяющие указывать имя пространства имен: деІАИгіЬиІеМЗО, зеІАИгі- 
Ьи*е№(), йазА«гіЬи*еМЗ() и гетоѵеА**гіЬи*еМ5(). Вместо единственного строкового 
аргумента с именем атрибута эти методы принимают два аргумента. В первом пе¬ 
редается ШП-идентификатор, определяющий пространство имен. Во втором ар¬ 
гументе обычно передается неквалифицированное локальное имя атрибута из 
этого пространства имен. Исключением является метод $е*АИгіЬи*еМ5(), которо¬ 
му во втором атрибуте необходимо передавать квалифицированное имя атрибута, 
включающее идентификатор пространства имен. Более полная информация об 
этих методах доступа к атрибутам из других пространств имен приводится в чет¬ 
вертой части книги. 

15.4.3. Атрибуты с данными 

Иногда бывает желательно добавить в НТМЬ-элементы дополнительные данные, 
обычно когда предусматривается возможность выбора этих элементов в Лаѵа- 
Всгірі-сценариях и выполнения некоторых операций с ними. Иногда это можно 
реализовать, добавив специальные идентификаторы в атрибут сіазз. Иногда, ко¬ 
гда речь заходит о более сложных данных, программисты прибегают к использо¬ 
ванию нестандартных атрибутов. Как отмечалось выше, для чтения и изменения 
значений нестандартных атрибутов можно использовать методы де1АИгіЬи!е() 
и зе*АІ*гіЬи{е(). Платой за это будет несоответствие документа стандарту. 

Стандарт НТМЬб предоставляет решение этой проблемы. В документах, соответ¬ 
ствующих стандарту НТМЬб, все атрибуты, имена которых состоят только из 
символов в нижнем регистре и начинаются с приставки «баіа-», считаются допус¬ 
тимыми. Эти «атрибуты с данными» не оказывают влияния на представление 
элементов, в которых присутствуют, и обеспечивают стандартный способ вклю¬ 
чения дополнительных данных без нарушения стандартов. 

Кроме того, стандарт НТМЬб определяет в объекте Еіетепі: свойство сіаіазе*. Это 
свойство ссылается на объект, который имеет свойства, имена которых соответ¬ 
ствуют именам атрибутов сіаііа- без приставки. То есть свойство сіаіазеі.х будет 
хранить значение атрибута йаіа-х. Имена атрибутов с дефисами отображаются 
в имена свойств с переменным регистром символов: атрибут сіаіа-ідиегу-іезі: пре¬ 
вратится в свойство (ІаІазе^одиегуТезЬ 
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Ниже приводится более конкретный пример. Допустим, что в документе имеется 
следующий фрагмент разметки: 

<зрап с1а53=*'5рагк1іпе" Раіа-утіп^’О" РаІа-утах="1(Г> 

111223455435677421 

</зрап> 

Зрагкііпе - это маленькое изображение, обычно некоторый график, предназна¬ 
ченное для отображения в потоке текста. Чтобы сгенерировать такое изображе¬ 
ние, необходимо извлечь значение атрибута с данными, как показано ниже: 

// Предполагается, что в броузере поддерживается метод Аггау.тарО, 

// определяемый стандартом Е35 (или реализована его имитация) 
ѵаг зрагкііпез = Росіітепі:.деіЕІетепізВуСІаззМатеС"зрагкііпе'); 

Гог(ѵаг і = 0; і < зрагкііпез.ІепдіМ; і++) { 
ѵаг РаТазеТ = 5рагк1іпез[і].Ра1:а5е1:; 
ѵаг утіп = рагзеПоаКРаТазеТ. утіп); 
ѵаг утах = рагзеРІоаКРаіазеІ. ушах); 

ѵаг Раіа = зрагк1іпез[і].ТехТСопТепт.зр1іТ(" ").тар(рагзеР1оа1:); 
Рга\л/3рагк1іпе(зрагк1іпез[і], утіп, утах, Раіа); // Еще не реализована 

} 

На момент написания этих строк свойство Рамазе! еще не было реализовано в те¬ 
кущих броузерах, поэтому представленное выше решение можно было бы реали¬ 
зовать так: 

ѵаг зрагкііпез = Росіітепі:.деіЕІетепІізВуСІаззМатеС"зрагкііпе"); 

Гог(ѵаг і = 0; і < зрагкііпез.ІепдіП; і++) { 
ѵаг еіі = зрагк1іпез[і]; 

ѵаг утіп = рагзеРІоаКеІі.деІАПгіЬііІіеС'РаІіа-утіп")); 
ѵаг утіп = рагзеРІоаКеІІі.деІіАПгіЬііІеС'РаІіа-утах')); 
ѵаг роіпіз = еІІ.деІАПгіЬііІеС'РаІа-роіпІз"); 
ѵаг Раіа = еіі. ІехІСопІепІ:. зрШ(" ").тар(рагзеР1оа1:); 

Рга\ѵ5рагк1іпе(е11:, утіп, утах, Раіа); // Еще не реализована 

} 

Обратите внимание, что свойство Раіазеі: является (или будет, когда будет реали¬ 
зовано) «живым», двунаправленным интерфейсом к атрибутам РаТа- элемента. 
Изменение или удаление свойства объекта Раіазеі: приводит к изменению или 
удалению соответствующего атрибута Раіа- элемента. 

Функция РгамЗрагкІіпеО в примере выше является вымышленной, однако в при¬ 
мере 21.13 демонстрируется прием рисования внутристрочных диаграмм (зрагк¬ 
ііпез), подобных диаграмме в примере выше, с использованием элемента <сапѵаз>. 

15.4.4. Атрибуты как узлы типа АНг 

Существует несколько способов работы с атрибутами элементов. Тип МоРе опреде¬ 
ляет свойство аІІгіЬиІез. Это свойство имеет значение пиіі для всех узлов, не яв¬ 
ляющихся объектами Еіетепі. Свойство аІІгіЬиІез объектов Еіетепі является объ¬ 
ектом, подобным массиву, доступным только для чтения, представляющим все 
атрибуты элемента. Подобно спискам МоРеИзІ, объект аІІгіЬиІез не является ста¬ 
тической копией. Он может индексироваться числами, что означает возможность 
перечисления всех атрибутов элемента, а также именами атрибутов: 
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сіоситеп*. Ьосіу. а**гіЬіі*ез[0] // Первый атрибут элемента <Ьос1у> 

сіосіітеп*. Ьосіу. аТІ:гіЬиІез. Ьдсоіог // Атрибут Ьдсоіог элемента <Ьос1у> 
сіоситепі;. Ьосіу. аТІ:гіЬи1:ез["ОЫЮАО"3 // Атрибут опіоасі элемента <ЬосІу> 

Значениями, получаемыми в результате индексирования объекта а**гіЬи*е$, яв¬ 
ляются объекты А**г. Объекты А1:1:г- это специализированный подтип Мойе, но 
в действительности никогда не используемые в таком качестве. Свойства пате 
и ѵаіие объектов А** г возвращают имя и значение атрибута. 

15.5. Содержимое элемента 

Взгляните еще раз на рис. 15.1 и попробуйте ответить на вопрос: какой объект 
представляет «содержимое» элемента <р>. На этот вопрос можно дать три ответа: 

• Содержимым является строка разметки НТМЬ «ТЬіз із а <і>зітр1е</і> боси- 
тепі». 

• Содержимым является простая текстовая строка «ТЬіз із а зітріе боситеп*». 

• Содержимым является узел типа Тех*, узел типа Еіетеп*, включающий дочер¬ 
ний узел Тех*, и еще один узел типа Тех*. 

Все три ответа являются верными, и каждый ответ ценен по-своему. В следую¬ 
щих разделах описывается, как работать с представлением в виде разметки 
НТМЬ, с представлением в виде простого текста и с представлением в виде дерева 
объектов. 

15.5.1. Содержимое элемента в виде НТМЬ 

При чтении свойства іппегНТМІ_ объекта Еіетеп* возвращается содержимое этого 
элемента в виде строки разметки. Попытка изменить значение этого свойства 
приводит к вызову синтаксического анализатора веб-броузера и замещению те¬ 
кущего содержимого элемента разобранным представлением новой строки. (Не¬ 
смотря на свое название, свойство іппегНТМІ. может использоваться для работы не 
только с НТМЬ-, но и с ХМЬ-элементами.) 

Веб-броузеры прекрасно справляются с синтаксическим анализом разметки 
НТМЬ, поэтому операция изменения значения свойства іппегНТМІ. обычно доста¬ 
точно эффективна, несмотря на необходимость синтаксического анализа. Тем не 
менее обратите внимание, что многократное добавление фрагментов текста в свой¬ 
ство іппегНТМІ_ с помощью оператора += обычно далеко не эффективное решение, 
потому что требует выполнения двух шагов - сериализации и синтаксического 
анализа. 

Впервые свойство іппегНТМІ_ было реализовано в ІЕ4. Несмотря на то что оно доста¬ 
точно давно поддерживается всеми броузерами, это свойство было стандартизо¬ 
вано только с появлением стандарта НТМЬб. Спецификация НТМЬб требует, 
чтобы свойство іппегНТМІ_ было реализовано не только в объекте Еіетеп*, но и в объ¬ 
екте йоситеп*, однако пока этому требованию отвечают не все броузеры. 

Кроме того, спецификация НТМЬб стандартизует свойство с именем ои*егНТМІ_. 
При обращении к свойству ои*егНТМ1_ оно возвращает строку разметки НТМЬ или 
ХМЬ, содержащую открывающий и закрывающий теги элемента, которому при¬ 
надлежит это свойство. При записи нового значения в свойство ои*егНТМ1_ элемента 
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новое содержимое замещает элемент целиком. Свойство ои1:егНТМІ_ определено 
только для узлов типа Еіетепі:, оно отсутствует в объекте Ооситепі:. К моменту на¬ 
писания этих строк свойство ои1:егНТМІ_ поддерживалось всеми текущими броузе: 
рами, кроме Гіге&эх. (В примере 15.5, далее в этой главе, приводится реализация 
свойства ои1:егНТМ1_ на основе свойства іппегНТМІ_.) 

Еще одной особенностью, впервые появившейся в ІЕ и стандартизованной спе¬ 
цификацией НТМЬ5, является метод іпзег1:А(^асеп1:НТМІ_(), дающий возможность 
вставить строку с произвольной разметкой НТМЬ, прилегающую («афасепі») 
к указанному элементу. Разметка передается методу во втором аргументе, а точ¬ 
ное значение слова «прилегающая» («афасепі») зависит от значения первого аргу¬ 
мента. Этот первый аргумент должен быть строкой с одним из значений: «Ье^оге- 
Ъе^іп», «аЙегЬе^іп», «Ъе^огеешЬ или «айегеші». Эти значения определяют пози¬ 
цию вставки, как изображено на рис. 15.3. 


<йіѵ ій="1агде1"> 


ЬеІогеЬедіп 


ТІіі5 І5 ТИе еіетепі: сопіепі: 


</с!іѵ> 


аКегЬедіп 


Ьеіогеепс) аКегепй 


Рис . 15.3. Позиции вставки в вызове метода іпзегіАйіасепіНТМЦ) 


Метод іп$ег1:АсІ]асеп1:НТМІ_() не поддерживается текущей версией Гігеіох. Далее 
в этой главе будет представлен пример 15.6, демонстрирующий, как можно реа¬ 
лизовать метод іп$ег1:Ай]асеп1:НТМІ_() с применением свойства іппегНТМІ_ и как мож¬ 
но написать методы вставки разметки НТМЬ, не требующие указывать позицию 
вставки с помощью строкового аргумента. 

15.5.2. Содержимое элемента в виде простого текста 

Иногда бывает необходимо получить содержимое элемента в виде простого текста 
или вставить простой текст в документ (без необходимости экранировать угловые 
скобки и амперсанды, используемые в разметке НТМЬ). Стандартный способ вы¬ 
полнения этих операций основан на использовании свойства ТехіСопТепІ: объекта 
Мойе: 

ѵаг рага = йоситепІі.деІіЕІетепІзВуТадМатеС'р'НО]; // Первый <р> в документе 
ѵаг іехі = рага. ІехіСопІепІ:; // Текст "ТПіз із а зітріе йоситепі:." 

рага.ІехіСопІепІ: = "Неііо Могісі!"; // Изменит содержимое абзаца 

Свойство ТехТСопТеп! поддерживается всеми текущими броузерами, кроме ІЕ. 
В ІЕ вместо него можно использовать свойство іппегТехІ:. Впервые свойство іппег¬ 
ТехІ: было реализовано в ІЕ4 и поддерживается всеми текущими броузерами, кро¬ 
ме Гігеіох. 

Свойства іехіСопіепІ: и іппегТехІ настолько похожи, что обычно могут быть взаи¬ 
мозаменяемы при использовании. Однако будьте внимательны и отличайте пус¬ 
тые элементы (строка в языке Лѵабсгірі интерпретируется как ложное значе¬ 
ние) от неопределенных свойств: 

/** 

* При вызове с одним аргументом возвращает значение свойства іехіСопіепІ: 

* или іппегТехІ: элемента. При вызове с двумя аргументами записывает 
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* указанное значение в свойство *ех*Соп*еп* или іппегТех* элемента. 

V 

^ипсТіоп *ех*Соп*еп*(е1етеп*. ѵаіие) { 

ѵаг соп*еп* = е1етеп*.*ех*Соп*еп*; // Свойство *ех*Соп*еп* определено? 

і* (ѵаіие === ипсіеі'іпесі) { // Если аргумент ѵаіие не указан, 

і* (соп*еп* !== ипйеТіпесІ) ге*игп соп*еп*; // вернуть текущий текст 
еізе ге*игп еіетеп*. іппегТех*; 


} 

еізе { // Иначе записать текст 

и (соп*еп* !== ьпсіе^іпесі) еіетеп*.*ех*Соп*еп* = ѵаіие; 
еізе еіетеп*.іппегТех* = ѵаіие; 


} 


} 


Свойство *ех*Соп*еп* возвращает результат простой конкатенации всех узлов 
Тех*, потомков указанного элемента. Свойство ІппегТехІ: не обладает четко опреде¬ 
ленным поведением и имеет несколько отличий от свойства *ех*Соп*еп*. іппегТехІ: 
не возвращает содержимое элементов <$сгір*>. Из возвращаемого им текста уда¬ 
ляются лишние пробелы и предпринимается попытка сохранить табличное фор¬ 
матирование. Кроме того, для некоторых элементов таблиц, таких как <*аЫе>, 
<*Ьос1у> и <*г>, свойство іппегТех* доступно только для чтения. 


Текст в элементах <$сгірі> 

Встроенные элементы <$сгір*> (т.е. без атрибута зге) имеют свойство *ех*, 
которое можно использовать для получения их содержимого в виде тек¬ 
ста. Содержимое элементов <$сгір*> никогда не отображается в броузерах, 
а НТМЬ-парсеры игнорируют угловые скобки и амперсанды внутри сцена¬ 
риев. Это делает элемент <$сгір*> идеальным средством встраивания про¬ 
извольных текстовых данных, доступных для использования веб-прило- 
жением. Достаточно просто определить в атрибуте *уре элемента какое-ли¬ 
бо значение (такое как «іехі/х-сизіот-баіа»), чтобы сообщить, что этот сце¬ 
нарий не содержит выполняемый программный код на языке ^ѵаВсгірі. 
В этом случае интерпретатор ^ѵабегірі будет игнорировать сценарий, но 
сам элемент будет включен в дерево документа, а содержащиеся в нем дан¬ 
ные можно будет получить с помощью свойства *ех*. 


15.5.3. Содержимое элемента в виде текстовых узлов 

Еще одним средством доступа к содержимому элемента является список дочер¬ 
них узлов, каждый из которых может иметь свое множество дочерних узлов. Ко¬ 
гда речь заходит о содержимом элемента, наибольший интерес обычно представ¬ 
ляют текстовые узлы. При работе с ХМЬ-документами необходимо также быть 
готовыми встретить узлы С0АТА8ес*іоп - подтип класса Тех* - представляющие со¬ 
держимое разделов СОАТА. 

Пример 15.3 демонстрирует функцию *ех*Соп*еп*(), которая выполняет рекур¬ 
сивный обход дочерних элементов и объединяет текст, содержащийся во всех тек- 
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стовых узлах-потомках. Чтобы было более понятно, напомню, что свойство посіе- 
Ѵаіие (определяемое типом Мосіе) хранит содержимое текстового узла. 

Пример 15.3. Поиск всех текстовых узлов, потомков указанного элемента 

// Возвращает простое текстовое содержимое элемента е, выполняя рекурсивный 
// обход всех дочерних элементов. Этот метод действует подобно свойству ІехіСопІепІ 
Іипсііоп ІехіСопіепі(е) { 

ѵаг сРіІР, Іуре, з = // з хранит текст всех дочерних узлов 

Гог( сМііс! = е. Гі гзГСИНс!; сЫІб != пиіі: сРіІР = сіііісі. пехіЗіЫіпд) { 

Іуре = сШР. посІеТуре; 

іі (Туре === 3 || Іуре === 4) // Узлы типов Тех* и СОАТАЗесІіоп 

з += сПШ. посІеѴаІие; 

еізе іТ (Іуре === 1) // Рекурсивный обход узлов типа Еіетепі 

з += ІехіСопіепі(сШсІ); 

} 

геГи гп з; 

} 

Свойство посІеѴаІие доступно для чтения и записи, и с его помощью можно изме¬ 
нять содержимое в отображаемых узлах Техі и СОАТАЗесІіоп. Оба типа, Техі и СОАТА- 
ЗесГіоп, являются подтипами класса СИагасі:ег0а1:а, описание которого приводит¬ 
ся в четвертой части книги. Класс СГіагас1:ег0а1:а определяет свойство сІаГа, которое 
хранит тот же текст, что и свойство посІеѴаІие. Следующая функция преобразует 
символы текстового содержимого узлов типа Техі: в верхний регистр, устанавли¬ 
вая значение свойства сіаіа: 

// Рекурсивно преобразует символы всех текстовых узлов-потомков 
// элемента п в верхний регистр. 

ГипсГіоп ирсазе(п) { 

іі (п.поРеТуре == 3 || п.пойеТуер == 4) // Если п - объект Техі или СЭАТА 
п.РаІа = п. сіаіа. ЮІІррегСазеО; // преобразовать в верхний регистр 
еізе // Иначе рекурсия по дочерним узлам 

Іог(ѵаг і = 0; і < п.сРіІйМойез.ІепдІР; і++) 
ирсазе( п. сШсІМосІез[ і ]); 

} 

Класс СІіагасІегОаІа также определяет редко используемые методы добавления 
в конец, удаления, вставки и замены текста в узлах Техі или СОАТАЗесІіоп. Кроме 
изменения содержимого имеющихся текстовых узлов этот класс позволяет так¬ 
же вставлять в элементы Еіетепі новые текстовые узлы или замещать существую¬ 
щие текстовые узлы новыми. Создание, вставка и удаление узлов - тема следую¬ 
щего раздела. 

15.6. Создание, вставка и удаление узлов 

Мы уже знаем, как получать и изменять содержимое документа, используя стро¬ 
ки с разметкой НТМЬ и с простым текстом. Мы также знаем, как выполнять об¬ 
ход документа для исследования отдельных узлов Еіетепі и Техі, составляющих 
его содержимое. Однако точно так же существует возможность изменения доку¬ 
мента на уровне отдельных узлов. Тип Ооситепі определяет методы создания объ¬ 
ектов Еіетепі и Техі, а тип Мосіе определяет методы для вставки, удаления и заме- 
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ны узлов в дереве. Приемы создания и вставки узлов уже были показаны в приме¬ 
ре 13.4, который повторяется ниже: 


// Асинхронная загрузка сценария из указанного иві_-адреса и 
ТцпсТіоп Іоайазупс(цгі) { 

ѵаг МеасІ = сіосцтепі:. де1:Е1етепі:зВуТадМате( "Иеас)" )[0]; // 
ѵаг з = сіосцтепі:.сгеаІеЕІетепІ:("зсгірі:"); // 

з.згс = игі; // 

Пеай.аррепсЮІйІсКз); // 

} 


его выполнение 

Отыскать <РеаР> 

Создать элемент <зсгірі:> 
Установить его атрибут зге 
Вставить <зсгірі:> в <ПеаР> 


В следующих подразделах более подробно и с примерами рассказывается о созда¬ 
нии новых узлов, о вставке и удалении узлов, а также об использовании объектов 
ОоситепІіРгадтепІ:, упрощающих работу с множеством узлов. 


15.6.1. Создание узлов 

Как было показано в примере выше, создавать новые узлы Еіетепі: можно с помо¬ 
щью метода сгеа1:еЕ1етеп1:() объекта Ооситепі:. Этому методу необходимо передать 
имя тега: это имя не чувствительно к регистру символов при работе с НТМЬ-доку- 
ментами и чувствительно при работе с ХМЬ-документами. 

Для создания текстовых узлов существует аналогичный метод: 

ѵаг пемпоРе = сіоситепі. с геаІеТехІ: Мойе ("содержимое текстового узла"); 

Кроме того, объект Ооситепі: определяет и другие фабричные методы, такие как 
редко используемый метод сгеа1:еСоттеп1:(). Один такой метод, сгеа1:е0оситеп1:Ргад- 
теп1:(), мы будем использовать в разделе 15.6.4. При работе с документами, в кото¬ 
рых используются пространства имен ХМЬ, можно использовать метод сгеа1:еЕ1е- 
теп^МЗО, позволяющий указывать ІІКІ-идентификатор пространства имен и имя 
тега создаваемого объекта Еіетепі:. 

Еще один способ создания в документе новых узлов заключается в копировании 
существующих узлов. Каждый узел имеет метод с1опеМос!е(), возвращающий но¬ 
вую копию узла. Если передать ему аргумент со значением 1:гие, он рекурсивно 
создаст копии всех потомков, в противном случае будет создана лишь поверхно¬ 
стная копия. В броузерах, отличных от ІЕ, объект Ооситепі: дополнительно опре¬ 
деляет похожий метод с именем ітрог1:МосІе(). Если передать ему узел из другого 
документа, он вернет копию, пригодную для вставки в текущий документ. Если 
передать ему значение 1:гие во втором аргументе, он рекурсивно импортирует все 
узлы-потомки. 


15.6.2. Вставка узлов 

После создания нового узла его можно вставить в документ с помощью методов 
типа Мосіе: аррепРСІііІсІО или іпзег1:Ве1 : оге(). Метод аррепсЮШсК) вызывается отно¬ 
сительно узла Еіетепі:, в который требуется вставить новый узел, и вставляет ука¬ 
занный узел так, что тот становится последним дочерним узлом (значением свой¬ 
ства 1аз1:СШсІ). 

Метод іпзег^ВеІ'огеО похож на метод аррепРСНПсК), но он принимает два аргумен¬ 
та. В первом аргументе указывается вставляемый узел, а во втором - узел, перед 
которым должен быть вставлен новый узел. Этот метод вызывается относительно 
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объекта узла, который станет родителем нового узла, а во втором аргументе дол¬ 
жен передаваться дочерний узел этого родителя. Если во втором аргументе пере¬ 
дать пиіі, метод іпзег1:ВеГоге() будет вести себя, как аррепс1(М1с1(), и вставит узел 
в конец. 

Ниже приводится простая функция вставки узла в позицию с указанным чи¬ 
словым индексом. Она демонстрирует применение обоих методов, аррепс1(М1с1() 
и іпзег1:ВеГоге(): 

// Вставляет узел сНіісі в узел рагепі: так, что он становится п-м дочерним узлом 
^цпсііоп іпзегШ (рагепі:, сНіісі, п) { 

(п < 0 || п > рагепі:. сНПсМойез. ІепдІН) 

ІНгом пем Ег го г ("недопустимый индекс"); 
еізе іГ (п == рагепі;.сИіІгіЫогіез. 1епді;И) рагепі:. аррепсЮШсКсНПс!); 
еізе рагепі:.іпзегі:ВеГоге(сІй1с1, рагепі:.сІй1сМоРе5[п]); 

} 

Если метод аррепсКМІсІО или іпзеПВе^огеО используется для вставки узла, кото¬ 
рый уже находится в составе документа, этот узел автоматически будет удален из 
текущей позиции и вставлен в новую позицию; нет необходимости явно удалять 
узел. Пример 15.4 демонстрирует функцию сортировки строк таблицы по значе¬ 
ниям ячеек в указанном столбце. Она не создает новые узлы и для изменения по¬ 
рядка следования существующих узлов использует метод аррепсІСІіі1с1(). 


Пример 15.4. Сортировка строк таблицы 

// Сортирует строки в первом элементе <1Ьос1у> указанной таблицы по значениям 
// п-й ячейки в каждой строке. Использует функцию сравнения, если она указана. 
// Иначе сортировка выполняется в алфавитном порядке. 

Гцпсііоп зогігоизСіаЫе, п, сотрагаіог) { 

ѵаг ІЬосІу = 1:аЫе.ІВосІіез[0]; // Первый <1:Ьос1у>; возможно созданный неявно 
ѵаг гомз = ІЬосІу.деШетепізВуТадМатеС'Іг"); // Все строки в ІЬоРу 
го\л/з = Аггау.ргоІоІуре.зІісе.саЩгомз.О); // Скопировать в массив 


// Отсортировать строки по содержимому п-го элемента <1:с!> 

Гойе. зогК^цпс^іопС гоѵѵ/1, го\л/2) { 

ѵаг сеііі = гом1.деіЕ1етепізВуТадМате("1:сГ)[п]; // п-е ячейки 
ѵаг се112 = гои2.деШетепізВуТад№те("1:сГ)[п]; // двух строк 
ѵаг ѵаіі = сеііі.ІехіСопіепІ: || сеііі.ІппегТехІ:; // текстовое содерж. 
ѵаг ѵа12 = се112.ІехіСопіепі || се112. ІппегТехІ:; // двух ячеек 
іТ (сотрагаіог) геіцгп сотрага*ог(ѵа11, ѵа12); // Сравнить! 

іГ (ѵаіі < ѵа12) геіцгп -1; 
еізе іТ (ѵаіі > ѵа12) геіцгп 1; 
еізе геіцгп 0; 

}); 


// Добавить строки в конец ІЬойу в отсортированном порядке. 

// При этом строки автоматически будут удалены из их текущих позиций, 

// благодаря чему отпадает необходимость явно удалять их. Если <1Ьос1у> содержит 
// какие-либо другие узлы, отличные от элементов <іг>, эти узлы "всплывут" наверх. 
1 : ог(ѵаг і = 0; і < гоиз. ІепдіН; і++) іЬойу. аррепРСШсК го\ѵз[і]); 

> 

// Отыскивает в таблице элементы <іН> (предполагается, что в таблице существует 
// только одна строка с ними) и добавляет в них возможность обработки щелчка мышью, 

// чтобы щелчок на заголовке столбца вызывал сортировку таблицы по этому столбцу. 
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Тілісіііоп таке$огі:аЫе(1:аЫе) { 

ѵаг НеаРегз = *аЬ1е.де*Е1етеп*зВуТадМате(''1:ІѴ'); 

Тог(ѵаг і = 0; і < Иеайегз. ІепдТІі; і++) { 

(*цпс1:іоп(п) { // Чтобы создать локальную область видимости 
НеаРегз[і].опс1іск = ТьпсТіопО { зогі:го\л/з(1:аЫе, п); }; 

}(і)); // Присвоить значение і локальной переменной п 

} 

> 

15.6.3. Удаление и замена узлов 

Метод гетоѵеСИіІсК) удаляет элемент из дерева документа. Но будьте вниматель¬ 
ны: этот метод вызывается не относительно узла, который должен быть удален, 
а (как следует из фрагмента «сЫЫ» в его имени) относительно родителя удаляе¬ 
мого узла. Этот метод вызывается относительно родителя и принимает в виде ар¬ 
гумента дочерний узел, который требуется удалить. Чтобы удалить узел п из до¬ 
кумента, вызов метода должен осуществляться так: 

п. рагеШ^оРе. гетоѵеСПіІй(п); 

Метод гер1асе(М1с!() удаляет один дочерний узел и замещает его другим. Этот ме¬ 
тод должен вызываться относительно родительского узла. В первом аргументе он 
принимает новый узел, а во втором - замещаемый узел. Например, ниже показа¬ 
но, как заменить узел п текстовой строкой: 

п. рагепі:№)СІе. герІасеСШсКРосшпепІ:.сгеа*еТех1:№)СІе("[ ИСПРАВЛЕНО ]"). п); 

Следующая функция демонстрирует еще один способ применения метода геріасе- 
СШс1(): 

// Замещает узел п новым элементом <Ь> и делает узел п его дочерним элементом. 

*цпс*іоп етЬоІРеп(п) { 

// Если вместо узла получена строка, интерпретировать ее как значение 
// атрибута іб элемента 

і* (1;уреоГ п == "зігіпд") п = йосьтеШ:. де1Е1етеп1:ВуІсІ( п); 
ѵаг рагеп* = п. рагепІИоРе; // Ссылка на родителя элемента п 

ѵаг Ь = Росшей*, с геа*еЕ1етеп1:(''Ь''); // Создать элемент <Ь> 
рагеп*. герІасеСНіІсКЬ, п); // Заменить п элементом <Ь> 

Ь. аррепРСНіІР(п); // Сделать п дочерним элементом элемента <Ь> 

> 

В разделе 15.5.1 было представлено свойство ои*егНТМ1_ элементов и говорилось, что 
оно не реализовано в текущей версии Гігеіох. Пример 15.5 демонстрирует, как 
можно реализовать это свойство в Гігеіох (и в любом другом броузере, поддержи¬ 
вающем свойство іппегНТМІ_, позволяющем расширять объект-прототип Е1етеп*.рго- 
*о*уре и имеющем методы определения методов доступа к свойствам). Здесь так¬ 
же демонстрируется практическое применение методов гетоѵеСІпіІсК ) и сіопеМоРе( ). 

Пример 15.5. Реализация свойства оиіегНТМЬ с помощью свойства іппегНТМЬ 

// Реализация свойства оіі*егНТМІ_ для броузеров, не поддерживающих его. 

// Предполагается, что броузер поддерживает свойство іппегНТМІ_, возможность 
// расширения Еіетеп*. рго*о*уре и позволяет определять методы доступа к свойствам. 
(*цпс*іоп() { 

// Если свойство оіі*егНТМІ_ уже имеется - просто вернуть управление 
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іТ (Роситеп1.сгеаІеЕ1етепі(''Ріѵ'').ои1:егНТМІ_) геішгп; 


// Возвращает окружающую разметку с содержимым элемента, 

// на который указывает ссылка ІНіз 

ТипсТіоп оиТегНТМЮеТТегО { 

ѵаг сопіаіпег = сіосишепі:. сгеаТеЕХетепТСсИу"); // Фиктивный элемент 
сопШпег.аррепРСНі1с1(ІПі5.с1опе№)с1е(1:гие)); // Копировать Шз 

// в фиктивный элемент 

геішгп сопТаіпег. іппегНТМІ.; // Вернуть содержимое 

// фиктивного элемента 

} 

// Замещает указанным значением ѵаіье содержимое элемента, на который 
// указывает ссылка іНіз, вместе с окружающей разметкой НТМІ. 

ТипсТіоп оц1:егНТМІ_$е1:1:ег(ѵа1ие) { 

// Создать фиктивный элемент и сохранить в нем указанное значение 
ѵаг сопТаіпег = Росілпепі:.сгеаТеЕІетепТС'йіѵ"); 
сопііаіпег. іппегНТМІ_ = ѵаіце; 

// Переместить все узлы из фиктивного элемента в документ 
ѵЛіі1е(соп1:аіпег.^ ігзШііій) // Продолжать, пока в контейнере 

// не останется дочерних элементов 
Шз. рагепШсІе. іпзегІВеШеСсопІіаіпег. ГігзіСРіісі, Шз); 

// И удалить замещаемый узел 
Шз. рагеп1:Ыос1е. гешоѵеСШсКШз); 


} 

// Использовать эти две функции в качестве методов чтения и записи свойства оцІегНТМІ. 
// всех объектов Еіешепі:. Использовать метод ОЬ^есІ:.РеИпеРгорегіу, если имеется, 

// в противном случае использовать_ гіе^іпебеНег _и_ сІеІ'іпеЗеиег _. 

(ОЬ^есІ: . сІе^іпеРгорегііу ) { 

ОЬ^есІ:.сіе^іпеРгорегІу(Еіешепі:.ргоШуре, "оцІегНТМІ.", { 

деі: оц^егНТМЮеПег, 
зеі:: оьІіегНТМІЗеПег, 
епцтегаЫе: Шзе, соп^ідцгаЫе: Хгие 


>); 


> 

еізе { 

Еіешепі:.рго1:о1:уре._с!еГіпе0е1:1;ег_("ои*егНТМІ_", оц^егНТМЮеПег); 

Еіешепі:.ргоШуре._РеІ'іпеЗеиег_("оцІегНТМІ.", оцІегНТМІЗеПег); 

} 

}()); 


15.6.4. Использование объектов ОоситепІРгадтепі 

Объекты ОоситепІіРгадтепІ: - это особая разновидность объектов Ыосіе; они служат 
временным контейнером для других узлов. Создаются объекты ОоситепІіРгадтепІ: 
следующим образом: 

ѵаг ^гад = сіосцтепі:. сгеаІеОосшпепііРгадтепііС ); 

Как и узел Ооситепі:, объекты ОоситепІіРгадтепІ: являются самостоятельными и не 
входят в состав какого-либо другого документа. Его свойство рагепІіМосІе всегда 
возвращает значение пиіі. Однако, как и узлы Еіетепі:, объекты ОоситепІіРгадтепІ: 
могут иметь любое количество дочерних элементов, которыми можно управлять 
с помощью методов аррепсКМІсіО, іпзегііВеГогеО и т. д. 
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Одна из особенностей объекта ОоситепІіРгадтепІ: состоит в том, что он позволяет ма¬ 
нипулировать множеством узлов как единственным узлом: если объект ОоситепІі¬ 
РгадтепІ: передать методу аррепс!(М1с1(), іп$ег1:Ве^оге() или гер1асеСІіі1с1(), в доку^ 
мент будут вставлены дочерние элементы фрагмента, а не сам фрагмент. (Дочер¬ 
ние элементы будут перемещены из фрагмента в документ, а сам фрагмент опусте¬ 
ет и будет готов для повторного использования.) Следующая функция использует 
объект ОоситепІіРгадтепІ: для перестановки в обратном порядке дочерних элемен¬ 
тов узла: 

// Выполняет перестановку дочерних элементов узла п в обратном порядке 
^цпсіііоп геѵегзе(п) { 

// Создать пустой объект ОоситепІіРгадтепІ:, который будет играть роль 

// временного контейнера 

ѵаг 1= = Роситеп1:.сгеа1:е0оситепі:Ргадтеп1:( ); 

// Выполнить обход дочерних элементов в обратном порядке и переместить каждый 
// из них в объект фрагмента. Последний дочерний элемент узла п станет первым 
// дочерним элементом фрагмента Р, и наоборот. Обратите внимание, что при добавлении 
// дочернего элемента в фрагмент Т он автоматически удаляется из узла п. 
мШе(п. ІазіСНШ) Р.аррепРСПШ(п. ІазіСНШ); 

// В заключение переместить сразу все дочерние элементы 
// из фрагмента ? обратно в узел п. 

п.аррепРСШсКО; 

> 

В примере 15.6 представлена реализация метода іп$ег1:АсІ]асеп1:НТМІ_() (раздел 15.5.1) 
с применением свойства іппегНТМІ. и объекта ОоситепІіРгадтепІ:. В нем также опреде¬ 
ляются функции вставки разметки НТМЬ с более логичными именами, чем не¬ 
очевидное іпзег1:Ас1]асеп1:НТМІ_(). Вложенная вспомогательная функция 1тадтеп1і() 
является, пожалуй, наиболее интересной частью этого примера: она возвращает 
объект ОоситепІіРгадтепІ:, содержащий разобранное представление указанной ей 
строки с разметкой НТМЬ. 

Пример 15.6. Реализация метода іпзегіАй)асепіНТМЬ( ) с использованием 

свойства іппегНТМЬ 

// Этот модуль определяет метод Еіетепі:. іпзе ПАР] асепі: НТМЬ для броузеров, 

// не поддерживающих его, а также определяет переносимые функции вставки НТМЬ, 

// имеющие более логичные имена, чем имя іпзегііАРз асепІіНТМІ.: 

// Іпзегі:. Ье^оге(), Іпзегі:. а^1:ег(), Іпзегі; . аІіЗііагі; ( ), Іпзегі:.аІЕпсЦ) 
ѵаг Іпзегі: = (^цпсІііопО { 

// Если элементы имеют собственный метод іпзег1:АсІз асепІіНТМІ., использовать 
// его в четырех функциях вставки НТМЬ, имеющих более понятные имена. 
іТ ( сіоситепі: . сгеаІіеЕІетепІ: ( "с!іѵ"). іпзегі:Ас!з асепІіНТМІ) { 
ге*цгп { 

ЬеТоге: Гцпс1:іоп(е, М) {е. іпзег1:АРіасеп1:НТМІ_("Ье1 : огеЬедіп", Н); }, 
аТ*ег: Гипс1:іоп(е,Іі) {е.іпзег*Ас!іасеп*НТМІ_("аТ*егеп(Г,П);}, 

а1:31:а гі:: Гцпс1:іоп(е, М) {е. іпзег1:АРзасеп1:НТМІ_(''а1 : 1:егЬедіп'', П);}, 
аІЕпР: Гцпс1:іоп(е,М) {е.іпзег1:АсІзасепі:НТМІ(’ЬеГогеепсІ",1т);} 

>: 

> 

// Иначе, в случае отсутствия стандартного метода іпзе ПАР] асепІіНТМІ., 

// реализовать те же самые четыре функции вставки и затем использовать их 
// в определении метода іпзегіАсІзасепІіНТМІ.. 
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// Сначала необходимо определить вспомогательный метод, который принимает 
// строку с разметкой НТМЬ и возвращает объект 0осцтеп1:Ргадтепі:, 

// содержащий разобранное представление этой разметки. 

Тьпсіііоп ТгадтепКМТтІ) { 

ѵаг еІТ = Росцтеп1:.сгеа1:еЕ1етепі:(’’Ріѵ"); // Пустой элемент 
ѵаг Тгад = Росцтепі:.сгеаТеОосьтепТРгадтепТС); // Пустой фрагмент 
еіі:.іппегНТМІ. = Шті; // Содержимое элемента 

\л/Пі1е(е11:.ТігзТСПіІй) // Переместить все узлы 

Ргад. аррепРСШР(е11:. РігзіСШР); // из еІТ в Тгад 

геТьгп Тгад; // И вернуть Тгад 

} 

ѵаг ІпзегТ = { 

ЬеТоге: ТипсТіоп(е1Т, НТтІ) { 

еІТ. рагепТМойе. іпзегТВеТогеСТгадтепТСПТтІ), еІТ); 

>, 

аТТег: ТипсТіоп(е1Т, ПТтІ) { 

еІТ. рагепТМосІе. іпзегТВеТоге(ТгадтепТ(ПТт1),е1Т. пехТ8іЫіпд); 

>. 

аТВТагТ: ТипсТіоп(еІТ, НТтІ) { 

еІТ.іпзегТВеТоге(ТгадтепТ(ПТт1), еІТ.ТігзТСПіІсІ); 

}. 

аІЕпР: ТипсТіоп(е1Т. ПТтІ) { еІТ.аррепРСПі1Р(ТгадтепТ(ПТт1)); } 

>; 


// Реализация метода іпзегТАРзасепТНТМІ на основе функций выше 
ЕІетепТ.ргоТоТуре.іпзегТАРзасепТНТМІ = ТцпсТіопСроз, НТтІ) { 
зміТсІіСроз.ТоІ-омегСазеС)) { 

сазе "ЬеТогеЬедіп": геТцгп ІпзегТ.ЬеТоге(ТПіз, ПТтІ); 
сазе "аТТегепР": геТцгп ІпзегТ.аТТег(ТПіз, ПТтІ); 

сазе "аТТегЬедіп": геТцгп ІпзегТ.аТ8ТагТ(ТПіз, ПТтІ); 
сазе "ЬеТогеепР": геТцгп ІпзегТ.аТЕпР(ТГііз. ПТтІ); 

} 

>: 

геТцгп ІпзегТ; // Вернуть четыре функции вставки 

}()); 

15.7. Пример: создание оглавления 

Пример 15.7 показывает, как динамически создавать оглавление документа. Он 
демонстрирует многие концепции работы с документом, описанные в разделах 
выше: выбор элементов, навигация по документу, установка атрибутов элемен¬ 
тов, установка свойства іппегНТМІ. и создание новых узлов и вставку их в доку¬ 
мент. Пример снабжен большим количеством комментариев, которые призваны 
облегчить понимание программного кода. 

Пример 15.7. Автоматическое создание оглавления документа 
I* * 

* ТОСоз: создает оглавление документа. 

* 

* Этот модуль регистрирует анонимную функцию, которая вызывается 

* автоматически по окончании загрузки документа. Эта функция сначала 
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* отыскивает элемент документа с атрибутом іс1=’Т0С". Если такой элемент 

* отсутствует, функция создает его, помещая в начало документа. 

* 

* Затем функция отыскивает все элементы с <М> по <Гі6> , интерпретируя их как 

* заголовки разделов и создает оглавление внутри элемента ТОО. Функция добавляет 

* номера разделов в каждый заголовок и обертывает заголовки именованными 

* якорными элементами, благодаря чему оглавление может ссылаться на них. 

* Якорным элементам даются имена, начинающиеся с приставки "ТОО", поэтому вам следует 

* избегать использовать эту приставку в своей разметке НТМІ_. 

* 

* Оформление элементов оглавления можно реализовать с помощью С38. Все элементы имеют 

* класс "Т0СЕп{гу". Кроме того, каждый элемент оглавления имеет класс, соответствующий 

* уровню заголовка раздела. Для заголовков, оформленных тегом <М>, создаются элементы 

* оглавления с классом ”Т0СІ_еѵе11", для заголовков <М2> - с классом "Т0СІ.еѵе12" и т. д. 

* Номера разделов, вставляемые в заголовки, получают класс "ТОСЭес^цт". 

* 

* Этот модуль можно использовать с каскадными таблицами стилей, такими как: 

* 

* #Т0С { Ьогйег: зоіісі Ыаск Ірх; тагдіп: Юрх; расШпд: Юрх; } 

* .Т0СЕп{гу { Гопі-Гашііу: запз-зегіГ; } 

* .Т0СЕп{гу а { {ех{-йесога{іоп: попе; } 

* .Т0СІ_еѵе11 { Гопі-зіге: 16р{; {оп{-меідН{ : Ьоісі; } 

* .Т0СІ.еѵе12 { ГопІ-зіге: 12р{; тагдіп-1е{{: .5іп; } 

* .Т0С8ес{Мит:а{{ег { соп{еп{: } 

* 

* Последнее определение генерирует двоеточие и пробел после номера раздела. 

* Чтобы скрыть номера разделов, можно использовать следующий стиль: 

* 

* .ТОСЗесіИит { сіізріау: попе } 

* 

* Этот модуль использует вспомогательную функцию опІ_оас!(). 

**/ 

опІ_оас!(Гііпс1:іоп( ) { // Анонимная функция, определяющая локальн. обл. видимости 
// Отыскать контейнерный элемент для оглавления. 

// Если такой элемент отсутствует, создать его в начале документа, 
ѵаг {ос = с!оситепі:.де1:Е1етеп1:ВуІс1(”Т0С"): 
іГ (!{ос) { 

{ос = с1ос^теп{.сгеа{еЕ1етеп{("с^іѵ , '); 

{ос. ій = "ТОО"; 

йосілпеп{. Ьойу. іпзег{Ве{оге({ос, йоситеп{.Ьойу. {ігз{СНі1й): 

} 

// Отыскать все элементы заголовков разделов 
ѵаг Неайіпдз; 

і{ (йоситеп{.диегу8е1ес{огА11) // Возможно есть более простой путь? 

Неайіпдз = с)оситеп{ . диегу8е1ес{огА11 (”Гі1, М2, Г»3. Гі4, М5, Гіб”); 
еізе // Иначе отыскать заголовки более сложным способом 

Пеайіпдз = {іпйНеайіпдз(с1оситеп{.Ьойу, []); 

// Выполняет рекурсивный обход тела документа в поисках заголовков 
Гипс{іоп {іпйНеас!іпдз(гоо{, зес{з) { 

Гог(ѵаг с = гоо{. {ігз{СПі1с1: с != пьП; с = с. пех{8іЫіпд) { 
і{ (с.пойеТуре !== 1) соп{іпие; 

і{ (сладите. 1епд{П == 2 && с.{адМате.сНагА{(0) == "Н") 
зес{з.ризП(с); 
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еібе 

Гіпс1Неас1іпд5(с, зесіз); 

} • 

геііігп зесіз; 

} 

// Инициализировать массив, хранящий номера разделов, 
ѵаг зесІіопМцтЬегз = [О,О,О,0,0,0]; 

// Выполнить цикл по найденным элементам заголовков. 

1"ог(ѵаг Н = 0; Н < Неасііпдз. Іепдііі; Н++) { 
ѵаг Реасііпд = НеасІіпдзЕіі]; 

// Пропустить заголовки, находящиеся в контейнере оглавления. 
іГ (Неасііпд. ра теп* Иоде == іос) соптіпце; 

// Определить уровень заголовка. 

ѵаг Іеѵеі = рагзеіпі:(Иеасііпд. {адепте.сНагАЮ )); 

іГ (із№М(1еѵе1) || Іеѵеі < 1 || Іеѵеі > 6) сопііпие; 

// Увеличить номер раздела для этого уровня и установить 
// номера разделов более низкого уровня равными нулю. 
зесііопМілпЬегзЕ1еѵе1-1]++; 

^ог(ѵаг і = Іеѵеі; і < 6; і++) зесііопМитЬегзЕі] = 0; 

// Объединить номера разделов всех уровней, 

// чтобы получился номер вида 2.3.1. 

ѵаг зесііопМцтЬег = зесііопМілпЬегз. з1ісе(0, Іеѵеі). ;)оіп(".") 

// Добавить номер раздела в заголовок. Номер помещается в элемент <зрап>, 

// чтобы его можно было стилизовать с помощью СЗЗ. 

ѵаг зрап = сІоситепІ.сгеаІеЕІетепіГзрап"); 

зрап. сІаззИате = "ТОСЗесІИцт"; 

зрап. іппегНТМІ. = зесііопМитЬег; 

Неасііпд.іпзеПВе^огеСзрап, Неасііпд.^ігзіСНіІР); 

// Обернуть заголовок якорным элементом, чтобы можно было 

// сконструировать ссылку на него. 

ѵаг апсіюг = Роситепі.сгеаіеЕІетепТС'а"); 

апсіюг. пате = "ТОС+зесііопМитЬег; 

Неасііпд. рагепіИобе.іпзегіВеІюгеС апсіюг, Іюасііпд); 
апсГіог. аррепсІСГіі1с)( Меасііпд); 

// Создать ссылку на этот раздел, 
ѵаг Ііпк = сІоситепІ.сгеаІіеЕІегпепііС’а"); 

Ііпк.НгеІ 1 = "#Т0С" + зесііопМшпЬег; // Адрес назначения ссылки 
Ііпк.іппегНТМІ = Неабіпд. іппегНТМІ.; // Текст ссылки совпадает 

// с текстом заголовка 

// Поместить ссылку в элемент біѵ, чтобы обеспечить возможность 

// стилизации в зависимости от уровня. 

ѵаг епігу = Роситепі.сгеаіеЕ1етепі("с1іѵ"); 

епігу.сІаззИате = "ТОСЕпігу Т0СІ.еѵеГ' + Іеѵеі; 

епігу. аррепсІСІйІсКІіпк); 

// И добавить элемент сііѵ в контейнер оглавления, 
іос. аррепсКМ1с1(еп1: гу); 

} 

}); 
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15.8. Геометрия документа и элементов 
и прокрутка 

До сих пор в этой главе мы рассматривали документы как некие абстрактные де¬ 
ревья элементов и текстовых узлов. Но когда броузер отображает документ в сво¬ 
ем окне, он создает визуальное представление документа, в котором каждый эле¬ 
мент имеет определенную позицию и размеры. Часто веб-приложения могут ин¬ 
терпретировать документы как деревья элементов и никак не заботиться о том, 
как эти элементы отображаются на экране. Однако иногда бывает необходимо оп¬ 
ределить точные геометрические характеристики элемента. Например, в главе 16 
мы увидим, что элемент можно поместить в определенную позицию с помощью 
С88. Если вам потребуется использовать С88 для динамического позиционирова¬ 
ния элемента (такого как всплывающая подсказка или сноска) рядом с элемен¬ 
том, который позиционируется броузером, вам необходимо иметь возможность 
определять положение этого элемента. 

В этом разделе рассказывается, как можно переходить от абстрактной, древовид¬ 
ной модели документа к геометрическому, основанному на системе координат ви¬ 
зуальному представлению документа в окне броузера, и обратно. Свойства и ме¬ 
тоды, описываемые здесь, реализованы в броузерах достаточно давно (хотя есть 
некоторые, которые до недавнего времени присутствовали только в ІЕ, а некото¬ 
рые не были реализованы в ІЕ до появления версии ІЕ9). К моменту написания 
этих строк они проходили процесс стандартизации консорциумом АУЗС в виде 
стандарта «С880М-Ѵіелѵ Мосіиіе» (Мір://\ѵіѵіѵлѵ3.огё/ТК/с88от-ѵіеіѵ/). 

15.8.1. Координаты документа и видимой области 

Позиция элемента измеряется в пикселах. Координата X растет слева направо, 
а координата У - сверху вниз. Однако существуют две точки, которые мы можем 
считать началом координат: координаты X и У элемента могут отсчитываться от¬ 
носительно верхнего левого угла документа или относительно верхнего левого уг¬ 
ла видимой области. Для окон верхнего уровня и вкладок «видимой областью» 
является часть окна броузера, в которой фактически отображается содержимое 
документа: в нее не входит обрамление окна (меню, панели инструментов, вклад¬ 
ки). Для документов, отображаемых во фреймах, видимой областью является 
элемент <і1тате>, определяющий фрейм. В любом случае, когда речь заходит о по¬ 
зиции элемента, необходимо знать, какая система координат используется - от¬ 
носительно начала документа или относительно начала видимой области. (Коор¬ 
динаты видимой области видимости иногда называют оконными координатами.) 

Если документ меньше видимой области или если он еще не прокручивался, 
верхний левый угол документа находится в верхнем левом углу видимой области, 
и начала систем координат документа и видимой области совпадают. Однако в об¬ 
щем случае, чтобы перейти от одной системы координат к другой, необходимо до¬ 
бавлять или вычитать смещения прокрутки . Например, если координата У эле¬ 
мента имеет значение 200 пикселов в системе координат документа и пользова¬ 
тель прокрутил документ вниз на 75, то в системе координат видимой области 
координата У элемента будет иметь значение 125 пикселов. Аналогично, если ко¬ 
ордината X элемента имеет значение 400 в системе координат видимой области 
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и пользователь прокрутил документ по горизонтали на 200 пикселов, то в систе¬ 
ме координат документа координата X элемента будет иметь значение 600. 

Система координат документа является более фундаментальной, чем система ко¬ 
ординат видимой области, и на нее не оказывает влияния величина прокрутки. 
Однако в клиентских сценариях довольно часто используются координаты види¬ 
мой области. Система координат документа используется при позиционировании 
элементов с помощью С88 (глава 16). Но проще всего получить координаты эле¬ 
мента в системе координат видимой области (раздел 15.8.2). Аналогично, когда 
регистрируется функция-обработчик событий от мыши, координаты указателя 
мыши передаются ей в системе координат видимой области. 

Чтобы перейти от одной системы координат к другой, необходимо иметь возмож¬ 
ность определять позиции полос прокрутки окна броузера. Во всех броузерах, кро¬ 
ме ІБ версии 8 и ниже, эти значения можно узнать с помощью свойств радеХО^^зеІ: 
и радеУО^^зе! объекта Иіпсіоіѵ. Кроме того, в ІЕ (и во всех современных броузерах) 
позиции полос прокрутки можно узнать с помощью свойств зсгоШе^І и зсгоНТор. 
Проблема состоит в том, что в обычном случае позиции полос прокрутки следует 
читать из свойств корневого элемента (с!оситеп1:.с1оситеп1:Е1етеп1:) документа, а в ре¬ 
жиме совместимости (раздел 13.4.4) необходимо обращаться к элементу <Ьос1у> 
(сІоситепІі.ЬосІу) документа. Пример 15.8 показывает, как определять позиции по¬ 
лос прокрутки переносимым образом. 

Пример 15.8. Получение позиций полос прокрутки окна 

// Возвращает текущие позиции полос прокрутки в виде свойств х и у объекта 
^цпсііоп де*Зсго110Нзе*з(ѵО { 

// Использовать указанное окно или текущее, 

// если функция вызвана без аргумента 
ѵі/ = ѵі/ 11 ѵі/іпРоѵі/; 

// Следующий способ работает во всех броузерах, кроме ІЕ версии 8 и ниже 
Н (ѵ/. радеХОНзеІ: != пціі) геіцгп {х: ѵ/. радеХО^зе*, у:ѵ/. радеУОНзеП ; 

// Для ІЕ (и других броузеров) в стандартном режиме 
ѵаг Р = м.Росілпепі; 

Н (Росцтепі:.сотра1:МоРе == "СЗЗЮотра*") 
геіцгп {х:Р.РосцтепІіЕІетепІ:.зс гоШеН, 
у:Р. гіосілпепіЕІетеп*. зсгоНТор} ; 

// Для броузеров в режиме совместимости 

геіцгп { х: 6. ЬоРу. зс гоШеН, у: Р. ЬоРу. зсгоНТор }; 

} 

Иногда бывает удобно иметь возможность определять размеры видимой области, 
например, чтобы определить, какая часть документа видима в настоящий мо¬ 
мент. Как и в случае со смещениями прокрутки, самый простой способ узнать 
размеры видимой области не работает в ІЕ версии 8 и ниже, а прием, который ра¬ 
ботает в ІЕ, зависит от режима, в котором отображается документ. Пример 15.9 
показывает, как переносимым способом определять размер видимой области. Об¬ 
ратите внимание на сходство программного кода этого примера с программным 
кодом в примере 15.8. 
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Пример 15.9. Получение размеров видимой области документа 

// Возвращает размеры видимой области в виде свойств ѵі/ и Ь объекта 
^псТіоп де*Ѵіеѵфог*Зі 2 е(ѵО { 

// Использовать указанное окно или текущее, если функция вызвана без аргумента 
ѵі/ = ѵі/ 11 ѵі/іпРоѵі/; 

// Следующий способ работает во всех броузерах, кроме ІЕ версии 8 и ниже 
і? (ѵ/. іппегІл/іЫіЬ != пціі) геТигп {ѵ/: ѵ/. іппег1л/ісЛ:Іі, Ь:ѵ/. іппегНеідМ;}; 

// Для ІЕ (и других броузеров) в стандартном режиме 
ѵаг Р = ѵі/. гіосілпепі; 

іТ (гіосшпеп*. сотра1:МоРе == "СЗЗІСотраІ:") 

геТигп { ѵ/: Р.Росцтеп1:Е1етеп1:.с1іеп1:Іл/іР1:Іі, 

И: Ь.ЬосцтепШетеп1:.с1іеп1:НеідЬ1: }; 

// Для броузеров в режиме совместимости 

геіюгп { ѵі: Р.ЬоРу.сІіепТМіРТІі, И: Р.ЬоРу.сІіепТМіРТІі }; 

} 

В двух примерах выше использовались свойства зсгоІИе^, зсгоИТор, сНепШсНЬ 
и сІіепІіНеідИІ:. Мы встретимся с этими свойствами еще раз в разделе 15.8.5. 

15.8.2. Определение геометрии элемента 

Самый простой способ определить размеры и координаты элемента - обратиться 
к его методу де1:ВоипРіпдС1іеп1:Нес1:(). Этот метод впервые появился в ІЕ5 и в на¬ 
стоящее время реализован во всех текущих броузерах. Он не принимает аргумен¬ 
тов и возвращает объект со свойствами Іе^І, гідМ:, Іор и ЬоИот. Свойства и Іор 
возвращают координаты X и У верхнего левого угла элемента, а свойства гідЫ: 
и ЬоИот возвращают координаты правого нижнего угла. 

Этот метод возвращает позицию элемента в системе координат видимой области. 
(Слово «Сііепі» в имени метода деІВоипс1іпдС1іеп1:Пес1:( ) косвенно указывает на кли¬ 
ентскую область веб-броузера, т. е. на окно и видимую область в нем.) Чтобы пе¬ 
рейти к координатам относительно начала документа, которые не изменяются 
после прокрутки окна броузера пользователем, нужно добавить смещения про¬ 
крутки: 

ѵаг Ьох = е. деІіВоипсііпдСІіепІіРесІ; (); // Координаты в видимой области 
ѵаг о^зеіз = деіЗсгоПО^зеІзО; // Вспомогат. функция, объявленная выше 
ѵаг х = Ьох.ІеГі: + о^зеіз.х; // Перейти к координатам документа 

ѵаг у = Ьох.іор + о^зеіз.у; 

Кроме того, во многих броузерах (и в стандарте АУЗС) объект, возвращаемый ме¬ 
тодом деІВоипгііпдСІіепІРесіО, имеет свойства ѵѵісИіИ и ЬеідМ:, но оригинальная реа¬ 
лизация в ІЕ не поддерживает их. Для совместимости ширину и высоту элемента 
можно вычислять, как показано ниже: 

ѵаг Ьох = е.деІВоцпсІіпдСІіепіВесіО; 

ѵаг ѵі/ = Ьох.місШі || (Ьох.гідЫ: - Ьох.Іе^І); 

ѵаг Ь = Ьох.ЬеідЫ: || (Ьох.ЬоИош - Ьох.іор); 

В главе 16 вы узнаете, что содержимое элемента окружается необязательной пус¬ 
той областью, которая называется отступом (радсііпё). Отступы окружаются 
необязательной рамкой (Ъогбег), а рамка окружается необязательными полями 
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(таг^іпв). Координаты, возвращаемые методом деТВоипйіпдС1іеп1:Нес1:(), включа- 
. ют рамку и отступы элемента, но не включают поля. 

Если слово «Сііепі» в имени метода де1:Воипс1іпдС1іеп1:ПесЮ определяет систему 
координат возвращаемого прямоугольника, то о чем свидетельствует слово «Во- 
ипсііпё» (ограничивающий)? Блочные элементы, такие как изображения, абзацы 
и элементы <с!іѵ>, всегда отображаются броузерами в прямоугольных областях. 
Однако строчные элементы, такие как <$рап>, <сос!е> и <Ь>, могут занимать не¬ 
сколько строк и таким образом состоять из нескольких прямоугольных областей. 
Например, представьте некоторый курсивный текст (отмеченный тегами <і> 
и </і>), разбитый на две строки. Область, занимаемая этим текстом, состоит из 
прямоугольника в правой части первой строки и прямоугольника в левой части 
второй строки (в предположении, что текст записывается слева направо). Если 
передать методу деІВоипс1іпдС1іеп1:Нес1:() строчный элемент, он вернет геометрию 
«ограничивающего прямоугольника» (Ьоипсііп^ гесіап^іе), содержащего все от¬ 
дельные прямоугольные области. Для элемента <і>, взятого в качестве примера 
выше, ограничивающий прямоугольник будет включать обе строки целиком. 

Для определения координат и размеров отдельных прямоугольников, занимае¬ 
мых строчными элементами, можно воспользоваться методом деІС1іеп*РесІз(), 
который возвращает объект, подобный массиву, доступный только для чтения, 
чьи элементы представляют объекты прямоугольных областей, подобные тем, что 
возвращаются методом де1:Воипс1іпдС1іеп1:Рес1:(). 

Мы уже знаем, что методы модели БОМ, такие как де1:Е1етеп1:$ВуТадМате(), возвра¬ 
щают «живые» результаты, изменяющиеся синхронно с изменением документа. 
Объекты прямоугольных областей (и списки объектов прямоугольных областей), 
возвращаемые методами де1:Воипс1іпдС1іеп1:Вес1:() и деѣСІіепІРесѣзО не являются 
«живыми». Они хранят статические сведения о визуальном представлении доку¬ 
мента на момент вызова. Они не обновляются, если пользователь прокрутит доку¬ 
мент или изменит размеры окна броузера. 

15.8.3. Определение элемента в указанной точке 

Метод де1:Воипс1іпдС1іеп1:Вес1:() позволяет узнать текущую позицию элемента в ви¬ 
димой области. Но иногда бывает необходимо решить обратную задачу - узнать, 
какой элемент находится в заданной точке внутри видимой области. Сделать это 
можно с помощью метода е1етеп1:РготРоіпі:() объекта Ооситепі:. Он принимает коор¬ 
динаты X и У (относительно начала координат видимой области, а не документа) 
и возвращает объект Еіетепі:, находящийся в этой позиции. На момент написания 
этих строк алгоритм выбора элемента не был строго определен, но суть реализации 
метода сводится к тому, что он должен возвращать самый внутренний и самый 
верхний (в смысле С88-атрибута і-іпйех, который описывается в разделе 16.2.1.1) 
элемент, находящийся в этой точке. Если передать ему координаты точки, нахо¬ 
дящейся за пределами видимой области, метод е1етепі:РготРоіп1:() вернет пиіі, да¬ 
же если после преобразования координат в систему координат документа полу¬ 
чится вполне допустимая точка. 

Метод е1етеп1:РгогтіРоіп1:() выглядит весьма практичным, и наиболее очевидный 
случай его использования - определение элемента, находящегося под указателем 
мыши по его координатам. Однако, как будет показано в главе 17, объект события 
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от мыши уже содержит эту информацию в своем свойстве *агдеІ. Именно поэтому 
на практике метод е1етеп1:РготРоіп1:() почти не используется. 

15.8.4. Прокрутка 

В примере 15.8 демонстрировалось, как определять позиции полос прокрутки ок¬ 
на броузера. Чтобы заставить броузер прокрутить документ, можно присваивать 
значение используемым в этом примере свойствам зсгоШе^І: и зсгоШор, но суще¬ 
ствует более простой путь, поддерживаемый с самых ранних дней развития язы¬ 
ка Лѵабсгірі. Метод зсгоПТоО объекта іл/іпсісм (и его синоним зсгоІІО) принимает 
координаты X и У точки (относительно начала координат документа) и устанав¬ 
ливает их в качестве величин смещения полос прокрутки. То есть он прокручива¬ 
ет окно так, что точка с указанными координатами оказывается в верхнем левом 
углу видимой области. Если указать точку, расположенную слишком близко 
к нижней или к правой границе документа, броузер попытается поместить эту 
точку как можно ближе к верхнему левому углу видимой области, но не сможет 
обеспечить точное их совпадение. Следующий пример прокручивает окно броузе¬ 
ра так, что видимой оказывается самая нижняя часть документа: 

// Получить высоту документа и видимой области. Метод оНзеІНеідІтЬ описывается ниже. 

ѵаг сІоситепІіНеідІгІ: = сіоситепі; . сІоситепІіЕІетепІ;. оІ'І'зеІіНеідІт*:; 

ѵаг ѵіеѵі/рогіНеідПІ: = \ѵіпсіо\ѵ. іппегНеідМ:; // Или использовать де 1 :Ѵіе\л/рогі:Зі 2 е(), 

// описанный выше 

// И прокрутить окно так, чтобы переместить последнюю "страницу" в видимую область 
\л/іпс1о\л/. 5сго11То(0, сІоситепііНеідМІ; - ѵіеѵфоПНеідНі:); 

Метод зсго11Ву() объекта іл/іпсісм похож на методы зсгоІІО и зсгоПТоО, но их аргу¬ 
менты определяют относительное смещение и добавляются к текущим позициям 
полос прокрутки. Тем, кто умеет быстро читать, мог бы понравиться следующий 
букмарклет (раздел 13.2.5.1): 

// Прокручивает документ на 10 пикселов каждые 200 мсек. 

// Учтите, что этот букмарклет нельзя отключить после запуска! 
иаѵаЗсгірі: : ѵоісі зе1;Іп1;егѵа1(^ипсІііопС) {5сго11Ву(0,10)}, 200); 

Часто требуется прокрутить документ не до определенных числовых координат, 
а до элемента в документе, который нужно сделать его видимым. В этом случае 
можно определить координаты элемента с помощью метода де1:Воипс1іпдС1іеп1:Пес1:(), 
преобразовать их в координаты относительно начала документа и передать их ме¬ 
тоду зсгоПТоО, но гораздо проще воспользоваться методом зсгоІІІпІіоѴіеѵѵО тре¬ 
буемого НТМЬ-элемента. Этот метод гарантирует, что элемент, относительно ко¬ 
торого он будет вызван, окажется в видимой области. По умолчанию он старается 
прокрутить документ так, чтобы верхняя граница элемента оказалась как можно 
ближе к верхней границе видимой области. Если в единственном аргументе пере¬ 
дать методу значение Гаізе, он попытается прокрутить документ так, чтобы ниж¬ 
няя граница элемента совпала с нижней границей видимой области. Кроме того, 
броузер выполнит прокрутку по горизонтали, если это потребуется, чтобы сде¬ 
лать элемент видимым. 

Своим поведением метод зсго11Іп1:оѴіе\л/() напоминает свойство ѵѵіпсіом.іосаіііоп. 
Паз И, когда ему присваивается имя якорного элемента (элемента <а пате= " ">). 
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15.8.5. Подробнее о размерах, позициях 
и переполнении элементов 

Метод деІВоипсІіпдС1іеп1:Рес1:() поддерживается всеми текущими броузерами, но ес¬ 
ли требуется обеспечить поддержку броузеров более старых версий, этот метод ис¬ 
пользовать нельзя и для определения размеров и позиций элементов следует при¬ 
менять более старые приемы. Размеры элементов определяются достаточно просто: 
доступные только для чтения свойства о^зеШ-сЛіІі и о^зеІНеідІтЬ любого НТМЬ- 
элемента возвращают его размеры в пикселах. Возвращаемые размеры включают 
рамку элемента и отступы, но не включают поля, окружающие рамку снаружи. 

Все НТМЬ-элементы имеют свойства о^зеНе^І: и о^зеІТор, возвращающие их ко¬ 
ординаты X и У. Для многих элементов эти координаты откладываются относи¬ 
тельно начала документа и непосредственно определяют позицию элемента. Но 
для потомков позиционируемых элементов и некоторых других элементов, таких 
как ячейки таблиц, эти свойства возвращают координаты относительно элемен- 
та-предка, а не документа. Свойство о^зеІРагепІ: определяет, относительно како¬ 
го элемента исчисляются значения этих свойств. Если о^зеІРагепІ имеет значе¬ 
ние піііі, свойства содержат координаты относительно начала документа. Таким 
образом, в общем случае для определения позиции элемента е с помощью его 
свойств о^зеИе^ и о^зеІТор требуется выполнить цикл: 

І^псііоп деІЕІетепІРозіІіоп(е) { 
ѵаг х = 0, у = 0; 

\ѵИі1е(е ! = гшіі) { 
х += е.о^зеИе^; 
у += е.о^зеІТор; 
е = е.о^зеІРагеп*; 

} 

геЩгп {х:х, у:у}; 

} 


Выполняя обход цепочки, образуемой ссылками о^зеІРагепІ, и накапливая сме¬ 
щения, эта функция вычисляет координаты указанного элемента относительно 
начала документа. (Напомню, что метод де*ВоипгііпдС1іепІРес1(), напротив, воз¬ 
вращает координаты относительно начала видимой области.) Однако на этом те¬ 
му позиционирования элементов нельзя считать исчерпанной - функция деІЕІе- 
теп!РозШоп() не всегда вычисляет правильные значения, и ниже будет показано, 
как исправить эту ошибку. 

В дополнение к множеству свойств о^зеі все элементы документа определяют 
еще две группы свойств; имена свойств в первой группе начинаются с приставки 
сііепі, а во второй группе - с приставки зсгоіі. То есть каждый НТМЬ-элемент 
имеет все свойства, перечисленные ниже: 


о^зеШ.(Ші 

о^зеІНеідШ 

оІ^зеНеГі: 

о^зеІТор 

о^зеІРагеп* 


сІіегцИісШі 

сІіепіНеідШ 

сПепИе^ 

сІіегцТор 


зсгоІІИісШі 

зсгоІІНеідШ 

зсгоШе^ 

зсгоІІТор 


Чтобы понять разницу между группами свойств сііепі: и зсгоіі, необходимо уяс¬ 
нить, что объем содержимого НТМЬ-элемента может не умещаться в прямоуголь¬ 
ную область, выделенную для этого содержимого, и поэтому отдельные элементы 
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могут иметь собственные полосы прокрутки (смотрите описание С88-атрибута 
оѵегИсм в разделе 16.2.6). Область отображения содержимого - это видимая об¬ 
ласть, подобная видимой области в окне броузера, и когда содержимое элемента 
не умещается в видимой области, необходимо принимать в учет позиции полос 
прокрутки элемента. 

Свойства сІіепіМісНІі и сІіепІНеідІтЬ похожи на свойства о^зеІМісЛН и оГ^зеІНеідІтС, 
за исключением того, что они включают только область содержимого и отступы 
и не включают размер рамки. Кроме того, если броузер добавляет между рамкой 
и отступами полосы прокрутки, то свойства сІіепІМісІІІі и сІіепІНеідНІ не включа¬ 
ют ширину полос прокрутки в возвращаемые значения. Обратите внимание, что 
для строчных элементов, таких как <і>, <сос!е> и <зрап>, свойства сІіепІѴі/ісІІН и сіі- 
епІНеідІтІ: всегда возвращают 0. 

Свойства сІіепІМісІІІі и сІіепІНеідНІ использовались в методе деІѴіеи/роПЗігеО из 
примера 15.9. В том случае, когда эти свойства применяются к корневому элемен¬ 
ту документа (или телу элемента в режиме совместимости), они возвращают те же 
значения, что и свойства іппегМісІІН и іппегНеідИІ окна. 

Свойства сНепИе^ и сІіепѣТор не имеют большой практической ценности: они 
возвращают расстояние по горизонтали и вертикали между внешней границей 
отступов элемента и внешней границей его рамки. Обычно эти значения просто 
определяют ширину левой и верхней рамки. Однако если элемент имеет полосы 
прокрутки и если броузер помещает эти полосы прокрутки вдоль левого или верх¬ 
него края (что весьма необычно), значения свойств сПепИе^ и сІіепѣТор также 
будут включать ширину полос прокрутки. Для строчных элементов свойства сіі- 
епИеГІ и с1іеп1:Тор всегда возвращают 0. 

Свойства зсгоІІѴі/ісЛН и зсгоІІНеідІгІ: определяют размер области содержимого эле¬ 
мента, плюс его отступы, плюс ширину и высоту области содержимого, выходя¬ 
щую за видимую область. Когда содержимое целиком умещается в видимой об¬ 
ласти, значения этих свойств совпадают со значениями свойств сІіепІѴі/ісІІН и сіі- 
епІНеідНІ. В противном случае они включают ширину и высоту области содержи¬ 
мого, выходящую за видимую область, и возвращают значения, превосходящие 
значения свойств сІіепІМісІІИ и сІіепІНеідНІ. 

Наконец, свойства зсгоШе^ и зсгоНТор определяют позиции полос прокрутки 
элемента. Мы использовали эти свойства корневого элемента документа в методе 
деІЗсгоІІО^зеІзО (пример 15.8), но они также присутствуют в любом другом эле¬ 
менте. Обратите внимание, что свойства зсгоШеГІ и зсгоНТор доступны для запи¬ 
си и им можно присваивать значения, чтобы прокрутить содержимое элемента. 
(НТМЬ-элементы не имеют метода зсгоІІТоО, как объект Міпсіом.) 

Когда документ содержит прокручиваемые элементы, содержимое которых не 
умещается в видимой области, объявленный выше метод де1Е1етепіРозі1іоп() да¬ 
ет некорректные результаты из-за того, что он не учитывает позиции полос про¬ 
крутки. Ниже приводится исправленная версия, которая вычитает позиции по¬ 
лос прокрутки из накопленных смещений, т. е. преобразует координаты относи¬ 
тельно начала документа в координаты относительно видимой области: 

Гщпсіііоп де*Е1етеп*Ро5(е1*) { 
ѵаг х = 0, у = 0; 

// Цикл, накапливающий смещения 

Гог(ѵаг е = еіі; е != тЛ!; е = е.оГ^зеІРагепІ) { 
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х += е.оГГзеИеП:; 
у += е.оГГзеИор; 

} 

// Еще раз обойти все элементы-предки, чтобы вычесть смещения прокрутки. 

// Он также вычтет позиции главных полос прокрутки и преобразует 

// значения в координаты видимой области. 

Гог(ѵаг е=е11:.рагеп1:№(1е; е != пціі && е.пойеТуре == 1; е=е. рагепТМосІе) { 
х -= е.зсгоШеГТ; 
у -= е.зсгоІІТор; 

} 

геТигп {х:х, у:у>; 

} 

В современных броузерах этот метод де1:Е1етеп1:Ро5() возвращает те же координа¬ 
ты, что и метод деІВоипс1іпдС1іеп1:Нес1:() (но он менее эффективен). Теоретически та¬ 
кая функция, как де1:Е1етеп1:Роз(), могла бы использоваться в броузерах, не под¬ 
держивающих метод де1:Воипс1іпдС1іеп1:Нес1:()* Однако броузеры, не поддерживаю¬ 
щие де1:Воипс1іпдС1іеп1:Пес1:(), имеют массу несовместимостей в механизме позицио¬ 
нирования элементов, и поэтому в них такая простая функция оказывается нена¬ 
дежной. Клиентские библиотеки, такие как і(}ііегу, включают функции вычисле¬ 
ния позиций элементов, которые дополняют этот простой алгоритм множеством 
проверок, учитывающих несовместимости между броузерами. Если вам потребу¬ 
ется определять позиции элементов в броузерах, не поддерживающих деІВоипсЛ пд- 
С1іепІРесІ( ), то для этих целей лучше использовать библиотеку, например, і(}иегу. 

15.9. НТМІ_-формы 

НТМЬ-элемент <Гогт> и различные элементы ввода, такие как <іпри1:>, <зе1ес1:> 
и <Ьи11оп>, занимают видное место в разработке клиентских сценариев. Эти 
НТМЬ-элементы появились в самом начале развития Всемирной паутины, еще до 
появления языка ЛѵаЗсгірі. Формы НТМЬ - это механизм веб-приложений пер¬ 
вого поколения, не требующий применения ^ѵаЗсгірІ. Ввод пользователя соби¬ 
рается в элементах форм; затем форма отправляется на сервер; сервер обрабаты¬ 
вает ввод и генерирует новую НТМЬ-страницу (обычно с новыми элементами 
форм) для отображения на стороне клиента. 

Элементы НТМЬ-форм по-прежнему остаются великолепным инструментом по¬ 
лучения данных от пользователя, даже когда данные формы целиком обрабаты¬ 
ваются ^ѵабсгірі-сценарием на стороне клиента и не должны отправляться на 
сервер. С точки зрения программиста, разрабатывающего серверные сценарии, 
форма оказывается совершенно бесполезной, если в ней отсутствует кнопка от¬ 
правки формы. Однако с точки зрения программиста, разрабатывающего клиент¬ 
ские сценарии, кнопка отправки вообще не нужна (хотя все еще может использо¬ 
ваться). Серверные программы опираются на механизм отправки форм - они об¬ 
рабатывают данные порциями, объем которых определяется формой, - и это ог¬ 
раничивает их интерактивные возможности. Клиентские программы опираются 
на механизм событий - они могут откликаться на события, возникающие в от¬ 
дельных элементах форм, - и это позволяет обеспечить более высокую степень ин¬ 
терактивности. Например, клиентская программа может проверять ввод пользо¬ 
вателя по мере нажатия клавиш. Или откликаться на выбор флажка, разрешая 
доступ к набору параметров, которые имеют смысл, только когда флажок отмечен. 




15.9. НТМІ_-формы 


429 


В следующих подразделах описывается, как реализовать подобные операции при 
работе с НТМЬ-формами. Формы конструируются из НТМЬ-элементов, как и лю¬ 
бые другие части НТМЬ-документа, и ими можно управлять с помощью методов 
модели БОМ, описанных выше в этой главе. Элементы формы стали первыми эле¬ 
ментами, для которых было предусмотрено программное управление на самых 
ранних этапах развития клиентского ^ѵаЗсгірІ, поэтому они поддерживают не¬ 
которые дополнительные функции, предшествовавшие появлению БОМ. 

Обратите внимание, что в этом разделе описываются не сам язык разметки НТМЬ, 
а приемы управления НТМЬ-формами. Здесь предполагается, что вы уже имеете 
некоторое знакомство с НТМЬ-элементами (<іпри1:>, <1ех1:агеа>, <зе1ес1:> и т. д), ис¬ 
пользуемыми для создания форм. Тем не менее в табл. 15.1 для справки приводит¬ 
ся список наиболее часто используемых элементов форм. Дополнительные сведе¬ 
ния о функциях для работы с формами и элементами форм можно узнать в чет¬ 
вертой части книги, в справочных статьях Рогт, Іприі:, Оріііоп, Зеіесі: и ТехІіАгеа. 

Таблица 15Л. Элементы НТМЬ-форм 


НТМЬ-элемент 

Свойство іуре 

Обработчик 

событий 

Описание и события 

<іпри1; 1:уре='Ьи1:1:оп"> 

"ЬиПоп" 

опсііск 

Кнопка 

или 

<ЬиПоп 1;уре= "Ьи1:1:оп"> 




<іпри1; 1:уре="сІіескЬох"> 

“сІіескЬох" 

опсМапде 

Переключаемый флажок; с иным 
поведением, чем у радиокнопки 

<іпри1; іуре= "Ше "> 

’ТіІе" 

операнде 

Поле ввода имени файла для вы¬ 
грузки на сервер; свойство ѵаіііе дос¬ 
тупно только для чтения 

<іпри1; 1:уре="ІіісІсІеп"> 

"ІіісІРеп" 

нет 

Данные, отправляемые вместе с фор¬ 
мой, но не видимые пользователю 

<ор1:іоп> 

нет 

нет 

Единственный пункт объекта Зе¬ 
іесі:; обработчик событий подклю¬ 
чается к объекту Зеіесі:, а не к объ¬ 
ектам Орііоп 

<іприі: 1уре="раз5\л/огсГ> 

"раззмогсГ 

операнде 

Поле ввода пароля - скрывает вво¬ 
димые символы 

<іприі: іуре=‘гасІіо"> 

"гасНо" 

опсМапде 

Переключатель с поведением радио¬ 
кнопки - в каждый конкретный мо¬ 
мент времени может быть выбран 
только один переключатель 

<іприі: 1уре="гезе1:"> 

или 

"тезе!" 

опсііск 

Кнопка, сбрасывающая форму в ис¬ 
ходное состояние 

<Ьи1:1:оп 1уре='гезе1:"> 




<зе1ес1:> 

■зеіесі-опе" 

опсМапде 

Список или раскрывающееся меню, 
в котором можно выбрать только 
один пункт (смотрите также <оріі- 
оп>) 

<зе1ес1; тиШр1е> 

"зеіесіі-тиііііріе" 

опсМапде 

Список, в котором можно выбрать 
сразу несколько пунктов (смотрите 
также <орііоп>) 
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Таблица 15.1 (продолжение) 


НТМЬ-элемент 

Свойство іуре 

Обработчик 

событий 

Описание и события 

<іпрь* *уре="зиЬті*''> 

или 

<Ьь**оп *уре="зиЬті*"> 

"зііЬті*" 

опсііск 

Кнопка, инициирующая отправку 
формы 

<іпрь* *уре="*ех*"> 

"*ех*" 

опсііапде 

Однострочное текстовое поле ввода; 
по умолчанию в элементе <іпрь*> ат¬ 
рибут *уре отсутствует или не опо¬ 
знается 

<*ех*агеа> 

"*ех*агеа" 

операнде 

Многострочное текстовое поле ввода 


15.9.1. Выбор форм и элементов форм 

Формы и элементы, содержащиеся в них, можно выбрать с помощью стандарт¬ 
ных методов, таких как де*Е1етеп*ВуІР() и де*Е1етеп*зВуТадМате(): 

ѵаг ГіеІРз = Росшеп*. де*Е1етеп*ВуІР(' , аРРгез5"). де*Е1етеп*зВуТадМате( 'іприі;"); 

В броузерах, поддерживающих диегу5е1ес*огА11(), можно выбрать все радиокноп¬ 
ки или все элементы с одинаковыми именами, присутствующие в форме, как по¬ 
казано ниже: 

// Все радиокнопки в форме с атрибутом ісІ=''зИірріпд " 

Росшеп*. диегу5е1ес*огА11( '«зііірріпд іпри1;[ 1;уре=" гасііо " ]'); 

// Все радиокнопки с атрибутом пате=”те1:ИосІ” в форме с атрибутом ісІ=**зИірріпд" 

Росшеп*. дііегу5е1ес*огА11( '«зііірріпд іпри*[*уре="гаРіо''][пате=''те*ІюР'']'); 

Однако, как описывалось в разделах 14.7,15.2.2 и 15.2.3, элемент <^огт> с установ¬ 
ленным атрибутом пате или ісі можно также выбрать другими способами. Элемент 
<*огт> с атрибутом пате-’аРРгезз" можно выбрать любым из следующих способов: 

ѵі/іпРоѵі/. аРРгезз // Ненадежный: старайтесь не использовать 

Росшеп*. аРРгезз // Может применяться только к формам с атрибутом пате 

Росшеп*. *огтз. аРРгезз // Явное обращение к форме с атрибутом пате или ір 
Росшеп*.Гогтз[п] // Ненадежный: п - порядковый номер формы 

В разделе 15.2.3 говорилось, что свойство Роситеп^-Рогтз ссылается на объект НТМІ_- 
Со11ес*іоп, позволяющий выбирать элементы <*огт> по их порядковым номерам, 
по значению атрибута ІР или пате. Объекты Рогт сами по себе действуют подобно 
объектам НТМІ_Со11ес*іоп, хранящим элементы форм, и могут индексироваться 
именами или числами. Если первый элемент формы с атрибутом пате-’аРРгезз" 
имеет атрибут пате="з*гее*", на него можно сослаться с помощью любого из сле¬ 
дующих выражений: 

Росшеп*. *огтз.аРРгезз[0] 

Росшей*. *о гтз. аРР гезз. з* гее* 

Росшеп*.аРРгезз.з*гее* // только для пате="аРРгезз", но не іР=''аРРгезз” 

Если необходимо явно указать, что выполняется обращение к элементу формы, 
вместо объекта формы можно индексировать его свойство е1етеп*з: 
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сіоситепі; . Рогтз. асісі гезз. еіетет з[0] 
сіоситепі: . Рогтз. асісі гезз. еІетепІБ. зі: гееі 

Для выбора конкретных элементов документа предпочтительнее использовать ат¬ 
рибут ісі. Однако при отправке форм атрибут пате играет особую роль и чаще ис¬ 
пользуется с самими формами, чем с элементами форм. Обычно при работе с груп¬ 
пами флажков и обязательно при работе с группами радиокнопок для атрибута 
пате используется одно и то же значение. Напомню, что, когда объект НТМЮоНесИоп 
индексируется именем и существует сразу несколько элементов, использующих 
одно и то же имя, возвращаемым значением является объект, подобный массиву, 
содержащий все элементы с указанным именем. Взгляните на следующую фор¬ 
му, содержащую радиокнопки для выбора метода доставки товара: 

<Рогт пате="5Ііірріпд"> 

<^іе1сІ5е1:><1едепсІ>ЗИірріпд Ме1:ІіоР</1едепР> 

<1аЬе1><іприі: Руре="гасІіо" пате="теРІіосГ ѵа1ие="1зі:">Первым классом</1аЬе1> 
<1аЬе1><іпри1; Руре=''гасІіо" пате="теРІіосГ ѵа1ие="2с!ау"> 

За 2 дня самолетом 
</1аЬе1> 

<1аЬе1><іпри1; Руре=" гасііо" пате= "теРІіосГ ѵа1ие=”оѵегпі1:е"> 

В течение ночи 
</1аЬе1> 

</Ріе1сІ5е1:> 

</Рогт> 

Сослаться на массив радиокнопок в этой форме можно следующим образом: 

ѵаг теІіМоРБ = сіоситепі:. РогтБ.БМірріпд.еІетепііз.теІіМосІ; 

Обратите внимание, что элементы <Рогт> имеют НТМЬ-атрибут и соответствую¬ 
щее ему свойство с именем «теіЪосі», поэтому в данном случае необходимо ис¬ 
пользовать свойство еіетепііз формы вместо прямого обращения к свойству теІМосІ. 
Чтобы определить, какой метод доставки выбрал пользователь, необходимо обой¬ 
ти элементы формы в массиве и проверить свойство сИескеР каждого из них: 

ѵаг 5Ііірріпд_те1:ІюсІ; 

Рог(ѵаг і = 0; і < теІІюРз. ІепдРІі; і++) 

іР (теРЫхІзЦ]. сМескес!) 5Ііірріпд_те1:ІюР = те1:ИоРз[і].ѵаіие; 

Со свойствами элементов форм, такими как сПескеР и ѵаіие, мы поближе познако¬ 
мимся в следующем разделе. 

15.9.2. Свойства форм и их элементов 

Наиболее интересным для нас свойством объекта Рогт является массив е1етеп!з[], 
описанный выше. Остальные свойства объекта Рогт менее важны. Свойства асРі- 
оп, епсоРіпд, теІІюР и Рагдеі: непосредственно соответствуют атрибутам асРіоп, 
епсоРіпд, теІИоР и Рагдеі: элемента <Рогт>. Все эти свойства и атрибуты используют¬ 
ся для управления отправкой данных формы на веб-сервер и отображением ре¬ 
зультатов. Клиентский сценарий на языке Лѵабсгірі может устанавливать зна¬ 
чения этих свойств, но это имеет смысл, только когда форма действительно от¬ 
правляется серверной программе. 

До появления ЛѵаЗсгірі отправка форм выполнялась с помощью специальной 
кнопки ЗиЬтіІі, а сброс значений элементов формы в значения по умолчанию - 
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с помощью специальной кнопки Реве!. В языке ЛѵаЗсгірі тем же целям служат 
два метода, зиЬтИО и гезеІ(), объекта Рогт. Метод зиЬтИО объекта Рогт отправля¬ 
ет форму, а метод гезеІ( ) сбрасывает элементы формы в исходное состояние. 

У всех (или у большинства) элементов форм есть общие свойства, перечисленные 
далее. Кроме того, у некоторых элементов есть специальные свойства, которые 
будут описаны ниже, когда мы будем рассматривать элементы форм различных 
типов по отдельности. 

Іуре 

Доступная только для чтения строка, идентифицирующая тип элемента фор¬ 
мы. Для элементов форм, определяемых с помощью тега <іпри1:>, это свойство 
просто хранит значение атрибута Іуре. Другие элементы форм (такие как <1ех1> 
агеа> и <зе1ес1:>) также определяют свойство Іуре, благодаря чему его можно 
использовать в сценарии для идентификации элементов, подобно тому, как 
идентифицируются различные типы элементов <іпри1:>. Значения этого свойст¬ 
ва для каждого типа элементов форм перечислены во втором столбце табл. 15.1. 

Рогт 

Доступная только для чтения ссылка на объект Рогт, в котором содержится 
этот элемент, или пиіі, если элемент не находится внутри элемента <Рогт>. 

пате 

Доступная только для чтения строка, указанная в НТМЬ-атрибуте пате, 
ѵаіие 

Доступная для чтения и записи строка, определяющая «значение», содержа¬ 
щееся в элементе формы или представляемое им. Эта строка отсылается на 
веб-сервер при передаче формы и только иногда представляет интерес для 3 &- 
ѵаЗсгірі-программ. Для элементов Тех! и Техіагеа это свойство содержит вве¬ 
денный пользователем текст. Для кнопок, создаваемых с помощью тега <іпри1> 
(но не для кнопок, создаваемых с помощью тега <Ьи1:1:оп>), это свойство опреде¬ 
ляет отображаемый на кнопке текст. Свойство ѵаіие для элементов переключа¬ 
телей (радиокнопок) и флажков не редактируется и никак не представляется 
пользователю. Это просто строка, устанавливаемая НТМЬ-атрибутом ѵаіие. 
Эта строка предназначена для отправки веб-серверу, и ее можно использовать 
для передачи дополнительных данных. Свойство ѵаіие будет обсуждаться да¬ 
лее в этой главе, когда мы будем рассматривать различные категории элемен¬ 
тов формы. 

15.9.3. Обработчики событий форм и их элементов 

Каждый элемент Рогт имеет обработчик события опзиЬтіІ, возникающего в мо¬ 
мент отправки формы, и обработчик события опгезеі, возникающего в момент 
сброса формы в исходное состояние. Обработчик опзиЬтіІ вызывается непосредст¬ 
венно перед отправкой формы. Он может отменить отправку, вернув значение 
Гаізе. Это дает ЛѵаЗсгірі-программам возможность проверить ввод пользователя 
и избежать отправки неполных или ошибочных данных серверной программе. 
Обратите внимание, что обработчик опзиЬтіі: вызывается только в случае щелчка 
мышью на кнопке ЗиЬтіІ. Вызов метода зиЬтііО формы не приводит к вызову об¬ 
работчика опзиЬтіі. 
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Обработчик событий опгезеі похож на обработчик опзиЬтИ. Он вызывается непо¬ 
средственно перед сбросом формы в исходное состояние и может предотвратить 
сброс элементов формы, вернув значение Іаізе. Кнопки Пезеі редко используются 
в формах, но если у вас имеется такая кнопка, возможно, у вас появится желание 
запросить у пользователя подтверждение, прежде чем выполнить сброс: 

<^о гт... 

опге5е1="геіигп сопГігт('Вы действительно хотите сбросить все и начать сначала?')"> 

<Ьи11оп 1уре="гезе1">0чистить поля ввода и начать сначала</Ьи!1оп> 

</Гогт> 

Подобно обработчику опзиЬшіі:, обработчик опгезеі вызывается только в случае 
щелчка мышью на кнопке Пезеі. Вызов метода гезеі( ) формы не приводит к вызо¬ 
ву обработчика опгезеі. 

Элементы форм обычно возбуждают событие сііск или сМапде, когда пользователь 
взаимодействует с ними, и вы можете реализовать обработку этих событий, опре¬ 
делив обработчик опсііск или опсМапде. В третьем столбце таблицы 15.1 для каж¬ 
дого элемента формы указан основной обработчик событий. Вообще говоря, эле¬ 
менты форм, являющиеся кнопками, возбуждают событие сііск в момент актива¬ 
ции (даже когда активация производится посредством нажатия клавиши на кла¬ 
виатуре, а не щелчком мышью). Другие элементы форм возбуждают событие 
сМапде, когда пользователь изменяет содержимое, представляемое элементом. Это 
происходит, когда пользователь вводит текст в текстовое поле или выбирает эле¬ 
мент раскрывающегося списка. Обратите внимание, что это событие возбуждает¬ 
ся не каждый раз, когда пользователь нажимает клавишу, находясь в текстовом 
поле ввода. Оно возбуждается, только когда пользователь изменит значение эле¬ 
мента и перенесет фокус ввода в другой элемент. То есть этот обработчик событий 
вызывается по завершении ввода. Радиокнопки и флажки являются кнопками, 
хранящими информацию о своем состоянии, и все они возбуждают события сііск 
и сМапде; из них событие сМапде имеет большее практическое значение. 

Элементы форм также возбуждают событие Іосиз, когда они получают фокус вво¬ 
да, и событие Ыиг, когда теряют его. 

Важно знать, что внутри обработчика события ключевое слово ІМіз всегда ссыла¬ 
ется на элемент документа, вызвавший данное событие (подробнее об этом будет 
рассказываться в главе 17). Во всех элементах форм имеется свойство Іогш, ссы¬ 
лающееся на форму, в которой содержится элемент, поэтому обработчики собы¬ 
тий элемента формы всегда могут обратиться к объекту Рогш, как к іМіз.Іогш. Сде¬ 
лав еще один шаг, мы можем сказать, что обработчик событий для одной формы 
может ссылаться на соседний элемент формы, имеющий имя х, как ІМіз.іогт.х. 

15.9.4. Кнопки 

Кнопки являются одними из наиболее часто используемых элементов форм, т. к. 
они предоставляют понятный визуальный способ вызова пользователем какого- 
либо запрограммированного сценарием действия. Элемент кнопки не имеет соб¬ 
ственного поведения, предлагаемого по умолчанию, и не представляет никакой 
пользы без обработчика события опсііск. Кнопки, определяемые с помощью эле¬ 
ментов <іприі>, отображают простой текст, содержащийся в их свойстве ѵаіие. 
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Кнопки, определяемые с помощью элементов <Ьи11:оп>, отображают содержимое 
элемента. 

Обратите внимание, что гиперссылки предоставляют такой же обработчик собы* 
тий опсііск, как и кнопки. Когда действие, выполняемое обработчиком опсііск, 
можно классифицировать как «переход по ссылке», используйте ссылку. В про¬ 
тивном случае используйте кнопку. 

Элементы ЗиЬтИ и Резе! очень похожи на элементы-кнопки, но имеют связанные 
с ними действия, предлагаемые по умолчанию (передача или очистка формы). Ес¬ 
ли обработчик событий опсііск возвращает Гаізе, стандартное действие этих кно¬ 
пок, предусмотренное по умолчанию, не выполняется. Обработчик опсііск эле¬ 
мента ЗиЬтіІ: можно использовать для проверки введенных значений, но обычно 
это делается в обработчике опзиЬтіІ: самой формы. 

В четвертой части книги нет описания элемента Виііоп. Описание всех элементов- 
кнопок, включая описание элементов, создаваемых с помощью тега <Ьиі1:оп>, вы 
найдете в разделе, посвященном элементу Іпрііі:. 

15.9.5. Переключатели и флажки 

Флажки и радиокнопки имеют два визуально различимых состояния: они могут 
быть либо установлены, либо сброшены. Пользователь может изменить состояние 
такого элемента, щелкнув на нем. Радиокнопки обычно объединяются в группы 
связанных элементов, имеющих одинаковые значения НТМЬ-атрибута пате. При 
установке одной из радиокнопок предыдущая установленная в группе радиокноп¬ 
ка сбрасывается. Флажки тоже часто объединяются в группы с общим значением 
атрибута пате, и, когда вы обращаетесь к ним по имени, необходимо помнить, что 
вы получаете в ответ объект, подобный массиву, а не отдельный элемент. 

И флажки, и переключатели имеют свойство сііескесі. Это доступное для чтения 
и записи логическое значение определяет, отмечен ли элемент в данный момент. 
Свойство сІе^аиПСИескесІ представляет собой доступное только для чтения логиче¬ 
ское значение, содержащее значение НТМЬ-атрибута сЬескесІ; оно определяет, дол¬ 
жен ли элемент отмечаться, когда страница загружается в первый раз. 

Флажки и радиокнопки сами не отображают какой-либо текст и обычно выводят¬ 
ся вместе с прилегающим к ним НТМЬ-текстом (или со связанным тегом <1аЬе1>). 
Это значит, что установка свойства ѵаіие элемента флажка или радиокнопки не 
изменяет внешнего вида элемента. Свойство ѵаіие можно установить, но это изме¬ 
нит лишь строку, отсылаемую на веб-сервер при передаче данных формы. 

Когда пользователь щелкает на флажке или радиокнопке, элемент вызывает свой 
обработчик опсііск. Если состояние флажка или радиокнопки изменяется в ре¬ 
зультате щелчка мышью, они также вызывают обработчик событий опсМапде. 
(При этом радиокнопки, изменяющие состояние в результате щелчка на другой 
радиокнопке, не вызывают обработчик опсМапде.) 

15.9.6. Текстовые поля ввода 

Однострочные текстовые поля ввода Тех! применяются в НТМЬ-формах и Лѵа- 
Всгірі-программах, пожалуй, чаще других. Они позволяют пользователю ввести 
короткий однострочный текст. Свойство ѵаіие представляет текст, введенный 
пользователем. Установив это свойство, можно явно задать выводимый текст. 
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Определяемый стандартом НТМЬб атрибут ріасеііоійег позволяет указать строку 
приглашения к вводу, которая будет отображаться в поле ввода до того момента, 
пока пользователь не введет какой-нибудь текст: 

Дата прибытия: <іпри1: *уре="*ех*" паше="аггіѵа1" р1асеЬо1сІег=''уууу-тт-сі(Г> 

Обработчик событий опсііапде текстового поля ввода вызывается, когда пользова¬ 
тель вводит новый текст или редактирует существующий, а затем указывает, что 
он завершил редактирование, убрав фокус ввода из текстового поля. 

Элемент Техііагеа (многострочное текстовое поле ввода) очень похож на элемент 
Тех! за исключением того, что разрешает пользователю ввести (а Лѵа8сгірі-про- 
грамме вывести) многострочный текст. Многострочное текстовое поле создается 
тегом <1ехі:агеа>, синтаксис которого существенно отличается от синтаксиса тега 
<іпри1>, используемого для создания однострочного текстового поля. (Подробнее 
об этом см. в разделе с описанием элемента Техііагеа в четвертой части книги.) Тем 
не менее эти два типа элементов ведут себя очень похожим образом. Свойство 
ѵаіие и обработчик событий опсііапде элемента ТехТагеа можно использовать точно 
так же, как в случае с элементом Тех!. 

Элемент <іпри1: Туре="раззѵ\/огсГ> - это модификация однострочного текстового по¬ 
ля ввода, в котором вместо вводимого пользователем текста отображаются симво¬ 
лы звездочек. Как можно заключить из имени элемента, его можно использовать, 
чтобы дать пользователю возможность вводить пароли, не беспокоясь о том, что 
другие прочитают их через плечо. Следует понимать, что элемент РаззмогсІ защи¬ 
щает введенные пользователем данные от любопытных глаз, но при отправке 
данных формы эти данные никак не шифруются (если только отправка не выпол¬ 
няется по безопасному НТТР8-соединению) и при передаче по сети могут быть пе¬ 
рехвачены. 

Наконец, элемент <іприі: 1уре= Тііе ”> предназначен для ввода пользователем име¬ 
ни файла, который должен быть выгружен на веб-сервер. По существу, это одно¬ 
строчное текстовое поле, совмещенное со встроенной кнопкой, выводящей диалог 
выбора файла. У элемента выбора файла, как и у однострочного текстового поля, 
есть обработчик событий опсМапде. Однако, в отличие от текстового поля ввода, 
свойство ѵаіие элемента выбора файла доступно только для чтения. Это не дает 
злонамеренным ЛѵаЗсгірі-программам обмануть пользователя, выгрузив файл, 
не предназначенный для отправки на сервер. 

Различные текстовые элементы ввода определяют обработчики событий опкеу- 
ргезз, опкеусіомп и опкеуир. Можно вернуть 1"а1зе из обработчиков событий опкеу- 
ргезз или опкеусіомп, чтобы запретить обработку нажатой пользователем клави¬ 
ши. Это может быть полезно, например, когда требуется заставить пользователя 
вводить только цифры. Этот прием демонстрируется в примере 17.6. 

15.9.7. Элементы Зеіесі и Орііоп 

Элемент Зеіесі представляет собой набор вариантов (представленных элементами 
ОрТіоп), которые могут быть выбраны пользователем. Броузеры обычно отобража¬ 
ют элементы Зеіесі: в виде раскрывающихся меню, но, если указать в атрибуте зііе 
значение больше чем 1, они будут отображать их в виде списков (возможно, с поло¬ 
сами прокрутки). Элемент Зеіесі: может работать двумя сильно различающимися 
способами, а выбор того или иного способа определяется значением свойства Іуре. 
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Если в теге <зе1ес1:> определен атрибут гтшШрІе, пользователь сможет выбрать не¬ 
сколько вариантов, а свойство іуре объекта Зеіесі будет иметь значение «зеіесі- 
тиіііріе». В противном случае, если атрибут пшіііріе отсутствует, может быть вы: 
бран только один вариант и свойство іуре будет иметь значение «веіесі-опе». 

В некотором смысле элемент с возможностью множественного выбора похож на 
набор флажков, а элемент без такой возможности - на набор радиокнопок. Одна¬ 
ко варианты выбора, отображаемые элементом Зеіесі, не являются кнопками-пе¬ 
реключателями: они определяются с помощью тега <орііоп>. Элемент Зеіесі: опре¬ 
деляет свойство орііопз, которое является объектом, подобным массиву, храня¬ 
щим объекты Орііоп. 

Когда пользователь выбирает тот или иной вариант или отменяет выбор, элемент 
Зеіесі: вызывает свой обработчик событий опсРапде. Для элементов Зеіесі: с воз¬ 
можностью выбора единственного варианта, доступное только для чтения свойст¬ 
во зеіесіесііпсіех определяет выбранный в данный момент вариант. Для элементов 
Зеіесі с возможностью множественного выбора одного свойства зеіесіесііпсіех не¬ 
достаточно для представления полного набора выбранных вариантов. В этом слу¬ 
чае для определения выбранных вариантов следует в цикле перебрать элементы 
массива орііопз[] и проверить значения свойства зеіесіесі каждого объекта Орііоп. 

Кроме свойства зеіесіесі у каждого объекта Орііоп есть свойство іехі, задающее 
строку текста, которая отображается в элементе Зеіесі для данного варианта. Ис¬ 
пользуя это свойство, можно изменить видимый пользователем текст. Свойство 
ѵаіие представляет доступную для чтения и записи строку текста, который отсы¬ 
лается на веб-сервер при передаче данных формы. Даже если вы пишете исклю¬ 
чительно клиентскую программу и ваши формы никуда не отправляются, свой¬ 
ство ѵаіие (или соответствующий ей НТМЬ-атрибут ѵаіие) можно использовать 
для хранения данных, которые потребуются после выбора пользователем опреде¬ 
ленного варианта. Обратите внимание, что элемент Орііоп не определяет связан¬ 
ных с формой обработчиков событий; используйте вместо этого обработчик оп- 
сОапде соответствующего элемента Зеіесі. 

Помимо задания свойства Іехі объектов Орііоп имеются способы динамического 
изменения выводимых в элементе Зеіесі вариантов с помощью особых возможно¬ 
стей свойства орііопз, которые ведут свое существование с самого начала появле¬ 
ния поддержки клиентских сценариев. Можно обрезать массив элементов Орііоп, 
установив свойство орііопз.ІепдіО равным требуемому количеству вариантов, или 
удалить все объекты Орііоп, установив значение свойства орііопз.ІепдіО равным 
нулю. Можно удалять отдельные объекты Орііоп из элемента Зеіесі, присваивая 
элементам массива орііопз[] значение пиіі. В этом случае удаляются соответст¬ 
вующие объекты Орііоп, а все элементы, расположенные в массиве орііопз[] пра¬ 
вее, автоматически сдвигаются влево, заполняя опустевшее место. 

Чтобы добавить в элемент Зеіесі новый вариант, можно создать его с помощью 
конструктора Орііоп() и добавить в конец массива орііопз[], как показано ниже: 


// Создать новый объект Орііоп 



ѵаг гаіге = пей 0рііоп('7аіге", 

// Свойство 

іехі 

"гаіге", 

// Свойство 

ѵаіііе 

Гаізе, 

// Свойство 

сІе^ацІіЗеІесіесІ 

Шзе); 

// Свойство 

зеіесіесі 


// Отобразить вариант в элементе Зеіесі, добавив его в конец массива орііопз: 
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ѵаг соипігіез = боситепі:.асісігезз. соипТгу; // Получить объект Зеіесі: 
соипТгіез. орТіоп5[соипі:гіе5. орТіопз. ІепдТП] = гаіге; 

Имейте в виду, что эти специальные возможности элемента Зеіесі: пришли к нам 
из прошлых времен. Вставку и удаление вариантов можно реализовать более оче¬ 
видным способом, воспользовавшись стандартными методами Ооситепі. сгеаіе- 
ЕІетепіО, Мойе.іпзегіВеІогеО, №оде.гетоѵе(М1с1() и другими. 

15.10. Другие особенности документов 

Эта глава начиналась с утверждения, что она является одной из наиболее важ¬ 
ных в книге. Она также по необходимости оказалась одной из наиболее длинных. 
Этот раздел завершает главу описанием некоторых особенностей объекта Ооситепі. 

15.10.1. Свойства объекта Ооситепі 

В этой главе уже были представлены некоторые свойства объекта Ооситепі:, такие 
как Ьойу, сІоситепіЕІетепІ и Іогтз, ссылающиеся на специальные элементы доку¬ 
мента. Кроме них документы определяют еще несколько свойств, представляю¬ 
щих интерес: 

соокіе 

Специальное свойство, позволяющее ЛѵаВсгірі-программам читать и писать 
соокіе-файлы. Это свойство рассматривается в главе 20. 

йотаіп 

Свойство, которое позволяет доверяющим друг другу веб-серверам, принадле¬ 
жащим одному домену, ослаблять ограничения, связанные с политикой обще¬ 
го происхождения, на взаимодействие между их веб-страницами (подробно¬ 
сти см. в разделе 13.6.2.1). 

ІазІМосІіІіесІ 

Строка, содержащая дату последнего изменения документа. 

Іосаііоп 

Это свойство ссылается на тот же объект І_осаІіоп, что и свойство Іосаііоп объ¬ 
екта Міпсіом. 

геіеггег 

ІШЬ-адрес документа, содержащего ссылку (если таковая существует), кото¬ 
рая привела броузер к текущему документу. Это свойство имеет то же значе¬ 
ние, что и НТТР-заголовок Песете г, но записывается с двумя буквами г. 

Ііііе 

Текст между тегами <Ш1е> и </Ш1е> данного документа. 

ові_ 

Свойство ІІВІ_ документа является строкой, доступной только для чтения, а не 
объектом І_осаІіоп. Значение этого свойства совпадает с начальным значением 
свойства Іосаііоп. И геі, но, в отличие от объекта 1_осаііоп, не является динами¬ 
ческим. Если пользователь выполнит переход, указав новый идентификатор 
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фрагмента внутри документа, то свойство ІосаГіоп.Гі геГ изменится, а свойство 
сіоситепі:.ІІРЬ - нет. 

Из всех этих свойств наибольший интерес представляет свойство геГеггег: оно со-' 
держит ІІКЬ-адрес документа, содержащего ссылку, которая привела пользова¬ 
теля к текущему документу. Это свойство можно было бы использовать, как по¬ 
казано ниже: 

іГ (сіоситепі: . ге^еггег. іпс!ехОГ("Гі1:і:р : //ѵ^/ѵѵѵѵ.доодіе.сот/зеагсЬ?") == 0) { 
ѵаг агдз = сіоситепі:. геГеггег. зиЬзі:гіпд(ге^. іпсЗехОГ(”?" )+1 ). зрііі:("&"); 

Гог(ѵаг і = 0; і < агдз.ІепдТЬ; і++) { 
іГ (агдз[і].зыЬзІ:гіпд(0,2) == "д=") { 

йоситепі.игіТе("<р>Добро пожаловать, пользователь Ооодіе. "); 
сіоситепі:. и г іГе(" Вы искали: " + 

ипезсаре(агдз[і]. зиЬзі:гіпд(2)). гер1асе(' + ', ' '): 

Ьгеак; 

} 

} 

} 

Метод с!оситеп1:.\л/гі1:е(), использованный в этом примере, является темой следую¬ 
щего раздела. 

15.10.2. Метод сІоситегг1.ѵѵгііе() 

Метод йоситеп1:.\л/гіі:е() был одним из первых методов, реализованных еще в веб¬ 
броузере Кеізсаре 2. Он появился еще до создания модели БОМ и представлял 
единственный способ отображения динамически изменяемого текста в докумен¬ 
те. В современных сценариях надобность в этом методе отпала, но вы наверняка 
встретите его в существующем программном коде. 

Метод сіоситепі:.ѵѵгі1:е( ) объединяет свои строковые аргументы и вставляет полу¬ 
чившуюся строку в документ, в точку вызова метода. По завершении выполне¬ 
ния сценария броузер выполнит синтаксический анализ сгенерированного выво¬ 
да и отобразит его. Например, следующий фрагмент использует метод мгі1:е( ) для 
динамического вывода информации в статический НТМЬ-документ: 

<зсгірі:> 

йосьтепГ. игіГе("<р>Заголовок документа: " + сіоситепі:. ГШе); 
сіосіітепі:.игі1:е("<Ьг>иПІ_: " + сіоситепі:.ІІРЬ); 

сіоситепі. игіГе("<Ьг>Ссылающийся на него документ: " + сіоситепі:. геГеггег); 
сіоситепі:.\л/гіГе("<Ьг>Изменен: " + сіоситепі:. 1аз1:МосііГіес1); 
сіоситепі. ѵ»/гіі:е(''<Ьг>Открыт: " + пей 0аіе()); 

</зсгірі> 

Важно понимать, что метод ѵ\/гііе() можно использовать для вывода разметки 
НТМЬ только в процессе синтаксического анализа документа. То есть вызывать 
метод сіоситепі:.ѵ\/гііе() из программного кода верхнего уровня в теге <зсгірі> мож¬ 
но только в случае, если выполнение сценария является частью процесса анализа 
документа. Если поместить вызов сіоситепі:.мгііе() в определение функции и затем 
вызвать эту функцию из обработчика события, результат окажется неожидан¬ 
ным - этот вызов уничтожит текущий документ и все содержащиеся в нем сцена¬ 
рии! (Почему это происходит, будет описано чуть ниже.) По тем же причинам 
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нельзя использовать РоситепТ.мгНеО в сценариях с установленными атрибутами 
йе^ег или азупс. 

Пример 13.3 в главе 13 использует метод йоситеп1:.\л/гі1:е() указанным способом/ 
чтобы сгенерировать более сложный вывод. 

Метод мгіІеО можно использовать для создания полностью новых документов 
в других окнах и фреймах. (Однако при работе с другими окнами и фреймами не¬ 
обходимо позаботиться о том, чтобы не нарушать политику общего происхожде¬ 
ния.) Первый вызов метода мгіТеО другого документа полностью уничтожит 
имеющееся содержимое этого документа. Метод мгііеО можно вызывать много¬ 
кратно, тем самым добавляя новое содержимое в документ. Содержимое, переда¬ 
ваемое методу мгіІеО, может буферизоваться (и не отображаться), пока не будет 
выполнен завершающий вызов метода с1озе() объекта документа, сообщающий 
парсеру, что работа с документом окончена и он может выполнить разбор доку¬ 
мента и отобразить его. 

Следует отметить, что объект Ооситепі: поддерживает также метод мгі1:е1п(), кото¬ 
рый идентичен методу мгіТеО, за исключением того, что он добавляет символ пе¬ 
ревода строки после вывода своих аргументов. Это может пригодиться, напри¬ 
мер, при выводе форматированного текста внутри элемента <рге>. 

Метод сІоситеп1:.мгі1:е() редко используется в современных сценариях: свойство 
іппегНТМІ_ и другие приемы, поддерживаемые моделью БОМ, обеспечивают более 
удачные способы добавления содержимого в документ. С другой стороны, некото¬ 
рые алгоритмы лучше укладываются в схему потокового ввода/вывода, реали¬ 
зуемую методом \ѵгі1:е( ). Если вы создаете сценарий, который динамически гене¬ 
рирует и выводит текст в процессе своего выполнения, вам, возможно, будет ин¬ 
тересно ознакомиться с примером 15.10, в котором свойство іппегНТМІ указанного 
элемента обертывается простыми методами мгііеО и с1озе(). 

Пример 15.10. Интерфейс потоков ввода-вывода к свойству іппегНТМЬ 

// Определить простейший интерфейс "потоков ввода/вывода” для свойства іппегНТМІ элемента. 
Гипсііоп Е1ешепі:31:геат(е11:) { 

іГ (ТуреоТ еіі === "зігіпд”) еИ = сіоситепі:.деТЕ1етеп1:ВуІс1(е11:): 

ТІгіз. еІТ = еіі; 
іПіз. ЬііІ'Гег = 

} 

// Объединяет все аргументы и добавляет в буфер 
ЕІетепіЗігеагл.ргоіоіуре.ѵу/гііе = ^псііопО { 

ііііз. ЬііГ^ег += Аггау. ргоіоіуре. іоіп.саЩагділпепіз, 

}; 

// То же, что и ѵу/гііеО, но добавляет символ перевода строки 
ЕІетепіЗІігеат. ргоіоіуре. игііеіп = ^псііопО { 

ііііз.ЬііГ^ег += Аггау.ргоіоіуре.^оіп.саіі(агдитепТз. + "\п"; 

}; 

// Переносит содержимое буфера в элемент и очищает буфер. 

ЕІетепіЗігеат. ргоіоіуре.сіозе = Гітс1:іоп() { 
ііііз. еіі. іппегНТМІ = іНіз. ЬиТ^ег; 

Шз. Ьііі^ег = 

}; 




440 


Глава 15. Работа с документами 


15.10.3. Получение выделенного текста 

Иногда удобно иметь возможность определять, какой участок текста документа 
выделен пользователем. Сделать это можно, как показано ниже: 

Гыпсіііоп де1:5е1ес1:есІТех1:( ) { 

і? (иіпсІои.деІіЗеІесІііоп) // Функция, определяемая стандартом НТМІ_5 
геіцгп ѵапсіом.деі5е1ес1:іоп( ). *о5*гіпд( ); 
еізе іТ (сіосцглепі:. зеіесіііоп) // Прием, характерный для ІЕ. 
геішгп сіосцглепі:. зеіесіііоп. сгеа1:еПапде(). *ех*: 

} 

Стандартный метод ѵуіпсіоѵу. де1:Зе1ес1:іоп( ) возвращает объект Зеіесіііоп, описываю* 
щий текущий выделенный текст, как последовательность одного или более объек¬ 
тов Напде. Объекты Зеіесіііоп и Папде определяют чрезвычайно сложный приклад¬ 
ной интерфейс, который практически не используется и не описывается в этой 
книге. Наиболее важной и широко реализованной (везде, кроме ІЕ) особенностью 
объекта Зеіесіііоп является его метод 1о51гіпд( ), который возвращает простое тек¬ 
стовое содержимое выделенной области. 

Броузер ІЕ определяет иной прикладной интерфейс, который не описывается 
в этой книге. Метод сіоситепіі.зеіесіііоп возвращает объект, представляющий вы¬ 
деленную область. Метод сгеаіеНапдеО этого объекта возвращает реализованный 
только в ІЕ объект ТехіНапде, свойство іехіі которого содержит выделенный текст. 

Прием, подобный приведенному в примере выше, в частности, может пригодить¬ 
ся в букмарклетах (раздел 13.2.5.1) для организации поиска выделенного текста 
в поисковых системах или на сайте. Так, следующая НТМЬ-ссылка пытается 
отыскать текущий выделенный фрагмент текста в Википедии. Если поместить 
в закладку эту ссылку и ІЖЬ-адрес со спецификатором ^аѵавсгіріі:, закладка пре¬ 
вратится в букмарклет: 

<а Іпге1 = =”^аѵазсгірі: : ѵаг ц; 

іТ (иіпсІои.деІіЗеІесІііоп) ц = міпсІом.деіЗе1есііоп().іо$ігіпд(); 

еізе (сіосцглепі:.зеіесіііоп) ц = сіосцглепі:.зеіесіііоп.сгеа1:еПапде().*ехі; 

ѵоісі иіпсіоѵ»/. ореп( *Ыііір://гц.ѵѵікіресііа. огд/\ѵікі/' + д);"> 

Поиск выделенного текста в Википедии 
</а> 

В примере выше, выбирающем выделенный текст, есть одна проблема, связанная 
с несовместимостью. Метод деіЗе1ес1ііоп( ) объекта Іл/іпсісм не возвращает выделен¬ 
ный текст, если он находится внутри элемента <іприі> или <іех1іагеа>: он возвра¬ 
щает только тот текст, который выделен в теле самого документа. В то же время 
свойство сіоситепіі.зеіесіііоп, поддерживаемое броузером ІЕ, возвращает текст, вы¬ 
деленный в любом месте в документе. 

Чтобы получить текст, выделенный в текстовом поле ввода или в элементе <іех1і- 
агеа>, можно использовать следующее решение: 

еіі.ѵаіце.зцЬзігіпд(е1і.зеІесііопЗіагі, еіі.зеІесіііопЕпсІ): 

Свойства зеІесііопЗІіагІі и зеІесіііопЕпсІ не поддерживаются в версиях ІЕ8 и ниже. 
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15.10.4. Редактируемое содержимое 

Мы уже познакомились с элементами форм, включая текстовые поля ввода и эле* 
менты іехіагеа, которые дают пользователям возможность вводить и редактиро¬ 
вать простой текст. Вслед за ІЕ все текущие веб-броузеры стали поддерживать 
простые средства редактирования разметки НТМЬ. Вы можете увидеть их в дей¬ 
ствии на страницах (например, на страницах блогов, где можно оставлять ком¬ 
ментарии), встраивающих редактор форматированного текста с панелью инстру¬ 
ментов, содержащей кнопки для выбора стиля отображения шрифта (полужир¬ 
ный, курсив), настройки выравнивания и вставки изображений и ссылок. 

Существует два способа включения поддержки возможности редактирования. 
Можно установить НТМЬ-атрибут сопІепІіесІіІіаЫе любого тега или установить 
ѵаВсгірі-свойство сопІепІіесІіІіаЫе соответствующего элемента Еіетепі:, содержи¬ 
мое которого разрешается редактировать. Когда пользователь щелкнет на содер¬ 
жимом внутри этого элемента, появится текстовый курсор и пользователь смо¬ 
жет вводить текст с клавиатуры. Ниже представлен НТМЬ-элемент, создающий 
область редактирования: 

<с!іѵ ісІ="есІі1:ог" сопіепіе<1і*аЫе> 

Щелкните здесь, чтобы отредактировать 

</сііѵ> 


Броузеры могут поддерживать автоматическую проверку орфографии для полей 
форм и элементов с атрибутом сопІепІіесІіІіаЫе. В броузерах, поддерживающих та¬ 
кую проверку, она может быть включена или выключена по умолчанию. Чтобы 
явно включить ее, следует добавить атрибут зреІІсИеск. А чтобы явно запретить - 
добавить атрибут зреіісвеск^аізе (если, например, в элементе <1ех1:агеа> предпо¬ 
лагается выводить программный код или другой текст с идентификаторами, от¬ 
сутствующими в словаре). 

Точно так же можно сделать редактируемым весь документ, записав в свойство 
сІезідпМосІе объекта Ооситепі: строку «оп». (Чтобы снова сделать документ доступ¬ 
ным только для чтения, достаточно записать в это свойство строку «оН>.) Свойст¬ 
во сІезідпМосІе не имеет соответствующего ему НТМЬ-атрибута. Можно сделать до¬ 
кумент доступным для редактирования, поместив его в элемент <і1тате>, как по¬ 
казано ниже (обратите внимание, что здесь используется функция опІ_оас!() из 
примера 13.5): 


<і1тате іс!="ес1і1:о г" 5гс="аЬоіі1::Ь1апк"></і1тате> 
<зсгірі:> 

опІоасІ( І'ипсІііопС ) { 

ѵаг есіііог = сіоситепі:.де1:Е1етеп1:ВуІс1("ес!і1:ог"); 
есИ1:о г. сопііепІОосипіепІ:. сІезідпМосІе = "оп"; 

}); 

</зсгірі:> 


// Пустой фрейм 

// После загрузки 
// найти фрейм документа 
// и включить режим 
// редактирования. 


Все текущие броузеры поддерживают свойства сопіепІіесІіІіаЫе и сІезідпМосІе. Однако 
они оказываются плохо совместимыми, когда дело доходит до фактического ре¬ 
дактирования. Все броузеры позволяют вставлять и удалять текст и перемещать 
текстовый курсор с помощью клавиатуры и мыши. Во всех броузерах нажатие 
клавиши Епіег выполняет переход на новую строку, но разные броузеры создают 
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в результате разную разметку. Некоторые начинают новый абзац, другие просто 
вставляют элемент <Ьг/>. 

Некоторые броузеры позволяют использовать горячие комбинации клавиш, та' 
кие как СЫ-В, чтобы изменить шрифт выделенного текста на полужирный. В дру¬ 
гих броузерах (таких как Рігеіох) стандартные для текстовых процессоров ком¬ 
бинации, такие как СЫ-В и ЙгИ, выполняют другие операции, имеющие отноше¬ 
ние к самому броузеру, а не к текстовому редактору. 

Броузеры определяют множество команд редактирования текста, для большин¬ 
ства из которых не предусмотрены горячие комбинации клавиш. Чтобы выпол¬ 
нить эти команды, необходимо использовать метод ехесСоттапсі( ) объекта Ооситепі:. 
(Обратите внимание, что это метод объекта Оосіітепі:, а не элемента с атрибутом 
соп*еп*ес!іІаЫе. Если документ содержит более одного редактируемого элемента, 
команда применяется к тому из них, в котором в текущий момент находится тек¬ 
стовый курсор.) Команды, выполняемые методом ехесСоттапсі(), определяются 
строками, такими как «ЪоЫ*, «виЪвсгірі*, «щвШусепіег* или «іпвегііта^е*. Имя 
команды передается методу ехесСоттапсі() в первом аргументе. Некоторые коман¬ 
ды требуют дополнительное значение. Например, команда «сгеаіеііпк* требует 
указать ІШЬ для гиперссылки. Теоретически, если во втором аргументе передать 
методу ехесСоттапсі() значение Іігііе, броузер автоматически запросит у пользова¬ 
теля ввести необходимое значение. Однако для большей совместимости вам необ¬ 
ходимо самим запрашивать у пользователя требуемые данные, передавая Гаізе 
во втором аргументе и требуемое значение - в третьем аргументе. 

Ниже приводятся две функции, которые реализуют редактирование с помощью 
метода ехесСоттапсі(): 

і'ііпсіііоп ЬоІсК) { сіоситепі: . ехесСоттапсІС'ЬоІсГ. Шзе, тЛІ); } 

^псИоп 1іпк() { 

ѵаг іі гі = рготрі:('' В ведите адрес гиперссылки"); 

і? (и гі ) сіоситепі:. ехесСоттапсК’сгеаІіеІіпк'', ^аізе, иг1)\ 

) 

Команды, выполняемые методом ехесСоттапсі(), обычно запускаются кнопками 
на панели инструментов. Качественный пользовательский интерфейс должен за¬ 
прещать доступ к кнопкам, если вызываемые ими команды недоступны. Чтобы 
определить, поддерживается ли некоторая команда броузером, можно передать 
ее имя методу сіоситепі:.диегуСоттапсІЗиррогІесК ). Вызовом метода сіоситепі:. диегуСот- 
тапсІЕпаЫесІО можно узнать, доступна ли команда в настоящее время. (Команда, 
которая выполняет некоторые действия с выделенным текстом, например, может 
быть недоступна, пока не будет выделен фрагмент текста.) Некоторые команды, 
такие как «ЪоЫ* и «ііаііс*, могут иметь логическое состояние «включено* или 
«выключено* в зависимости от наличия выделенного фрагмента текста или ме¬ 
стоположения текстового курсора. Как правило, эти команды представлены на 
панели инструментов кнопками-переключателями. Для определения текущего 
состояния таких команд можно использовать метод сіоситепі:.диегуСоттапсІЗіаІеО. 
Наконец, некоторые команды, такие как «{опіпате», ассоциируются с некото¬ 
рым значением (именем семейства шрифтов). Узнать это значение можно с помо¬ 
щью метода сіоситепі:.диегуСоттапсІѴа1ие(). Если в текущем выделенном фрагменте 
используются шрифты двух разных семейств, команда «йтіпате* будет иметь 
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неопределенное значение. Для проверки этого случая можно использовать метод 

сіоситепі:. диегуСоттапсІІпсІе1:егт( ). 

Различные броузеры реализуют различные наборы команд редактирования. Не¬ 
которые команды, такие как «ЪокЬ, «ііаііс», «сгеаіеііпк», «шкіо» и «гебо», под¬ 
держиваются всеми броузерами. 1 На момент написания этих строк проект стан¬ 
дарта НТМЬб определял команды, перечисленные ниже. Однако, поскольку они 
реализованы пока не во всех броузерах, здесь не будет даваться сколько-нибудь 
подробное их описание: 


Ьоісі 

сгеаТеІ-іпк 

сіеіеіе 

^огтаІВІоск 

^огѵі/агсЮеІеТе 

іпзегТІтаде 

іпзегТНТМі. 


іпзегТІлпеВгеак 

іпзегііОгсІегесІЬізІ: 

іпзегтипогсіегесііізі: 

іпзегТРагадгарІі 

іпзегТТехІ: 

іТаІіс 

гесіо 


зеІесІАП 

зиЬзс гірі: 

зіірегзсгірі: 

ипсіо 

ііпііпк 

ііпзеіесі: 


Если вашему веб-приложению потребуется обеспечить возможность редактиро¬ 
вания форматированного текста, то вам, вероятно, лучше обратить внимание на 
уже реализованные решения, учитывающие различия между броузерами. В Ин¬ 
тернете можно найти множество готовых компонентов редакторов. 2 Следует от¬ 
метить, что функция редактирования, встроенная в броузеры, обладает доста¬ 
точно широкими возможностями, чтобы дать пользователю возможность вводить 
небольшие объемы форматированного текста, но она оказывается недостаточно 
мощной для создания серьезных документов. Обратите внимание, в частности, 
что разметка НТМЬ, генерируемая этими редакторами, весьма далека от идеала. 

После того как пользователь отредактирует содержимое элемента с атрибутом 
сопІепІесІіІаЫе, можно воспользоваться свойством іппегНТМЦ чтобы получить раз- 
метку НТМЬ отредактированного содержимого. Что дальше делать с полученным 
отформатированным текстом, полностью зависит от вас. Его можно сохранить 
в скрытом поле формы и отправить вместе с формой на сервер. Непосредственную 
отправку отредактированного текста на сервер можно выполнить с помощью 
приемов, описываемых в главе 18. Можно также сохранить результаты редакти¬ 
рования локально, с помощью механизмов, описываемых в главе 20. 


1 Список поддерживаемых команд можно найти по адресу кіір://іѵіѵіѵ.диігк8тод,е.огё/ 
йот/ехесСоттапй.кітІ. 

2 Фреймворки ѴШ и Боіо включают такие компоненты редакторов. Список других ре¬ 
шений можно найти на странице кІІр://еп.іѵікіре<Ііа.огё/іѵікі/ОпІіпе_гіск-ІехІ_е(Шог . 
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Каскадные таблицы стилей 


Каскадные таблицы стилей (Савсайіпз 8іу1е 8Ьееів, С88) - это стандарт визуаль¬ 
ного представления НТМЬ-документов. Каскадные таблицы стилей предназначе¬ 
ны для использования дизайнерами: они позволяют точно определить шрифты, 
цвета, величину полей, выравнивание, параметры рамок и даже координаты эле¬ 
ментов в документе. Но они также представляют интерес и для программистов, 
пишущих на клиентском языке Лѵабсгірі, потому что позволяют воспроизво¬ 
дить анимационные эффекты, такие как плавное появление содержимого доку¬ 
мента из-за правого края, например, или сворачивание и разворачивание списков, 
благодаря чему пользователь получает возможность управлять объемом отобра¬ 
жаемой информации. Когда подобные визуальные эффекты только появились, 
они казались революционными. Совместное применение технологий С88 и Лаѵа- 
8сгірі, обеспечивающее получение разнообразных визуальных эффектов, полу¬ 
чило не совсем удачное название «динамический язык НТМЬ» (Бупатіс НТМЬ, 
БНТМЬ), которое уже вышло из употребления. 

С88 - достаточно сложный стандарт, который на момент написания этих строк 
продолжал активно развиваться. Тема С88 настолько объемная, что для полного 
ее охвата потребовалось бы написать отдельную книгу, и ее детальное обсужде¬ 
ние выходит далеко за рамки этой книги. 1 Однако чтобы освоить принципы ра¬ 
боты с каскадными таблицами стилей, совершенно необходимо знать хотя бы ос¬ 
новы С88 и наиболее часто используемые стили. Поэтому эта глава начинается 
с обзора С88, за которым следует описание ключевых стилей, наиболее часто ис¬ 
пользуемых в сценариях. Вслед за этими двумя вводными разделами глава пере¬ 
ходит к описанию принципов работы с С88. В разделе 16.3 описываются наибо¬ 
лее общие и важные приемы: изменение стилей, применяемых к отдельным эле¬ 
ментам документа с помощью НТМЬ-атрибута зііуіе. Атрибут зііуіе элемента мож¬ 
но использовать для задания стилей, но с его помощью нельзя узнать текущие 
настройки стилей элементов. В разделе 16.4 рассказывается, как можно полу- 


1 Рекомендуемое издание: Эрик Мейер «С88 - каскадные таблицы стилей. Подробное 
руководство», 3-е издание - Пер. с англ. - СПб.: Символ-Плюс, 2008. 
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чить вычисленные стили любого элемента. В разделе 16.5 вы узнаете, как можно 
изменить сразу несколько стилей путем изменения атрибута зііуіе элемента. Име¬ 
ется также возможность непосредственно управлять таблицами стилей, хотя это 
и редко используется на практике. В разделе 16.6 будет показано, как включать 
и отключать таблицы стилей, изменять правила в существующих таблицах и до¬ 
бавлять новые таблицы. 

16.1. Обзор С55 

Визуальное представление НТМЬ-документов определяется множеством пара¬ 
метров: шрифты, цвета, отступы и т. д. Все эти параметры перечислены в стан¬ 
дарте С88, где они называются свойствами стиля (віуіе ргорегііев). Стандарт 
С88 определяет свойства, которые задают шрифты, цвета, величину полей, пара¬ 
метры рамок, фоновые изображения, выравнивание текста, размеры элементов 
и их позиции. Чтобы задать визуальное представление НТМЬ-элементов, мы оп¬ 
ределяем соответствующие значения С88-свойств. Для этого необходимо запи¬ 
сать имя свойства и его значение через двоеточие: 

^опІ-иеідШ: Ьоісі 

Чтобы полностью описать визуальное представление элемента, обычно бывает 
необходимо указать значения нескольких свойств. Когда требуется записать не¬ 
сколько пар имя/значение, они отделяются друг от друга точками с запятой: 

тагдіп-ІеМ: 10%; /* левое поле 10% от ширины страницы */ 

Іехі-іпсіепі: . 5іп; /* отступ 1/2 дюйма */ 

^опі-зіге: 12р{; /* размер шрифта 12 пунктов */ 

Как видите, в каскадные таблицы стилей можно помещать комментарии, заклю¬ 
чая их в пары символов /* и */• Однако здесь не поддерживаются комментарии, 
начинающиеся с символов //. 

Существует два способа связать набор значений С88-свойств с НТМЬ-элемента- 
ми, чье визуальное представление они определяют. Первый заключается в уста¬ 
новке атрибута зіуіе отдельного НТМЬ-элемента. Такие стили называются встро¬ 
енными: 

<р Зіу1е="тагдіп: 20рх; ЬогРег: зоіісі гесі 2рх;"> 

Этот абзац имеет увеличенные поля и окружен прямоугольной рамкой красного цвета. 

</р> 

Однако намного эффективнее отделять стили С88 от отдельных НТМЬ-элементов 
и определять их в таблицах стилей . Таблица стилей связывает наборы свойств 
стилей с группами НТМЬ-элементов, которые описываются с помощью селекто¬ 
ров. Селектор определяет, или «выбирает», один или более элементов документа, 
опираясь на атрибут ісі или сіазз, имя тега или на другие более специализирован¬ 
ные критерии. Селекторы были представлены в разделе 15.2.5, где также было 
показано, как с помощью риегуЗе1есІогА11( ) выбрать группу элементов, соответст¬ 
вующих селектору. 

Основным элементом таблицы стилей С88 является правило стиля, состоящее из 
селектора и набора свойств стиля с их значениями, заключенного в фигурные 
скобки. Таблица стилей может содержать любое количество правил: 
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р { /* селектору "р" соответствуют все элементы <р> */ 

ТехТ-іпРепі:: . 5іп; /* первая строка с отступом 0,5 дюйма */ 

} 

.магпіпд { /* Любой элемент с атрибутом сХаББ^'маггйпд" */ 

Ьаскдгоипсі-соіог: уеііоѵѵ; /* будет иметь желтый фон */ 

ЬогЬег: зоіісі Ыаск 5рх; /* и толстую черную рамку */ 

} 

Таблицу стилей С88 можно добавить в НТМЬ-документ, заключив ее в теги <з1:у- 
1е> и </з1:у1е> внутри тега <ЬеасІ>. Подобно элементам <зсгір1:>, синтаксический 
анализ содержимого элементов <з1:у1е> выполняется отдельно и не интерпретиру¬ 
ется как разметка НТМЬ: 

<Ы:т1> 

<ЬеасІ><1:і1:1е>Тестовый документ<Діі:1е> 

<5{у1е> 

Ьосіу { тагдіп-ІеГ*: ЗОрх; тагдіп-гідЫ:: 15рх; Ьаскдгоипсі-соіог: йННН } 
р { ^опі-зіге: 24рх; } 

</5*у1е> 

</Ьеас1> 

<Ьосіу><р>Проверка, проверка</р> 

</Ыт1> 

Если таблица стилей используется более чем в одной странице веб-сайта, ее обыч¬ 
но лучше сохранить в отдельном файле, без использования объемлющих НТМЬ- 
тегов. Затем этот файл С88 можно будет подключить к НТМЬ-странице. В отли¬ 
чие от элемента <зсгір1:>, элемент <зІу1е> не имеет атрибута зге. Чтобы подклю¬ 
чить таблицу стилей к НТМЬ-странице, следует использовать элемент <1іпк> в те¬ 
ге <Ьеасі> документа: 

<Ьеас1> 

<1і1:1е>Тестовый документ<ДіНе> 

<1іпк ге1="5І:у1е5Ьее1:" Ьгеі : ="туз1:у1е5.езз" 1уре='1:ех1:/с55"> 

</Ьеас1> 

Мы вкратце рассмотрели, как работают каскадные таблицы стилей. При этом 
с таблицами С88 связано несколько важных моментов, которые нужно знать 
и которые описываются в следующих подразделах. 

16.1.1. Каскад правил 

Напомню, что буква «С» в аббревиатуре С88 обозначает «сазсабе» (каскадная). 
Этот термин указывает, что правила стилей, применяемые к конкретному эле¬ 
менту документа, могут быть получены из «каскада» различных источников: 

• Таблицы стилей по умолчанию веб-броузера 

• Таблицы стилей документа 

• Атрибуты зіуіе отдельных НТМЬ-элементов 

Стили, определяемые в атрибуте зіуіе, переопределяют стили из таблицы стилей, 
а стили из таблицы стилей переопределяют таблицу стилей броузера, применяе¬ 
мую по умолчанию. Визуальное представление любого элемента может опреде¬ 
ляться комбинацией свойств стилей из всех трех источников. Более того, элемент 
может соответствовать сразу нескольким селекторам в таблице стилей. В этом 
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случае к элементу применяются все правила стилей, ассоциированные с такими 
селекторами. (Если различные селекторы определяют различные значения для 
одних и тех же свойств стилей, значение, ассоциированное с более конкретным 
селектором, переопределяет значение, ассоциированное с менее конкретным се¬ 
лектором, однако более подробное обсуждение выходит за рамки этой книги.) 

Для отображения любого элемента документа веб-броузер должен объединить ат¬ 
рибут зііуіе элемента со стилями из всех совпавших селекторов таблицах стилей 
документа. Результатом этого объединения является фактический набор свойств 
стилей и значений, которые используются для отображения элемента. Этот набор 
значений называется вычисленным стилем элемента. 

16.1.2. История развития С55 

С88 - это довольно старый стандарт. В декабре 1996 года был принят стандарт 
С881 и определены атрибуты для задания цвета, шрифта, полей, рамок и других 
базовых стилей. Такие старые броузеры, как Кеівсаре 4 и Іпіегпеі Ехріогег 4, 
в значительной степени поддерживают С881. Вторая редакция стандарта, С882, 
была принята в мае 1998 года; она определяет более развитые возможности, наи¬ 
более важной из которых является возможность абсолютного позиционирования 
элементов. Версия С882.1 дополняет и уточняет положения стандарта С882. Из 
нее были исключены возможности, которые не были реализованы в броузерах. Те¬ 
кущие броузеры практически полностью реализуют поддержку стандарта С882.1, 
хотя в версиях ІЕ, предшествовавших ІЕ8, имеются существенные пробелы. 

Работа над С88 продолжается и в настоящее время. Третья версия С88 разделена 
на специализированные модули, работа по стандартизации которых ведется по 
отдельности. Спецификации и рабочие проекты С88 можно найти по адресу 
Ыір://іѵіѵіѵ.іѵ3.ог§/8іуІе/С88/сиггепі-іиогк . 

16.1.3. Сокращенная форма определения свойств 

Свойства стиля, которые часто используются совместно, допускается объединять 
вместе, используя сокращенную форму записи. Например, свойства ‘ГопІі-'ГатіІу, 
^опі-зііе, ^опі-зіуіе и ^опІ-иеідЫ: можно определить в виде единственного свойст¬ 
ва ‘Гопі: с составным значением: 

Ьоісі ііаііс 24рі Ьеіѵеііса; 

Аналогично свойства Ьогсіег, тагдіп и расШпд являются сокращенными именами 
для свойств, определяющих параметры рамок, полей и отступов (пространство 
между рамкой и содержимым элемента) для каждой из сторон элемента. Напри¬ 
мер, чтобы определить параметры рамки для каждой из сторон в отдельности, 
вместо свойства Ьогсіег можно использовать свойства ЬогсІег-Іе^І:, ЬогсІег-гідЫ:, Ьог- 
сіег-іор и ЬогЬег-ЬоНют. Каждое из этих свойств также является сокращенной фор¬ 
мой записи. Вместо свойства ЬогЬег-Иор можно определить свойства ЬогЬег-Иор-со- 
Іог, ЬогсІег-1:ор-з1:у1е и Ьогсіег-Ііор-ѵѵісІІіЬ. 

16.1.4. Нестандартные свойства 

Когда производители броузеров реализуют нестандартные свойства С88, они до¬ 
бавляют префикс к именам свойств. В броузере Еіге^ох используется префикс 
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то 2 -, в СЬготе - -ѵѵеЬкіІ:-, а в ІЕ - -тз-. Производители броузеров добавляют пре¬ 
фиксы, даже когда реализуют свойства, которые в будущем, как предполагается, 
будут включены в стандарт. В качестве примера можно назвать свойство Ьогсіег- 
гасііиз, которое определяет закругленные углы. Это свойство впервые было реали¬ 
зовано как экспериментальное в Гіге&эх 3 и 8а?агі 4, и к его имени были добавле¬ 
ны соответствующие префиксы. Когда стандарт устоялся в достаточной степени, 
в версиях Рігеіох 4 и 8а?агі 5 префикс был убран, и теперь они поддерживают 
свойство Ьогсіе г- гасііиз без префикса. (СЬготе и Орега уже давно поддерживают 
это свойства без префикса. ІЕ9 также поддерживает его без префикса, но ІЕ8 не 
поддерживает его, даже с префиксом.) 

При работе со свойствами С88, которые в разных броузерах имеют отличающие¬ 
ся имена, можно определять для таких свойств классы: 

. гасіііізІО { 

Ьогсіег-гасііиз : Юрх; /* для текущих броузеров */ 

-то 2 -ЬогсІег-гасііиз: Юрх; /* для Рігеі'ох 3.x */ 

-ѵѵеЬкіІі-ЬогсІег-гасііиз : Юрх; /* для ЗаГагі 3.2 и 4 */ 

} 

Определив такой класс, можно просто добавить значение «гшШівІО» в атрибут 
сіазз любого элемента, чтобы дать элементу рамку с закругленными углами. 

16.1.5. Пример С55-таблицы 

Пример 16.1 представляет собой НТМЬ-файл, определяющий и использующий 
таблицу стилей. Он иллюстрирует селекторы, базирующиеся на имени тега, ат¬ 
рибутах сіаззиій, а также содержит встроенный стиль, определяемый атрибу¬ 
том зіуіе. На рис. 16.1 показано, как этот пример отображается в броузере. 


X? Могпіа йгеСок 


Оравкч 6 й * «іурнаг фіетру**>нт>й Сервиса 


. .. ::Г^Г"Г?:ГГГ 


-ІОІ Хі 


г.. 1 .. Л 


• .. «ѴаѴ аѴаѴа а. аѴа а'аѴа а а а'.ѴаѴаЧ а'.Ѵа ..... .". .а .......... а • Ѵв • а < 


Демонстрация каскадных таблиц стилей 


Предупреждение 

Это предупреждение! Обратите внимание, как оно 
привлекает внимание жирным шрифтом и яркими 
цветами. Также обратите внимание, что заголовок 
выровнен по центру и выделяется синим курсивом. 

тимштишимттииииитттммммт^ 

ЭТОТ АБЗАЦ ВЫРОВНЕН ПО ЦЕНТРУ 
И ВЫВОДИТСЯ прошеными БУКВАМИ 

Здесь мы явно используем встроенный стиль для переопределения прописных букв 

Готоес 


Рис . 16.1 . Веб-страница, оформленная с помощью С88 
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Пример 16.1. Определение и использование каскадных таблиц стилей 

<Ьеас1> 

<5І:у1е гуре= ,, гехІ/сзз ,, > 

/* Указывает, что заголовки отображаются курсивом синего цвета. */ 

М, Ь2 { соіог: Ыце; Топ*-5*у1е: іЛаІіс } 

Л 

* Любой элемент с атрибутом с1азз=**МАЙМІМС" отображается крупными жирными 

* символами, имеет большие поля и желтый фон с жирной красной рамкой. 

Ч 

.ИАРШС { 

^опіі-ѵѵеідМІ:: Ьоісі; 

Топ*-зі 2 е: 150%; 

тагдіп: 0 1іп 0 Ііп; /* сверху справа, снизу слева */ 
Ьаскдгоцпй-соіог: уеііом; 

Ьогбег: зоііб геб 8рх; 

расШпд: Юрх; /* 10 пикселов со всех 4 сторон */ 

} 

Л 

* Текст заголовков М и Ь2 внутри элементов с атрибутом с1а55="МАРІШ0" 

* должен быть выровнен по центру, в дополнение к выделению синим курсивом. 

Ч 

.МАЙЮ6 М, . МАПМІЫС Ь2 { *ех*-а1ідп : септет } 

Л 

* Отдельный элемент с атрибутом іб="зресіаГ' отображается 

* прописными буквами по центру. 

*/ 

йзресіаі { 

*ех1:-а1ідп: септет; 

ІехІ-ІгапзТогт: ііррегсазе; 

} 

</з1:у1е> 

</Ьеас1> 

<Ьос1у> 

<М Демонстрация использования каскадных таблиц стилей</М> 

<біѵ с1азз="1\ІАЙІШ0"> 

<Іі2>Предупреждение</Іі2> 

Это предупреждение! 

Обратите внимание, как оно привлекает внимание жирным шрифтом 
и яркими цветами. Также обратите внимание, что заголовок выровнен 
по центру и выделяется синим курсивом. 

</с!іѵ> 

<р іс1="5ресіа1"> 

Этот абзац выровнен по центру<Ьг> 
и выводится прописными буквами.<Ьг> 

<зрап 5*у1е="*ехі-ігап5Тогт: попе"> 

Здесь мы явно используем встроенный стиль для переопределения прописных букв. 
</зрап> 

</р> 
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Ультрасовременные свойства С55 

Когда я работал над этой главой, С88 находился в процессе революционных 
изменений: производители броузеров реализовали поддержку новых мощ¬ 
ных свойств стиля, таких как Ьогсіег-гасііиз, ІехІі-зИасІоѵѵ, Ьох-зМасІоѵѵ и соіитп- 
соипі. Другой качественно новой возможностью С88 стали веб-шрифты : но¬ 
вое С88-правило (дЯ'опМасе позволяет загружать и использовать нестан¬ 
дартные шрифты. (Подробнее о шрифтах, которые свободно могут исполь¬ 
зоваться в веб-страницах, и о простом механизме их загрузки с серверов 
компании Ооо^іе можно прочитать на странице Мір:/ /сойе.ёоо&е.сот/иеЪ- 
/ 0ТІІ8 .) 

Еще одной революционной разработкой в области каскадных таблиц сти¬ 
лей стал модуль «С88 Тгапзіііопз». Этот проект стандарта определяет воз¬ 
можности, позволяющие преобразовать в анимационные эффекты любые 
динамические изменения стилей С88 в документе. (Когда поддержка этого 
стандарта будет реализована достаточно широко, это позволит избавиться 
от программного кода, воспроизводящего анимационные эффекты, связан¬ 
ные со сменой стилей С88, как показано в разделе 16.3.1.) Положения моду¬ 
ля «С88 ТгапзШопз» реализованы во всех текущих броузерах, кроме ІЕ, но 
в именах свойств стиля присутствуют префиксы производителей. Проект 
родственного стандарта «С88 Апітаііопв», использующий модуль «С88 
ТгапзШопв* в качестве основы, определяет более сложные анимационные 
последовательности. В настоящее время «С88 Апітаііопз* реализован толь¬ 
ко в веб-броузерах, основанных на механизме \УеЪкіі. Ни один из этих стан¬ 
дартов не описывается в данной главе, но вам, как веб-разработчикам, нуж¬ 
но знать о существовании этих технологий. 

Другим проектом, касающимся С88, и о котором должны знать веб-разра- 
ботчики, является стандарт «С88 Тгапвіюгтз», позволяющий определять 
двухмерные преобразования (вращение, масштабирование, перемещение, 
а также их комбинации, определяемые в матричном виде), применяемые 
к любым элементам. Все текущие броузеры (включая версии ІЕ9 и выше) 
поддерживают этот проект с добавлением приставок, соответствующих 
производителям. Более того, в 8а?агі реализована поддержка расширения, 
позволяющего выполнять трехмерные преобразования, но пока неясно, по¬ 
следуют ли этому другие броузеры. 


16.2. Наиболее важные С5$-свойства 

Для разработчиков клиентских сценариев на языке Лаѵа8сгір1 наиболее важны¬ 
ми являются С88-свойства, которые позволяют задавать режим видимости, раз¬ 
мер и точную позицию отдельных элементов документа. Другие С88-свойства да¬ 
ют возможность определять порядок наложения слоев, степень прозрачности, 
вырезанные области, поля, отступы, рамки и цвета. При работе с С88-свойства- 
ми важно понимать, как работают свойства стиля. Они перечислены в табл. 16.1 
и более подробно описываются в последующих разделах. 





16.2. Наиболее важные С55-свойства 


451 


Таблица 16.1. Наиболее важные СЗЗ-свойства 


Свойство 

Описание 

розШоп 

Определяет тип позиционирования, применяемый к элементу 

Іор, ІеІЧ 

Позиция верхнего и левого краев элемента 

ЬоПот, гідИІ: 

Позиция нижнего и правого краев элемента 

ѵасіііі, Меідііі: 

Размер элемента 

2 -іпс 1 ех 

♦Порядок в стеке» относительно любых перерывающих его эле¬ 
ментов (третье измерение в позиционировании элемента) 

сіізріау 

Режим отображения элемента 

ѵізіЬіШу 

Режим видимости элемента 

сіір 

♦Область отсечения» элемента (отображаются только те части до¬ 
кумента, которые находятся внутри этой области) 

оѵегИоѵі/ 

Определяет, что следует делать, если размер элемента больше, 
чем предоставленное ему место 

тагдіп, ЬогРег, расісііпд 

Границы и рамки элемента 

Ьаскдгоітсі 

Цвет фона или фоновый рисунок для элемента 

орасііу 

Степень непрозрачности (или прозрачности) элемента. Это свой¬ 
ство относится к стандарту С883 и поддерживается не всеми бро¬ 
узерами. Работающая альтернатива имеется для ІЕ 


16.2.1. Позиционирование элементов с помощью С55 

С88-свойство розШоп задает тип позиционирования, применяемый к элементу. 
Это свойство может иметь четыре возможных значения: 

зіаіііс 

Это значение, применяемое по умолчанию. Оно указывает, что элемент пози¬ 
ционируется статически в соответствии с нормальным порядком вывода со¬ 
держимого документа (для большинства западных языков - слева направо 
и сверху вниз). Статически позиционированные элементы не могут позицио¬ 
нироваться с помощью свойств 1:ор, Іе^І и других. Для позиционирования эле¬ 
мента документа с применением приемов С88 сначала нужно установить его 
свойство розШоп равным одному из трех других значений. 

аЬзоІиІіе 

Это значение позволяет задать абсолютную позицию элемента относительно 
содержащего его элемента. Такие элементы позиционируются независимо от 
всех остальных элементов и не являются частью потока статически позицио¬ 
нированных элементов. Абсолютно позиционированный элемент позициони¬ 
руется либо относительно тела документа, либо, если он вложен в другой абсо¬ 
лютно позиционированный элемент, относительно этого элемента. 

^іхесі 

Это значение позволяет зафиксировать положение элемента относительно ок¬ 
на броузера. Элементы с фиксированным позиционированием не прокручива¬ 
ются с остальной частью документа. Как и абсолютно позиционированные, 
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фиксировано позиционированные элементы не зависят от всех остальных эле¬ 
ментов и не являются частью потока вывода документа. Фиксированное пози¬ 
ционирование поддерживается большинством современных броузеров, ис: 
ключая ІЕ6. 

геіаіііѵе 

Если свойство розШоп имеет значение геіаіііѵе, элемент располагается в соот¬ 
ветствии с нормальным потоком вывода, а затем его положение смещается от¬ 
носительно его обычного положения в потоке. Пространство, выделенное для 
элемента в нормальном потоке вывода документа, остается выделенным для 
него, и элементы, расположенные со всех сторон от него, не смыкаются для 
заполнения этого пространства и не «выталкиваются» с новой позиции эле¬ 
мента. 

Присвоив свойству ро$Шоп элемента значение, отличное от зііаіііс, можно задать 
положение элемента с помощью произвольной комбинации свойств ІеГі, ііор, гідГіІ: 
и Ьоііют. Чаще всего для позиционирования используются свойства ІеГі и Ііор, за¬ 
дающие расстояние от левого края элемента-контейнера (обычно самого докумен¬ 
та) до левого края позиционируемого элемента и расстояние от верхнего края кон¬ 
тейнера до верхнего края элемента. Так, чтобы поместить элемент на расстоянии 
100 пикселов от левого края и 100 пикселов от верхнего края документа, можно 
задать С88-стили в атрибуте зііуіе, как показано ниже: 

<с!іѵ 51:у1е="ро5Шоп: аЬзоШе; ІеГі:: ЮОрх; 1:ор : 100рх;"> 

Если для элемента задана абсолютная позиция, значения его свойств Ііор и ІеГі 
интерпретируются как расстояния до ближайшего родительского элемента, свой¬ 
ство розіііоп которого имеет любое значение, кроме зііаіііс. Если абсолютно пози¬ 
ционируемый элемент не имеет позиционируемого предка, его свойства Ііор и ІеТХ. 
будут определять координаты относительно начала документа - левого верхнего 
его угла. Если вам потребуется позиционировать элемент относительно контей¬ 
нера, который является частью обычного потока вывода документа, определите 
в контейнере свойство ро$Шоп: геіаіііѵе и укажите значение Орх в свойствах Ііор 
и ІеТХ контейнера. В этом случае контейнер будет позиционироваться динамиче¬ 
ски и останется при этом на обычном месте в потоке вывода документа. Любые 
абсолютно позиционируемые вложенные элементы будут позиционироваться от¬ 
носительно контейнера. 

При позиционировании элементов чаще всего задается положение верхнего лево¬ 
го угла элемента с помощью атрибутов ІеІЧ и Ііор, но точно так же можно задать 
положение нижнего и правого краев элемента относительно нижнего и правого 
краев элемента-контейнера с помощью атрибутов гідігіі и Ьоіііот. Например, при 
помощи следующих стилей можно указать, что правый нижний угол элемента 
должен находиться в правом нижнем углу документа (предполагается, что он не 
вложен в другой динамический элемент): 

розШоп: аЬзоІіііе; гідІИ:: Орх; Ьоііот: Орх; 

Чтобы верхний край элемента располагался в 10 пикселах от верхнего края окна, 
а правый - в 10 пикселах от правого края окна и при этом не прокручивался вме¬ 
сте с документом, можно использовать такие стили: 

розШоп: Нхесі; гідіті:: Юрх; Ііор: Юрх; 
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Помимо позиций элементов С88 позволяет указывать их размеры. Чаще всего это 
делается путем задания значений свойств стиля ѵ/ісГЫі и ІпеідІтІ:. Например, следу¬ 
ющая разметка НТМЬ создаст абсолютно позиционированный элемент без содер¬ 
жимого. Его свойствам місЛЮ, йеідіті: и ЬаскдгоигЮ-соІог присвоены такие значения, 
что он будет отображаться в виде маленького синего квадрата: 

<с!іѵ 8І:у1е="розі1:іоп : аЬзо1іі1:е; Іор: Юрх; ІеМ: Юрх; 

ѵѵісііііп : Юрх; ІіеідІгМ Юрх; Ьаскдгоипсі-соіог: Ыие"> 

</с!іѵ> 

Другой способ задать ширину элемента состоит в одновременном задании значе¬ 
ний обоих свойств, ІеІМ и гідІтЬ Аналогично можно задать высоту элемента, одно¬ 
временно указав оба свойства, Іюр и ЬоІМот. Однако если задать значения для 
свойств ІеІМ, гідМ: и місЛЮ, то свойство місйііі переопределит свойство гідІтЕ, а если 
ограничивается высота элемента, то более высоким приоритетом будет пользо¬ 
ваться свойство МеідІѵ*:. 

Имейте в виду, что задавать размер каждого динамического элемента не обяза¬ 
тельно. Некоторые элементы, такие как изображения, имеют собственный раз¬ 
мер. Кроме того, для динамических элементов, включающих текст или другое 
потоковое содержимое, часто бывает достаточно указать желаемую ширину эле¬ 
мента и разрешить автоматическое определение высоты в зависимости от разме¬ 
щения содержимого элемента. 

Стандарт С88 требует, чтобы в значениях свойств, определяющих позицию 
и размер, указывались единицы измерения. В предыдущих примерах значения 
свойств позиционирования и размера задавались с суффиксом «рх», означающим 
«ріхеів» (пикселы). Можно также использовать другие единицы измерения: дюй¬ 
мы («іп»), сантиметры («ст»), пункты («рі») и «ет» (размер высоты строки теку¬ 
щего шрифта). 

Помимо единиц измерения, представленных выше, С88 позволяет задавать поло¬ 
жение и размер элемента в процентах от размера элемента-контейнера. Напри¬ 
мер, следующая разметка НТМЬ создаст пустой элемент с черной рамкой, имею¬ 
щий ширину и высоту в половину элемента-контейнера (или окна броузера) и рас¬ 
положенный в этом элементе по центру: 

<с!іѵ з1:у1е=' , розі1:іоп : аЬзо1іі1:е; ІеМ:: 25%; 1:ор: 25%; ѵі/ісИ:М: 50%; Ілеідіпі:: 50%; 

ЬогРег: 2рх зоіісі Ыаск"> 

</с!іѵ> 

16.2.1.1. Третье измерение: 2 -іпсІех 

Мы видели, что свойства ІеІМ, 1 :ор, гідМ: и ЬоІМот позволяют указывать координа¬ 
ты X и У элемента в двухмерной плоскости элемента-контейнера. Свойство 2-ігЮех 
определяет что-то вроде третьего измерения: оно позволяет определить порядок 
наложения элементов и указать, какой из двух или более перекрывающихся эле¬ 
ментов должен располагаться поверх других. Атрибут 2-іпйех представляет собой 
целое число. По умолчанию его значение равно нулю, но можно задавать положи¬ 
тельные и отрицательные значения. Когда два или более элементов перекрыва¬ 
ются, они отображаются в порядке от меньших значений 2-іпс1ех к большим, т.е. 
элемент с большим значением 2-іпйех отображается поверх всех остальных. Если 
перекрывающиеся элементы имеют одинаковые значения 2-іпсіех, они отобража- 
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ются в порядке следования в документе, поэтому наверху оказывается последний 
из перекрывающихся элементов. 

Обратите внимание, что порядок наложения определяется свойством 2-іпРех толь¬ 
ко для смежных элементов (т. е. для дочерних элементов одного контейнера). Ес¬ 
ли перекрываются два несмежных элемента, то на основе индивидуальных зна¬ 
чений свойств 2-іпРех нельзя указать, какой из них должен находиться сверху. 
Вместо этого надо задать атрибут 2-іпРех для двух смежных контейнеров пере¬ 
крывающихся элементов. 

Способ размещения непозиционируемых элементов (элементов со значением по 
умолчанию режима позиционирования розШоп:з*а*іс) исключает возможность 
перекрытия, поэтому к ним свойство 2-іпРех не применяется. Тем не менее они 
получают значение 2-іпс1ех, по умолчанию равное нулю, т.е. позиционируемые 
элементы с положительным значением 2-іпсІех отображаются поверх обычного 
потока вывода документа, а позиционируемые элементы с отрицательным значе¬ 
нием 2-іпс1ех оказываются ниже обычного потока вывода документа. 

16.2.1.2. Пример позиционирования средствами С55: 
текст с тенью 

Спецификация С883 включает свойство 1 ;ех 1 :- 8 Ііас 1 о\л/, позволяющее добиться эф¬ 
фекта отбрасывания тени текстовыми элементами. Данное свойство поддержива¬ 
ется многими текущими броузерами, однако добиться эффекта тени можно 
и с помощью С88-свойств позиционирования, для чего достаточно продублиро¬ 
вать, сместив, выводимый текст: 

<!-- Свойство 1:ех1:-зІіасіоѵі/ производит тень автоматически --> 

<зрап 5І:у1е="1:ех1:-5Ііасіоѵі/: Зрх Зрх Ірх #888 ">С тенью</зрап> 

<! -- 

Ниже показано, как добиться похожего эффекта с помощью механизма позиционирования. 

--> 

<зрап 51:у1е="р05Шоп: геіаііѵе; "> 

С тенью <!-- Это основной текст, отбрасывающий тень. --> 

<зрап 5І:у1е="р05і1:іоп:аЬ50Ііі1:е; Юр:3рх; ІеГІ: :Зрх; 2-іпс1ех:-1; соіог: #888”> 

С тенью <!-- Это тень --> 

</зрап> 

</зрап> 

Текст, отбрасывающий тень, заключается в относительно позиционируемый эле¬ 
мент <зрап>. Для него не определяются свойства, задающие позицию, поэтому 
текст отображается в обычной позиции в потоке. Тень заключается в абсолютно 
позиционируемый элемент <зрап>, помещенный в относительно позиционируемый 
элемент <зрап> (и поэтому позиционируется относительно него). Свойство 2-іпсІех 
обеспечивает отображение тени под текстом. 

16.2.2. Рамки, поля и отступы 

Стандарт С88 позволяет задавать поля, рамки и отступы для любого элемента. 
Рамка элемента - это прямоугольник, обрисованный вокруг (полностью или час¬ 
тично) этого элемента. С88-свойства позволяют задать стиль, цвет и толщину 
рамки: 
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Ьогсіег: зоіісі Ыаск Ірх; /* рамка рисуется черной сплошной линей, 

/* толщиной 1 пиксел */ 

Ьогсіег: Зрх сіоііесі гесі; /* рамка рисуется красной пунктирной линией */ 

/* толщиной 3 пиксела */ 

Толщину, стиль и цвет рамки можно задать с помощью отдельных С88-свойств, 
а также отдельно для каждой из сторон элемента. Например, чтобы нарисовать 
линию под элементом, достаточно просто определить свойство Ьогсіег-Ьоіііот. Мож¬ 
но даже задать толщину, стиль и цвет рамки только для одной стороны элемента 
с помощью таких свойств, как Ьогс 1 ег- 1 :ор-ѵ\/іс 11 :Ь и ЬогсІег- 1 е 1 : 1 >со 1 ог. 

В С883 можно закруглить все углы рамки, определив свойство Ьогсіег-гасіі из, или 
отдельные углы, задействовав более конкретные свойства. Например: 

Ьо гсіе г-1;ор- гідМ;-гасііиз : 50рх; 

Свойства тагдіп и расісііпд задают ширину пустого пространства вокруг элемента. 
Отличие (очень важное) заключается в том, что свойство тагдіп задает ширину 
пустого пространства снаружи от рамки, между рамкой и окружающими элемен¬ 
тами, а свойство расШпд - внутри рамки, между рамкой и содержимым элемента. 
Поля (тагдіп) позволяют визуально отделить элемент (возможно, окруженный 
рамкой) от соседних элементов в нормальном потоке вывода документа. Отступы 
(расШпд) позволяют визуально отделить содержимое элемента от его рамки. Ес¬ 
ли элемент не имеет рамки, определять ширину отступов обычно не требуется. 
Если элемент позиционируется динамически, он выпадает из нормального пото¬ 
ка вывода документа, и для него не имеет смысла определять ширину полей. 

Поля и отступы элемента задаются с помощью свойств тагдіп и расШпд: 
тагдіп: 5рх; расШпд: 5рх; 

Можно также определить поля и отступы для каждой из сторон элемента в от¬ 
дельности: 

тагдіп-іеіі : 25рх; 
расШпд-Ьоііот: 5рх; 

Также можно задать величины полей и отступов для каждой из четырех сторон 
элемента с помощью свойств тагдіп и расШпд, указав первым значение для верх¬ 
ней стороны и далее по часовой стрелке: сверху, справа, снизу и слева. Например, 
в следующем фрагменте приводятся два эквивалентных способа задания различ¬ 
ных значений отступов для каждой из четырех сторон элемента: 

расісііпд: Ірх 2рх Зрх 4рх; 

/* Предыдущая строка эквивалентна четырем следующим. */ 

расШпд-1:ор: Ірх; 

расісііпд-гідЫ: : 2рх; 

расШпд-Ьоііот: Зрх; 

расШпд-ІеГЕ: 4рх; 

Порядок работы с атрибутом тагдіп ничем не отличается. 

16.2.3. Блочная модель и детали позиционирования в С55 

Свойства стиля тагдіп, Ьогсіег и расісііпд, описанные выше, не относятся к числу 
свойств, которыми приходится часто управлять в сценариях. Причина, по кото- 
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рой они были описаны здесь, состоит в том, что поля, рамки и отступы являются 
частью блочной модели С88, знать которую необходимо, чтобы до конца разо¬ 
браться, как действуют С88-свойства позиционирования. 

Рис. 16.2 иллюстрирует блочную модель С88 и наглядно показывает, какой смысл 
имеют свойства 1 :ор, 1еТ1 9 місЛііі и йеідіті: для элементов с рамками и отступами. 


Ьогйег-Юр-мШй 



ЬогРег-Ьоиот-мШИ 


Рис. 16.2. Блочная модель в С88: рамки, отступы и свойства позиционирования 


На рис. 16.2 показан абсолютно позиционируемый элемент, вложенный в пози¬ 
ционируемый элемент-контейнер. Оба элемента, контейнер и вложенный в него, 
имеют рамки и отступы, и на рисунке показаны С88-свойства, определяющие 
ширину отступов и толщину рамок для каждой стороны элемента-контейнера. 
Обратите внимание, что здесь не показаны свойства глагдіп: поля не используются 
при отображении абсолютно позиционируемых элементов. 

Рис. 16.2 содержит также другую важную информацию. Во-первых, свойства місЛііі 
и ІіеідМ: задают только размеры области содержимого элемента - они не включают 
дополнительное пространство, занимаемое отступами или рамками (и полями) 
элементов. Чтобы определить полный размер, занимаемый на экране элементом 
с рамкой, необходимо прибавить к ширине элемента ширину левого и правого от¬ 
ступов и толщину левой и правой рамок, а к высоте элемента необходимо приба¬ 
вить ширину верхнего и нижнего отступов и толщину верхней и нижней рамок. 

Во-вторых, свойства Іе'ГІ: и 1 :ор задают расстояние от внутреннего края рамки кон¬ 
тейнера до внешнего края рамки позиционируемого элемента. Эти свойства опре¬ 
деляют расстояние не от левого верхнего угла области содержимого контейнера, 
а от левого верхнего угла области, занимаемой отступами контейнера. Аналогич¬ 
но свойства гідііі; и ЬоИот определяют расстояние от правого нижнего угла облас¬ 
ти, занимаемой отступами. 

Для полной ясности рассмотрим несложный пример. Предположим, что у вас 
есть динамически позиционируемый элемент, вокруг содержимого которого име- 
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ются отступы размером 10 пикселов, а вокруг них - рамка толщиной 5 пикселов. 
Теперь предположим, что вы динамически позиционируете дочерний элемент 
внутри этого контейнера. Если установить свойство Іе^І дочернего элемента рав¬ 
ным «Орх», обнаружится, что левый край дочернего элемента будет находиться 
непосредственно у внутреннего края рамки контейнера. При этом значении свой¬ 
ства дочерний элемент перекроет отступы контейнера, хотя предполагается, что 
они остаются пустыми (т. к. для этого и предназначены отступы). Чтобы помес¬ 
тить дочерний элемент в левый верхний угол области содержимого контейнера, 
необходимо присвоить свойствам ІеТІ и 1:ор значение «ІОрх». 

16.2.3.1. Модель Ьогсіег-Ьох и свойство Ьох-$ігіпд 

Стандартная блочная модель С88 определяет, что свойства стиля місіііЬ и Іпеідіт*: 
задают размер области содержимого элемента и не учитывают ширину отступов 
и толщину рамки. Эту модель можно было бы назвать «сопіепі-Ъох». Эта модель 
имеет исключения, наблюдаемые в старых версиях ІЕ и в новых версиях С88. 
При отображении страниц в ІЕ версии ниже 6 или в ІЕ6, 7 или 8 в «режиме со¬ 
вместимости» (когда страница не имеет объявления <Ю0СТУРЕ> или это объявле¬ 
ние недостаточно строгое), свойства місЛіІі и ЬеідЫ: включают ширину отступов 
и толщину рамок. 

Поведение ІЕ ошибочно, но нестандартная блочная модель, реализованная в ІЕ, 
иногда бывает весьма удобна. Учитывая это, в стандарт С883 было добавлено 
свойство Ьох-зігіпд. По умолчанию оно имеет значение соп1:еп1:-Ьох, которое ука¬ 
зывает, что используется стандартная блочная модель, описанная выше. Если 
вместо него указать значение Ьох-зігіпд: Ьогсіег-Ьох, броузер будет использовать 
блочную модель ІЕ и свойства місіііЬ и ЬеідЫ: будут включать рамки и отступы. Мо¬ 
дель ЬогРег-Ьох особенно удобно использовать, когда желательно задать общий 
размер элемента в процентах, а ширину отступов и толщину рамки - в пикселах: 

<с!іѵ 5іу1е="Ьох-5І2іпд : Ьогсіег-Ьох; иісі1:Ь: 50%; 

расШпд: Юрх; ЬогРег: зоіісі Ыаск 2рх; "> 

Свойство Ьох-зі 2 іпд поддерживается всеми текущими броузерами, но пока не во 
всех оно реализовано без префикса. В СЬготе и 8аІагі свойство имеет имя -хѵеЬкіі:- 
Ьох-зігіпд. В Гігеіох - -тог-Ьох-зігіпд. В Орега и ІЕ8 (и выше) свойство имеет имя 
Ьох-зігіпд без префикса. 

Будущей альтернативой модели Ьогсіег-Ьох, предусматриваемой стандартом С883, 
являются вычисляемые значения свойств: 

<с!іѵ з1:у1е=Лл/іс11:Іп : са1с(50%-12рх); расШпд: Юрх; ЬогРег: зоіісі Ыаск 2рх;"> 

Возможность вычисления значений С88-свойств с применением са 1 с() поддержи¬ 
вается в ІЕ9 и в Гігеіох 4 (как -то2-са1с()). 

16.2.4. Отображение и видимость элементов 

Управлять видимостью элемента документа позволяют два С88-свойства: ѵізіЬі- 
Шу и Ьізріау. Пользоваться свойством ѵізіЬіШу очень просто: если оно имеет 
значение Ьісісіеп, то элемент не отображается, если ѵізіЬІе, - отображается. Свой¬ 
ство сіізріау является более универсальным и служит для задания варианта ото¬ 
бражения элемента, определяя, блочный это элемент, встраиваемый, списочный 
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или какой-нибудь другой. Если же свойство сіізріау имеет значение попе, то эле¬ 
мент вообще не отображается и для него даже не выделяется место на странице. 

Различие между свойствами стиля ѵізіЬіШу и Різріау имеет отношение к их воз : 
действию на статически или относительно позиционируемые элементы. Для эле¬ 
мента, расположенного в нормальном потоке вывода документа, установка свой¬ 
ства ѵізіЬіШу в значение ЬісІЬеп делает элемент невидимым, но резервирует для 
него место в документе. Такой элемент может повторно скрываться и отображать¬ 
ся без изменения компоновки документа. Однако если свойство сЛзрІау элемента 
установлено в значение попе, то место в документе для него не выделяется; эле¬ 
менты с обеих сторон от него смыкаются, как будто его вообще не существует. 
Свойство Ьізріау может пригодиться, например, при создании разворачиваю¬ 
щихся и сворачивающихся списков. 

Обратите внимание, что нет особого смысла использовать атрибуты ѵізіЬіШу 
и Ьізріау, чтобы сделать элемент невидимым, если вы не собираетесь динамиче¬ 
ски устанавливать их в сценарии на языке ЛаѵаЗсгірі, чтобы в какой-то момент 
сделать его снова видимым! Как это делается, будет показано далее в этой главе. 

16.2.5. Цвет, прозрачность и полупрозрачность 

Цвет текста, содержащегося в элементе документа, можно задать с помощью 
С88-свойства соіог. Цвет фона любого элемента - с помощью свойства ЬаскдгоипсІ- 
соіог. Выше мы видели, что цвет рамки элемента можно задать с помощью свой¬ 
ства ЬогРег-соІог или сокращенной формы его написания ЬогРег. 

При обсуждении рамок мы рассматривали пример, в котором цвет рамки задавал¬ 
ся указанием названий наиболее распространенных цветов, таких как «гесЬ 
(красный) и «Ыаск» (черный). Стандарт С88 поддерживает множество таких обо¬ 
значений цветов на английском языке, но имеется более универсальный способ 
определения цветов, который заключается в использовании шестнадцатеричных 
цифр, определяющих красную, зеленую и синюю составляющие цвета. Значения 
каждой из составляющих могут задаваться одной или двумя цифрами. Например: 

#000000 /* черный */ 

ЯШ /* белый */ 

#^00 /* ярко-красный */ 

#404080 /* ненасыщенный темно-синий */ 

#ссс /* светло-серый */ 

Стандарт С883 дополнительно определяет возможность определения цвета в фор¬ 
мате НОВА (значения красной, зеленой и синей составляющих плюс альфа-значе¬ 
ние, определяющее степень прозрачности). Формат НОВА поддерживается всеми 
современными броузерами, кроме ІЕ; ожидается, однако, что его поддержка бу¬ 
дет включена в ІЕ9. С883 также определяет поддержку форматов Н8Ь (Ьие-заіи- 
гаііоп-ѵаіие - тон-насыщенность-яркость) и Н8ЬА. И снова эти форматы поддер¬ 
живаются броузерами Еігеіох, 8аІагі и СЬготе, но не поддерживаются ІЕ. 

Таблицы С88 позволяют точно указать позицию, размеры, цвета фона и рамки 
элемента, что обеспечивает элементарные графические средства рисования пря¬ 
моугольников и (если до предела уменьшить высоту или ширину) горизонталь¬ 
ных или вертикальных линий. В предыдущее издание книги был включен при¬ 
мер рисования столбчатых диаграмм средствами С88, но в этом издании он был 
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заменен расширенным описанием элемента <сапѵа$>. (Подробнее о работе с графи¬ 
кой на стороне клиента рассказывается в главе 21.) 

В дополнение к атрибуту Ьаскдгоипр-соіог можно также указать изображение, ко¬ 
торое должно использоваться в качестве фоновой картинки элемента. Свойство 
Ьаскдгоипсі-ітаде определяет фоновое изображение, а свойства Ьаскдгоипр-аііііасі'і- 
тепі:, Ьаскдгоипр-розііііоп и ЬаскдгоііпР-гереаІ: уточняют некоторые параметры рисо¬ 
вания изображения. Сокращенная форма записи - свойство ЬаскдгоипР, позво¬ 
ляющее указывать все эти атрибуты вместе. Свойства, определяющие фоновый 
рисунок, могут применяться для создания довольно интересных визуальных эф¬ 
фектов, но это уже выходит за рамки темы данной книги. 

Очень важно понимать, что если цвет фона или фоновый рисунок элемента не за¬ 
дан, то фон элемента обычно прозрачный. Например, если поверх некоторого тек¬ 
ста в обычном потоке вывода документа расположить элемент «Лѵ> с абсолютным 
позиционированием, то по умолчанию текст будет виден через элемент «Лѵ>. Ес¬ 
ли же элемент <<Лѵ> содержит собственный текст, символы окажутся наложенны¬ 
ми друг на друга, образуя трудную для чтения мешанину. Однако не все элемен¬ 
ты по умолчанию прозрачны. Например, элементы форм выглядели бы нелепо 
с прозрачным фоном, и такие элементы, как <Ьи**оп>, имеют цвет фона по умолча¬ 
нию. Переопределить значение цвета по умолчанию можно с помощью свойства 
Ьаскдгоипсі-соіог; при необходимости можно явно установить цвет фона прозрач¬ 
ным («ігапзрагепі»). 

Прозрачность, о которой мы до сих пор говорили, может быть либо полной, либо 
нулевой: элемент имеет либо прозрачный, либо непрозрачный фон. Однако суще¬ 
ствует возможность получить полупрозрачный элемент (для содержимого как 
заднего, так и переднего плана). (Пример полупрозрачного элемента приведен на 
рис. 16.3.) Делается это с помощью свойства орасіііу, определяемого стандартом 
С883. Значением этого свойства является число в диапазоне от 0 до 1, где 1 озна¬ 
чает 100-процентную непрозрачность (значение по умолчанию), а 0 - 100-про- 
центную прозрачность. Свойство орасіііу поддерживается всеми текущими бро¬ 
узерами, кроме ІЕ. В ІЕ аналогичная функциональность реализуется с помощью 
специфичного свойства "ГіИіег. Чтобы сделать элемент непрозрачным на 75%, 
можно воспользоваться следующими С88-стилями: 

орасііу: .75; /* стандартный стиль прозрачности в СЗЗЗ */ 

Шіег: а1р!іа(орасі1:у=75) ; /* прозрачность в ІЕ; обратите внимание */ 

/* на отсутствие десятичной точки */ 

16.2.6. Частичная видимость: свойства оѵегПоѵѵ и сіір 

Свойство ѵізіЫІіІіу позволяет полностью скрыть элемент документа. С помощью 
свойств оѵегИои/ и сіір можно отобразить только часть элемента. Свойство оѵегИои/ 
определяет, что происходит, когда содержимое документа превышает размер, 
указанный для элемента (например, в свойствах стиля ѵѵісЛііі и ІіеідІтЬ). Далее пере¬ 
числены допустимые значения этого свойства и указано их назначение: 

ѵізіЬІе 

Содержимое может выходить за пределы и по необходимости прорисовывать¬ 
ся вне прямоугольника элемента. Это значение по умолчанию. 
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ОісМеп 

Содержимое, вышедшее за пределы элемента, обрезается и скрывается, так 
что никакая часть содержимого никогда не прорисовывается вне области, оп¬ 
ределяемой свойствами размера и позиционирования. 

5СГ0І1 

Область элемента имеет постоянные горизонтальную и вертикальную полосы 
прокрутки. Если содержимое превышает размеры области, полосы прокрутки 
позволяют увидеть остальное содержимое. Это значение учитывается, только 
когда документ отображается на экране компьютера; когда документ выво¬ 
дится, например, на бумагу, полосы прокрутки, очевидно, не имеют смысла. 

аиііо 

Полосы прокрутки отображаются не постоянно, а только когда содержимое 
превышает размер элемента. 

Если свойство оѵегИом определяет, что должно происходить, когда содержимое 
элемента превысит область элемента, то с помощью свойства сіір можно точно 
указать, какая часть элемента должна отображаться независимо от того, выхо¬ 
дит ли содержимое за пределы элемента. Это свойство особенно полезно для соз¬ 
дания эффектов, когда элемент открывается или проявляется постепенно. 

Значение свойства сіір задает область отсечения элемента. В С882 области отсе¬ 
чения прямоугольные, но синтаксис атрибута сіір обеспечивает возможность 
в следующих версиях стандарта задавать области отсечения, отличные от прямо¬ 
угольных. Синтаксис свойства сіір: 

гесі .{Хор гідііі ЬоТТот ІеТХ) 

Значения Гор, гідМі, РоГГо/и и ІеГГ задают границы прямоугольника отсечения от¬ 
носительно левого верхнего угла области элемента. Чтобы, например, вывести 
только часть элемента в области 100 х 100 пикселов, можно задать для этого эле¬ 
мента следующий атрибут зііуіе: 

Зіу1е="с1ір: гесі(0рх ЮОрх ЮОрх Орх); 

Обратите внимание, что четыре значения в скобках представляют собой значе¬ 
ния длины и должны включать спецификацию единиц измерения, например рх 
для пикселов. Проценты здесь не допускаются. Значения могут быть отрицатель¬ 
ными - это будет означать, что область отсечения выходит за переделы области, 
определенной для элемента. Для любого из четырех значений ключевое слово аиГо 
указывает, что этот край области отсечения совпадает с соответствующим краем 
самого элемента. Например, можно вывести только левые 100 пикселов элемента 
с помощью следующего атрибута зіуіе: 

зіу1е="с1ір: гесі:(аиііо ЮОрх аіііо аіііо);" 

Обратите внимание, что между значениями нет запятых, и края области отсече¬ 
ния задаются по часовой стрелке, начиная с верхнего края. 

16.2.7. Пример: перекрытие полупрозрачных окон 

Данный раздел завершается примером, который демонстрирует порядок работы 
с большинством обсуждавшихся С88-свойств. В примере 16.2 С88-стили исполь- 




16.2. Наиболее важные С55-свойства 


461 


зуются для создания визуального эффекта наложения полупрозрачного окна на 
другое окно, обладающее полосой прокрутки. Результат приводится на рис. 16.3. 



^Могійа РігеГок 


Оршкв ^урпаг Загадки ^тру'мекты ^правке 


А&щь -тис--щт 




Еще однс ѵжно 


Это «щ? одно скпо Значение атрибута 
г-іпйех чтото окна заставляет «го 
ржітлолаііъгя поверх другого , ‘іа слот 
тилон содер+ішое атого окна 
будет выглядеть по лулро**)радным в 
броузерах, поддердлшан.щпх такую 
В ГОМОЛЗИН' ть< 


Готово 


Рис. 16.3. Окна, созданные с помощью С88 


Пример не содержит ЛаѵаВсгірі-код и в нем нет никаких обработчиков событий, 
поэтому возможность взаимодействия с окнами отсутствует (иначе как через по¬ 
лосу прокрутки), но это очень интересная демонстрация эффектов, которые мож¬ 
но получить средствами С88. 

Пример 16.2. Отображение окон с использованием С88 стилей 

<! ООСТѴРЕ П1:т1"> 

<Иеасі> 

<зІу1е Іуре="1:ехі:/сзз"> 

/ ** 

* Эта таблица СЗЗ-стилей определяет три правила стилей, которые используются 

* в теле документа для создания визуального эффекта "окна". В правилах использованы 

* свойства позиционирования для установки общего размера окна и расположения 

* его компонентов. Изменение размеров окна требует аккуратного 

* изменения атрибутов позиционирования во всех трех правилах. 

* */ 

сііѵ.ѵѵіпсЗоѵ/ { /* Определяет размер и рамку окна */ 

розШоп: аЬзоІіііе; /* Положение задается в другом месте */ 

місІІГі: ЗООрх; Иеідігі: : 200рх; /* Размер окна без учета рамок */ 

Ьогсіег: Зрх оііізеі: дгау; /* Обратите внимание на Зй-эффект рамки */ 

} 

сііѵ.іШеЬаг { /* Задает положение, размер и стиль заголовка */ 

розіііоп: аЬзоІіііе; /* Это позиционируемый элемент */ 

іор: Орх; Иеідіті: : 18рх; /* Высота заголовка 18рх + отступ и рамка */ 

290рх; /* 290 + 5рх отступы слева и справа = 300 */ 

Ьаскдгоііпсі-соіог: #ааа; /* Цвет заголовка */ 
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ЬогсІег-ЬоНош: дгооѵе дгау 2рх; /* Заголовок имеет рамку только снизу */ 
расісііпд: Зрх 5рх 2рх 5рх; /* Значения по часовой стрелке: 

/* сверху, справа, снизу, слева */ 

Гоп*: Ьоісі 11рі запз-зегіГ; /* Шрифт заголовка */ 

) 


с!іѵ.сопіепі: { /* Задает размер, 

розШоп: аЬзоШе; 

Іор: 25рх; 

ЬеідЫ: 165рх; 
місІІЬ: 290рх; 
расісііпд: 5рх; 
оѵегИом: аі^о; 

Ьаскдгоцпсі-соіог: Я^ГГГГГ; 


положение и прокрутку содержимого окна */ 

/* Это позиционируемый элемент */ 

/* 18рх заголовок+2рх рамка+3рх+2рх отступ */ 

/* 200рх всего - 25рх заголовок - Юрх отступ */ 
/* ЗООрх ширина - Юрх отступ */ 

/* Отступы со всех четырех сторон */ 

/* Разрешить появление полос прокрутки */ 

/* По умолчанию белый фон */ 


) 


сііѵ.іігапзіисепі: { 
орасііу: .75; 

ШТег: а1рЬа(орасі1:у=75); 

} 

</з1:у1е> 

</ЬеасІ> 


/* Этот класс делает окно частично прозрачным */ 
/* Стандартный стиль прозрачности */ 

/* Прозрачность для ІЕ */ 


<ЬосІу> 

<!-- Порядок определения окна: элемент сііѵ "окна" с заголовком и элемент сііѵ --> 
<!-- с содержимым, вложенный между ними. Обратите внимание, как задается --> 

<!-- позиционирование с помощью атрибута зіуіе, дополняющего --> 

<!-- стили из таблицы стилей --> 

<с!іѵ с1а55="ѵ\/іпсІоѵГ з1:у1е="1еГ1:: Юрх; іор: Юрх; 2 -іпсІех: 10; "> 

<с!іѵ с1азз="1:і1:1еЬаг">Тестовое окно</с!іѵ> 

<с!іѵ с1азз="соп1:епі;"> 

1<Ьг>2<Ьг>3<Ьг>4<Ьг>5<Ьг>6<Ьг>7<Ьг>8<Ьг>9<Ьг>0<Ьг><!-- Множество строк для --> 
1<Ьг>2<Ьг>3<Ьг>4<Ьг>5<Ьг>6<Ьг>7<Ьг>8<Ьг>9<Ьг>0<Ьг><!-- демонстр, прокрутки --> 
</с!іѵ> 

</с!іѵ> 


<!-- Это еще одно окно с другими позицией, цветом и шрифтом --> 

<с!іѵ с1азз=”ѵу/іпсІо\ѵ" 5*у1е="1еГІ: 75рх; іор: ІЮрх; 2 -іпсІех: 20; ”> 

<с!іѵ с1азз="1:і1:1еЬаг">Еще одно окно</с!іѵ> 

<с!іѵ с1азз="соп1:епі: ігапзіисепі;" 

5іу1е="ЬаскдгоцпсІ-со1ог :#ссс; Гоп1:-\ѵеідЫ;:Ьоісі; "> 

Это еще одно окно. Значение атрибута <іі> 2 -іпсІех</ 1 : 1 :> этого окна заставляет 
его расположиться поверх другого. За счет 088-стилей содержимое этого окна 
будет выглядеть полупрозрачным в броузерах, поддерживающих такую возможность. 

</с!іѵ> 

</(Иѵ> 

</ЬосІу> 

Основной недостаток этого примера в том, что таблица стилей задает фиксиро¬ 
ванный размер всех окон. Так как заголовок и содержимое окна должны точно 
позиционироваться внутри окна, изменение размера окна требует изменения зна¬ 
чений различных свойств позиционирования во всех трех правилах, определен¬ 
ных в таблице стилей. Это трудно сделать в статическом НТМЬ-документе, но все 
становится проще, если использовать сценарий, устанавливающий все необходи¬ 
мые свойства. Эта возможность рассматривается в следующем разделе. 
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16.3. Управление встроенными стилями 

Самый простой способ управления стилями С88 - это манипулирование атрибу¬ 
том зііуіе отдельных элементов документа. Как и для большинства НТМЬ-атри- 
бутов, атрибуту зііуіе соответствует одноименное свойство объекта Еіетепіі, и им 
можно манипулировать в сценариях на языке Лѵабсгірі. Однако свойство зііуіе 
имеет одну отличительную особенность: его значением является не строка, а объ¬ 
ект СЗЗЗІіуІеОесІагаІііоп. Свойства этого объекта представляют С88-свойства, опре¬ 
деленные в НТМЬ-атрибуте зііуіе. Например, чтобы вывести содержимое тексто¬ 
вого элемента е крупным, полужирным шрифтом синего цвета, можно выпол¬ 
нить следующие операции для записи желаемых значений в свойства, которые 
соответствуют свойствам стиля ^опі-зіге, ^опі-ѵу/еідігі: и соіог: 

е. зіуіе. І'опІЗіге = "24р1і"; 
е. зіуіе. ^опІМеідШ = "Ьоісі "; 
е. зіуіе. соіог = "Ыце"; 

При работе со свойствами стиля объекта СЗЗЗІіуІеОесІагаІііоп не забывайте, что все 
значения должны задаваться в виде строк. В таблице стилей или атрибуте зііуіе 
можно написать: 

розШоп: аЬзоІцІіе; ^опі-^ашііу: запз-зегі^; Ьаскдгоцпсі-соіог : # 

Чтобы сделать то же самое для элемента е в Лѵабсгірі, необходимо заключить 
все значения в кавычки: 

е. зіуіе. розШоп = "аЬзоІцІіе"; 
е.зіуіе.'ГопІРатіІу = "запз-зегіГ'; 
е. зііуіе. ЬаскдгоцпсіСоІо г = 

Обратите внимание, что точки с запятыми не входят в строковые значения. Это 
точки с запятой, употребляемые в синтаксисе языка ^ѵаЗсгірІ. Точки с запятой, 
используемые в таблицах стилей С88, не нужны в строковых значениях, уста¬ 
навливаемых с помощью Лѵабсгірі. 

Кроме того, помните, что во всех свойствах позиционирования должны быть ука¬ 
заны единицы измерения. То есть нельзя устанавливать свойство Іе^І подобным 
образом: 

е. зііуіе. ІеІЧ = 300; // Неправильно: это число, а не строка 

е.зіуіе.іе^і = "300"; // Неправильно: отсутствуют единицы измерения 

Единицы измерения обязательны при установке свойств стиля в Лѵабсгірі - так 
же, как при установке свойств стиля в таблицах стилей. Ниже приводится пра¬ 
вильный способ установки значения свойства Іе'М: элемента е, равным 300 пиксе¬ 
лам: 

е. зііуіе. ІеІЧ = "ЗООрх"; 

Чтобы установить свойство ІеІЧ равным вычисляемому значению, обязательно 
добавьте единицы измерения в конце вычислений: 

е. зііуіе. Іе^І = (х0 + ІеГМпагдіп + 1е1 = 1:_Ьо гсіе г + ІеІЧ.расШпд) + "рх"; 

Как побочный эффект, добавление строки с единицами измерения преобразует 
вычисленное значение из числа в строку. 
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Соглашения об именах: С5$-свойства в іаѵаБсгірі 

Многие С88-свойства стиля, такие как ^опі-зіге, содержат в своих именах 
дефис. В языке Лѵабсгірі дефис интерпретируется как знак минус, поэто¬ 
му нельзя записать выражение, приведенное ниже: 

е. зіуіе. І'опі-зіге = "24рѴ\ // Синтаксическая ошибка! 

Таким образом, имена свойств объекта С888і:у1е0ес1ага1:іоп слегка отлича¬ 
ются от имен реальных С88-свойств. Если имя С88-свойства содержит де¬ 
фисы, имя свойства объекта С888і:у1е0ес1ага1:іоп образуется путем удаления 
дефисов и перевода в верхний регистр буквы, непосредственно следующей 
за каждым из них. Другими словами, С88-свойство ЬогсІег-Іе^Іі-ѵѵ/ісІІіІі дос¬ 
тупно через свойство Ьогс1ег1_е^Ш.с11М, а к С88-свойству ^опМатіІу можно об¬ 
ратиться следующим образом: 

е. зіуіе.^опіРашіІу = "запз-зегіГ'; 

Кроме того, когда С88-свойство, такое как Иоа*, имеет имя, совпадающее 
с зарезервированным словом языка Лѵабсгірі, к этому имени добавляется 
префикс «С88», чтобы создать допустимое имя свойства объекта С8881:у1е- 
Оесіагаіііоп. То есть, чтобы прочитать или изменить значение С88-свойства 
Иоа* элемента, следует использовать свойство сззРІоаІ: объекта С8881:у1е0ес- 
Іагаііоп. 


Напомню, что некоторые С88-свойства, такие как тагдіп, представляют собой со¬ 
кращенную форму записи других свойств, таких как тагдіп-іор, тагдіп-гідМ:, 
тагдіп-ЬоіІіот и тагдіп-іе^*. Объект С888*у1е0ес1ага*іоп имеет свойства, соответст¬ 
вующие этим сокращенным формам записи свойств. Например, свойство тагдіп 
можно установить следующим образом: 

е. зіуіе.тагдіп = іорМагдіп + "рх " + гідЫМагдіп + "рх " + 

ЬоПотМагдіп + "рх ” + Іе^іМагдіп + "рх"; 

Хотя, возможно, кому-то будет проще установить четыре свойства полей по от¬ 
дельности: 

е. зіуіе.тагдіпТор = іорМагдіп + "рх"; 
е. зіуІе.тагдіпВідЫ: = гідЫМагдіп + "рх"; 
е. зіуіе. тагдіпВоПот = ЬоііотМагдіп + "рх"; 
е. зіуіе. тагдіпіеі 1 * = ІеІЧМагдіп + "рх"; 

Атрибут зіуіе НТМЬ-элемента - это его встроенный стиль , и он переопределяет 
любые правила стилей в таблице С88. Встроенные стили в целом удобно исполь¬ 
зовать для установки значений стиля, и именно такой подход использовался во 
всех примерах выше. Сценарии могут читать свойства объекта С888іу1е0ес1агаі:іоп, 
представляющего встроенные стили, но они возвращают осмысленные значения, 
только если были ранее установлены сценарием на языке ЛѵаЗсгірі или если 
НТМЬ-элемент имеет встроенный атрибут зіуіе, установивший нужные свойства. 
Например, документ может включать таблицу стилей, устанавливающую левое 
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поле для всех абзацев равным 30 пикселам, но если прочитать свойство ІеТІіМагдіп 
одного из этих элементов, будет получена пустая строка, если только этот абзац 
не имеет атрибут зііуіе, переопределяющий значение, установленное таблицей 
стилей. 

Чтение встроенного стиля элемента представляет особую сложность, когда вы¬ 
полняется чтение свойств стиля, имеющих единицы измерения, а также свойств 
сокращенной формы записи: сценарий должен включать далеко не простую реа¬ 
лизацию синтаксического анализа строк с С88-стилями, чтобы обеспечить воз¬ 
можность извлечения и дальнейшего использования значений. В целом, встроен¬ 
ный стиль элемента удобно использовать только для установки стилей. Если сце¬ 
нарию потребуется получить стиль элемента, лучше использовать вычисленные 
стили, которые обсуждаются в разделе 16.4. 

Иногда бывает проще прочитать или записать единственную строку во встроен¬ 
ный стиль элемента, чем обращаться к объекту СЗЗЗІіуІеОесІагаІііоп. Для этого 
можно использовать методы деіАИгіЬиіеО и эеіАИгіЬиІеО объекта Еіетепі: или 
свойство сззТехІ: объекта СЗЗЗІіуІеОесІагаІііоп: 

// Обе инструкции, следующие ниже, записывают в атрибут зіуіе 
// элемента е строку з: 
е.5еІА«гіЬиІе("5Іу1е’\ з); 
е. зііуіе.сззТехІ = з; 

// Обе инструкции, следующие ниже, получают значение атрибута зііуіе 
// элемента е в виде строки: 
з = е.деІАІІгіЬцІе(”зІу1е"); 
з = е.зіуіе.сззТехі; 

16.3.1. Создание анимационных эффектов 
средствами СЗЗ 

Одной из наиболее типичных областей применения С88 является воспроизведе¬ 
ние визуальных анимационных эффектов. Реализовать их можно с помощью ме¬ 
тода зеШтеоиТО или зеТІпііегѵаІО (раздел 14.1), используя их для организации 
многократных вызовов функции, изменяющей встроенный стиль элемента. При¬ 
мер 16.3 демонстрирует две такие функции, зМаке() и "ГасІе0и1:( ). Функция зІіакеО 
перемещает, или «встряхивает» (зЬакез), элемент из стороны в сторону. Ее можно 
использовать, например, для привлечения внимания пользователя в случае вво¬ 
да некорректных данных. Функция І'асІеОиІіС ) уменьшает непрозрачность элемен¬ 
та в течение указанного периода времени (по умолчанию 500 миллисекунд), вы¬ 
зывая эффект его растворения до полного исчезновения. 

Пример 16.3. Воспроизведение анимационных эффектов средствами С88 

// Делает элемент е относительно позиционируемым и перемещает его влево и вправо. 

// Первым аргументом может быть объект элемента или значение атрибута іб требуемого 
// элемента. Если во втором аргументе передать функцию, она будет вызвана с элементом е 
// в виде аргумента по завершении воспроизведения анимации. Третий аргумент определяет 
// величину смещения элемента е. По умолчанию принимает значение 5 пикселов. 

// Четвертый аргумент определяет, как долго должен воспроизводиться эффект. 

// По умолчанию эффект длится 500 мсек. 

Тцпсііоп зПаке(е, опсотріеіе, (ИзТапсе, ііте) { 
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// Обработка аргументов 

іГ (ГуреоГ е === "зігіпд") е = Росцтеп1:.деГЕ1етеп1:ВуІсі(е); 
іГ (!Гіте) Гіте = 500; 
іГ (Ісіізііапсе) сІізГапсе = 5; 


ѵаг огідіпаІЗГуІе = е.зіуІе.сззТехГ; 
е. зГуІе. розШоп = "геІаГіѵе"; 
ѵаг зГагі = (пем ОаГе()).дёШте(); 
апітаТеО; 


// Сохранить оригинальный стиль е 
// Сделать относит, позиционируемым 
// Запомнить момент начала анимации 
// Запустить анимацию 


// Эта функция проверяет прошедшее время и изменяет координаты е. 

// Если анимацию пора завершать, восстанавливает первоначальное состояние 
// элемента е. Иначе изменяет координаты е и планирует следующий свой вызов. 
ГцпсГіоп апітаіе() { 

ѵаг пом = (пем ОаГе()).деГТіте(); // Получить текущее время 

ѵаг еіарзей = пом-зТагТ; // Сколько прошло времени с начала? 

ѵаг ГгасГіоп = еІарзей/Тіте; // Доля от требуемого времени? 


ІГ (ГгасГіоп < 1) { // Если рано завершать анимацию 

// Вычислить координату х элемента е как функцию от доли общего 
// времени анимации. Здесь используется синусоидальная функция, 

// а доля общего времени воспроизведения умножается на 4рі, 

// поэтому перемещение взад и вперед выполняется дважды, 
ѵаг х = сіізГапсе * МаІЬ. зіп(^гас1:іоп*4*Ма1:Гі. РІ); 
е.зіуіе.ІеГІ = х + "рх"; 

// Попробовать вызвать себя через 25 мсек или в конце запланированного 
// отрезка общего времени воспроизведения. Мы стремимся сделать 
// анимацию гладкой, воспроизводя ее со скоростью 40 кадров/сек. 
зеттеоцКапітаІе, МаІЬ . тіп( 25, Ііте-еіарзесі)); 

} 

еізе { // Иначе анимацию пора завершать 

е.зІуІе.сззТехІ: = огідіпаІЗІуІе // Восстановить первонач. стиль 
іГ (опсотріеіе) опсотр1е1:е(е); // Вызвать ф-цию обратного вызова 

} 

} 

} 

// Растворяет е от состояния полной непрозрачности до состояния полной прозрачности 
// за указанное количество миллисекунд. Предполагается, что, когда вызывается 
// эта функция, е полностью непрозрачен, опсотріеіе - необязательная функция, 

// которая будет вызвана с элементом е в виде аргумента по завершении анимации. 

// Если аргумент Гіте не задан, устанавливается интервал 500 мсек. 

// Эта функция не работает в ІЕ, но ее можно модифицировать так, чтобы 
// в дополнение к свойству орасііу она использовала нестандартное 
// свойство ГіІГег, реализованное в ІЕ. 

ГипсГіоп ГасІеОцГСе, опсотріеіе, Гіте) { 

іГ (ГуреоГ е === "зГгіпд") е = РосцтепГ.деГЕІетепГВуІсКе); 
іГ (ІГіте) Гіте = 500; 


// В качестве простой "функции перехода", чтобы сделать анимацию немного 
// нелинейной, используется МаГЬ. зцгГ : сначала растворение идет быстро, 
// а затем несколько замедляется, 
ѵаг еазе = МаГИ.зцгі:; 

ѵаг зГагі = (пем йаГе( )).деГТіше(); // Запомнить момент начала анимации 
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апітаІеО; // И запустить анимацию 

^цпсііоп апітаіеО { 

ѵаг еіарзегі = (пем ОаТе()).деТТіте()-зТагТ; // Прошедшее время 
ѵаг Ігасііоп = еіарзесі/іііте; // Доля от общего времени 

іТ (^гасііоп < 1) { // Если не пора завершать 

ѵаг орасііу = 1 - еа5е(1тас1:іоп); // Вычислить непрозрачн. 

е.зіуіе.орасііу = 51:гіпд(орасііу); // Установить ее в е 

зеШтеоц1:(ап1та1:е, // Запланировать очередной 

Ма1Ь.тіп(25, Ііте-еіарзесі)); // кадр 

} 

еізе { // Иначе завершить 

е.зіуіе.орасііу = ”0"; // Сделать е полностью прозрачным 

ІТ (опсотріеіе) опсотріеііе(е); // Вызвать ф-цию обратного вызова 

} 

} 

} 

Обе функции, зМаке() и ^асІеОиШ, принимают необязательную функцию обратно¬ 
го вызова во втором аргументе. Если эта функция указана, она будет вызвана по 
завершении воспроизведения анимационного эффекта. Элемент, к которому при¬ 
менялся анимационный эффект, будет передан функции обратного вызова в виде 
аргумента. Следующая разметка НТМЬ создает кнопку, для которой после щелч¬ 
ка на ней воспроизводится эффект встряхивания, а затем эффект растворения: 

<ЬцІІоп опс1іск= "зИаке( іііпіз , ^асІеОці); ">Встряхнуть и растворить</Ьи1:1:оп> 

Обратите внимание, насколько функции зМаке() и ^асІеОшіС ) похожи друг на друга. 
Они обе могут служить шаблонами для реализации похожих анимационных эф¬ 
фектов с использованием С88-свойств. Однако клиентские библиотеки, такие как 
ІС^иегу, обычно поддерживают набор предопределенных визуальных эффектов, 
поэтому вам вообще может никогда не потребоваться писать собственные функ¬ 
ции воспроизведения анимационных эффектов, такие как зйакеО, если только 
вам не понадобится создать какой-нибудь сложный визуальный эффект. Одной 
из первых и наиболее примечательных библиотек визуальных эффектов являет¬ 
ся библиотека Зсгіріасиіоиз, которая предназначалась для работы в составе 
фреймворка Ргоіоіуре. За дополнительной информацией обращайтесь по адресу 
Ыір://зсгірі.асиІо.и8/ и Ніір://8Сгіріу2.сот/. 

Модуль «С883 ТгапзШопз» определяет еще один способ реализации анимацион¬ 
ных эффектов с помощью таблиц стилей, полностью устраняющий необходи¬ 
мость писать программный код. Например, вместо функции ^айеОиШ можно бы¬ 
ло бы определить правило С88, как показано ниже: 

. ^айеаЫе { ІгапзШоп: орасііу . 5з еазе-іп } 

Это правило говорит, что всякий раз, когда изменяется непрозрачность элемента 
с классом «?а(іеаЫе», это изменение должно протекать плавно (от текущего до но¬ 
вого значения) в течение половины секунды с использованием нелинейной функ¬ 
ции перехода. Модуль «С88 ТгапзШопз» еще не был стандартизован, но его поло¬ 
жения уже реализованы в броузерах 8а^агі и СЬготе в виде свойства -ѵѵеЬкі*- 
Ігапзіііоп. На момент написания этих строк в Гіге^ох 4 также была добавлена 
поддержка свойства -тоі-ігапзіііоп. 
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16.4. Вычисленные стили 

Свойство зііуіе элемента опредёляет встроенный стиль элемента. Оно имеет пре¬ 
имущество перед всеми таблицами стилей и с успехом может применяться для 
установки С88-свойств для изменения визуального представления элемента. Од¬ 
нако в общем случае к нему нет смысла обращаться, когда требуется узнать фак¬ 
тически примененные к элементу стили. То, что требуется в этом случае, называ¬ 
ется вычисленным стилем. Вычисленный стиль элемента - это набор значений 
свойств, которые броузер получил (или вычислил) из встроенного стиля и всех 
правил из всех таблиц стилей, которые применяются к элементу: это набор 
свойств, фактически используемый при отображении элемента. Подобно встроен¬ 
ным стилям, вычисленные стили представлены объектом С333і:у1е0ес1ага1:іоп. Од¬ 
нако в отличие от встроенных стилей, вычисленные стили доступны только для 
чтения. Эти стили нельзя изменить, но вычисленный объект С3331:у1е0ес1агаі:іоп 
позволяет точно узнать значения свойств стилей, которые броузер использовал 
при отображении соответствующего элемента. 

Получить вычисленный стиль элемента можно с помощью метода де1:Сотри1:есІ- 
31:у1е() объекта іаііпсіоѵу/. Первым аргументом этому методу передается элемент, вы¬ 
численный стиль которого требуется вернуть. Второй аргумент является обяза¬ 
тельным, и в нем обычно передается значение піЛІ или пустая строка, но в нем 
также может передаваться строка с именем псевдоэлемента С88, таким как 
«:Ъе&)ге», «:аНег», «:Нг8І-1іпе» или «:Яг8І-1е11ег»: 

ѵаг Шіе = сіоситепі:. де1:Е1етеп1:ВуІсІ("зесіііопіііііііе"); 
ѵаг Шіезіуіез = міпсіом. деі;Сотри1;есІ8і:у1е(еіетепі;. пиіі); 

Возвращаемым значением метода де1:Сотри1:есіЗі:у1е() является объект СЗЗЗііуІеОес- 
Іагаіііоп, представляющий все стили, применяемые к указанному элементу (или 
псевдоэлементу). Между объектами СЗЗЗііуІеОесІагаНіоп, представляющими встро¬ 
енные стили и вычисленные стили, существует множество существенных отли¬ 
чий: 

• Свойства вычисленного стиля доступны только для чтения. 

• Свойства вычисленных стилей имеют абсолютные значения: относительные 
единицы измерения, такие как проценты и пункты, преобразуются в абсолют¬ 
ные значения. Любое свойство, которое определяет размер (например, ширина 
поля или размер шрифта) будет иметь значение, выраженное в пикселах. То 
есть его значением будет строка с суффиксом «рх», поэтому вам необходимо бу¬ 
дет реализовать ее синтаксический анализ, зато не придется беспокоиться об 
определении и преобразовании единиц измерений. Значения свойств, опреде¬ 
ляющих цвет, будут возвращаться в формате «п»Ъ(#,#,#)» или «г&Ъа(#,#,#,#)». 

• Свойства, являющиеся краткой формой записи, не вычисляются - только 
фундаментальные свойства, на которых они основаны. Например, не следует 
пытаться получить значение свойства тагдіп, вместо этого нужно обращаться 
к свойствам тагдіпІ_е^1, тагдіпТор и т. д. 

• Свойство сззТехі: вычисленного стиля не определено. 

Вычисленные и встроенные стили можно использовать совместно. В примере 16.4 
определяются функции зса1е() и зса1еСо1ог(). Первая читает и анализирует вы¬ 
численный размер текста указанного элемента; вторая читает и анализирует вы- 
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численный цвет фона элемента. Затем обе функции умножают полученное значе¬ 
ние на заданное число и устанавливают результат, как встроенный стиль элемен¬ 
та. (Эти функции не работают в ІБ8 и в более ранних версиях: как вы узнаете да¬ 
лее, эти версии ІЕ не поддерживают метод де1:Сотриі:есІ5і:у1е( ).) 

Пример 16.4. Определение вычисленных стилей и установка встроенных стилей 

// Умножает размер текста элемента е на указанное число І'асТог 

^цпсііоп зса1е(е, ТасТог) { 

// Определить текущий размер текста, получив вычисленный стиль 
ѵаг зі 2 е = раг5еІп{(міпРоѵ^деІСотрц1:есі31:у1е(е, ^опІЗіге); 

// И использовать встроенный стиль, чтобы увеличить этот размер 
е. зТуІе. ^опТЗіге = І'асТог^зіге + "рх"; 

} 

// Изменяет цвет фона элемента е, умножая компоненты цвета на указанное число. 

// Значение І'асТог > 1 осветляет цвет элемента, а Тасіог < 1 затемняет его. 

І'цпсііоп зса1еСо1ог(е, ^асіог) { 

ѵаг соіог = иіпгіои.деЮотрцІе(18іу1е(е, ""). ЬаскдгоцпсІСоІог; // Получить 
ѵаг сошропепіз = соіог.та1:сЬ(/[\сі\. ]+/9); // Выбрать компоненты г.д.Ь и а 

^ог(ѵаг і = 0; і < 3; і++) { // Цикл по г, д и Ь 

ѵаг х = МцтЬег(сотропеп1:з[і]) * ^ас*ог;// Умножить каждый из них 
х = МаІЬ. гоцпР(МаІЬ.тіп(Ма1:Ь.тах(х, 0). 255)); // Округлить и установить границы 
сотропепІз[і] = 8*гіпд(х); 

} 

Н (сотропепіз.ІепдІЬ == 3) // Цвет гдЬ() 

е. зіуіе. ЬаскдгоцпсІСоІог = "гдЬ(" + сотропепіз. ]оіп() + ")"; 
еізе // Цвет гдЬа() 

е. зіуіе. ЬаскдгоцпсІСоІог = ''гдЬа(" + сотропепіз. ]оіп() + ')": 

} 

Работа с вычисленными стилями может оказаться весьма непростым делом, и об¬ 
ращение к ним не всегда возвращает ожидаемую информацию. Рассмотрим в ка¬ 
честве примера свойство ^опМатіІу: оно принимает список разделенных запяты¬ 
ми имен семейств шрифтов для совместимости. При чтении свойства "ГопііРатіІу 
вычисленного стиля вы ждете значение наиболее конкретного стиля ^опМатіІу, 
применяемого к элементу. А в этом случае может вернуться такое значение, как 
«агіа1,Ье1ѵеііса,8ап8-8егіі>, которое ничего не говорит о гарнитуре фактически ис¬ 
пользуемого шрифта. Аналогично, если элемент не является абсолютно позицио¬ 
нируемым, при попытке определить его размеры или положение через свойства 
Іор и ІеІЧ вычисленного стиля часто возвращается значение «аиіо». Это вполне до¬ 
пустимое в С88 значение, но наверняка совсем не то, что вы ожидали бы получить. 

Метод де'ЬСотри'ЬесІЗ'ЬуІеО не поддерживается в ІЕ8 и в более ранних версиях, но, 
как ожидается, он будет реализован в ІЕ9. В ІЕ все НТМЬ-элементы имеют свой¬ 
ство сілтегѵЬЗ'ЬуІе, значением которого является объект СЗЗЗііуІеОесІагаіііоп. Свой¬ 
ство сиггепі:3і:у1е в ІЕ объединяет встроенные стили с таблицами стилей, но оно не 
является по-настоящему вычисленным стилем, потому что не преобразует отно¬ 
сительные значения в абсолютные. При чтении свойств текущего стиля в ІЕ мо¬ 
гут возвращаться размеры в относительных единицах измерения, таких как «%» 
или «ет», а цвета в виде неточных названий, таких как «гей». 

Стили С88 можно использовать, чтобы точно задать позицию и размер элемента 
документа, но чтение вычисленного стиля элемента является не самым лучшим 
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способом узнать его размер и положение в документе. Более простые, переноси¬ 
мые решения приводятся в разделе 15.8.2. 

♦ 

16.5. С55-классы 

Альтернативой использованию отдельных С88-стилей через свойство зііуіе явля¬ 
ется управление значением НТМЬ-атрибута сіазз. Изменение класса элемента из¬ 
меняет набор селекторов стилей, применяемых к элементу, что может приводить 
к изменениям значений сразу нескольких С88-свойств. Предположим, напри¬ 
мер, что вам требуется привлечь внимание пользователя к отдельным абзацам 
(или другим элементам) в документе. В этом случае можно было бы сначала опре¬ 
делить особый стиль оформления для любых элементов с классом «аМепііоп»: 

. аііепііоп { /* Стили для элементов, требующих внимания пользователя */ 

Ьаскдгоипсі-соіог : уеііом; /* Желтый фон */ 

І'опіі-ѵу/еідіті: : Ьоісі; /* Полужирный шрифт */ 

ЬогРег: зоіісі Ыаск 2рх; /* Черная рамка */ 

) 

Идентификатор сіазз в языке ^ѵабсгірі является зарезервированным словом, 
поэтому НТМЬ-атрибут сіазз в Лѵабсгірі-сценариях доступен в виде свойства 
с именем сІаззМате. Ниже приводится пример, который устанавливает и очищает 
свойство сІаззМате элемента, добавляя и убирая класс «аМепііоп»: 

І^псііоп дгаЬАПепі:іоп(е) { е. сІаззМате = "аПепІіоп"; } 

І^псііоп ге1еазеАПеп1:іоп(е) { е.СІаззМате = } 

НТМЬ-элементы могут быть членами более чем одного С88-класса - атрибут сіазз 
может содержать целый список имен классов, разделенных пробелами. Имя 
сІаззМате не совсем точно отражает смысл свойства: правильнее было бы дать ему 
имя сІаззМатез. Функции выше предполагают, что свойство сІаззМате будет опре¬ 
делять ноль или одно имя класса, и они непригодны в случаях, когда может ис¬ 
пользоваться более одного имени класса. Если элемент уже принадлежит некото¬ 
рому классу, вызов функции дгаЬАі:1:еп1:іоп( ) для этого элемента затрет имя клас¬ 
са, присутствующее в свойстве сІаззМате. 

Стандарт НТМЬб решает эту проблему, определяя свойство СІаззИзІ: во всех эле¬ 
ментах. Значением этого свойства является объект ООМТокепИзІ:: подобный массиву 
объект (раздел 7.11), доступный только для чтения, элементы которого содержат 
отдельные имена классов, присвоенных элементу. Однако самыми важными в нем 
являются не элементы массива, а методы ас!сІ( ) и гетоѵе( ), добавляющие и удаляю¬ 
щие отдельные имена классов из атрибута сіазз элемента. Метод 1:одд1е() добавля¬ 
ет имя класса, если оно отсутствует, и удаляет в противном случае. Наконец, ме¬ 
тод сопІіаіпзО проверяет присутствие указанного имени класса в атрибуте сіазз. 

Подобно другим классам коллекций в модели БОМ, объект ООМТокепИзІ: является 
«живым» представлением множества классов в элементе, а не статическим слеп¬ 
ком, который был действителен только в момент обращения к свойству СІаззИзІ:. 
Если сценарий получит объект ООМТокепИзІ:, обратившись к свойству СІаззИзІ: 
элемента, и затем изменит свойство сІаззМате этого элемента, то выполненные из¬ 
менения немедленно отразятся на полученном объекте ООМТокепИзІ:. Аналогично 
любые изменения, выполненные в объекте ООМТокепИзІ:, немедленно отразятся на 
значении свойства СІаззМате. 
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На момент написания этих строк свойство с1аз8І_і8І: не поддерживалось ни одним 
из текущих броузеров. Однако эту удобную функциональность легко можно реа¬ 
лизовать самому, как показано в примере 16.5. Подобная реализация, позволяю¬ 
щая интерпретировать атрибут с1а88 элемента как множество имен классов, су¬ 
щественно упрощает выполнение многих задач, связанных с обработкой С88. 

Пример 16.5. сІаз8ЬШ( ): интерпретирует сІаззИате, как множество СЗЗ-классов 
Л 

* Возвращает свойство сіаззі-ізі элемента е. если оно содержит один класс. 

* Иначе возвращает объект, имитирующий интерфейс 00МТокепІ_і5І:. 

* Возвращаемый объект имеет методы сопІаіпзО, асІсІО, гетоѵеО, ІоддІеО и ІоЗІгіпд(), 

* позволяющие проверять и изменять набор классов элемента е. Если свойство сІаззИзІ 

* имеет встроенную поддержку в броузере, функция возвращает объект, подобный массиву, 

* который имеет свойство ІепдІП и поддерживает возможность индексирования массива. 

* Имитация объекта ЭОМТокепІлзІ: не подобна массиву, но имеет метод ІоАггауО, 

* который возвращает истинный массив имен классов элемента. 

*/ 

^цпсііоп с1аззІ_і5І:(е) { 

іТ (е.сіаззі-із*) геіцгп е.сіаззі-ізі; // Вернуть е.сіаззі-ізі, если имеется 
еізе геіцгп пем СЗЗСІаззИзКе); // Иначе попытаться подделать его 

} 

// СЗЗСІаззИзІ: - класс ОаѵаЗсгірІ:, имитирующий объект ЭОМТокепІлзІ: 

^цпсііоп СЗЗС1аззИз1:(е) { Шз.е = е; } 

// Возвращает Ігце, если е.сІаззМате содержит класс с, иначе - Шзе 
С88С1азз1лз1:. ргоіоіуре.сопіаіпз = ^цпсііоп^) { 

// Проверить, является ли с допустимым именем класса 
іТ (с.ІепдІН === 0 || с. іпсІехО^Г' ") != -1) 

ІЬгом пем Ег гог("Недопустимое имя класса: + с + .); 

// Сначала проверить общие случаи 
ѵаг сіаззез = Шз. е.сІаззМате; 

і? (!сіаззез) геіцгп Гаізе; // е вообще не имеет классов 
і? (сіаззез === с) геіигп Ігце; // е имеет единственный класс, 

// имя которого точно совпадает с искомым 

// Иначе использовать ВедЕхр для поиска с как отдельного слова 
// \Ь - в регулярных выражениях соответствует границе слова, 
геіцгп сіаззез. зеагсП(”\\Ь" + с + "\\Ь") != -1; 

>; 


// Добавляет имя класса с в е.сІаззМате, если оно отсутствует в списке 
С8$С1азз1лз1:. ргоіоіуре.агісі = ^ипсііоп(с) { 

іі 1 (ІНіз.соп1:аіпз(с)) геіцгп; // Ничего не делать, если имя уже в списке 

ѵаг сіаззез = Шз.е.сІаззМате; 

і? (сіаззез && с1аззез[с1аззез.1епд1П-1] != " ") 

с = " " + с; // Добавить пробел, если необходим 

ІНіз.е.сІаззМате += с; // Добавить имя с в сІаззМате 

}; 

// Удаляет все вхождения с из е.сІаззМате 
С88С1аззИз1:. ргоіоіуре. гетоѵе = ^цпсііоп(с) { 

// Убедиться, что с - допустимое имя класса 
і? (с.ІепдІН === 0 || с. іпсіехОІЧ" ") != -1) 

ІНгом пем Еггог("Недопустимое имя класса: + с + .); 
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// Удалить все вхождения имени с как слова и все завершающие пробелы 
ѵаг раПегп = пем ПедЕхр("\\Ь" + с + "\\Ь\\з**’. "д"); 

ІГііз.е.сІаззМате = ІІііз.е. СІаззМате. гер1асе(раПегп, 


// Добавляет имя с в е. сІаззМате, если оно отсутствует в списке, и возвращает ігье. 

// Иначе удаляет все вхождения имени с из е. СІаззМате и возвращает І'аізе. 

СЗЗСІаззІ-ізі:. ргоіоіуре. Іоддіе = Гипс1:іоп(с ) { 

іГ (ТИіз.сопТаіпз(с)) { // Если е.сІаззМате содержит с 
ІИіз.гетоѵе(с); // удалить его. 

геіьгп Шзе; 

} 

еізе { // Иначе: 

ТІііз.ас)с)(с); // добавить его. 

геііігп Ігие; 

} 

>: 

// Возвращает само значение е.сІаззМате 

СЗЗСІаззизІ. ргоіоіуре. ІоЗігіпд = ^ітсТіопС) { геТіігп ТИіз.е.сІаззМате; }; 

// Возвращает имена из е.СІаззМате 
СЗЗСІаззИзІ:. ргоіоіуре. ІоАггау = ^ітсТіопС) { 

геііігп Шз.е.сІаззМате.таІісГі(/\Ь\ѵ^+\Ь/д) || []; 

}; 

16.6. Управление таблицами стилей 

До сих пор мы видели, как устанавливать и получать значения С88-свойств сти¬ 
ля и классы отдельных элементов. Однако существует еще возможность управле¬ 
ния самими таблицами стилей С88. Обычно в этом не возникает необходимости, 
тем не менее такая возможность иногда бывает полезной, и в этом разделе корот¬ 
ко будут представленные возможные приемы. 

При работе с самими таблицами стилей вам придется столкнуться с двумя типами 
объектов. Первый тип - это объекты Еіетепі:, представляющие элементы <зі:у1е> 
и <1іпк>, которые содержат или ссылаются на таблицы стилей. Это обычные эле¬ 
менты документа, и если в них определить атрибут іс), вы сможете выбирать их 
с помощью метода сіоситепі:.де1:Е1етепі:ВуІсІ( ). Второй тип объектов - объекты С55- 
ЗІуІеЗІіее*, представляющие сами таблицы стилей. Свойство сіоситепі:. з1:у1е5Мее1:з 
возвращает доступный только для чтения объект, подобный массиву, содержа¬ 
щий объекты СЗЗЗІіуІеЗІіееІ:, представляющие таблицы стилей документа. Если 
в элементе <зі:у1е> или <1іпк>, определяющем или ссылающемся на таблицу сти¬ 
лей, определить атрибут Шіе, этот объект будет доступен как свойство объекта 
СЗЗЗііуІеЗІіееі: с именем, указанным в атрибуте Шіе. 

Следующие разделы описывают, какие операции могут выполняться с этими эле¬ 
ментами <з*у1е> и <1іпк> и объектами таблиц стилей. 

16.6.1. Включение и выключение таблиц стилей 

Простейший прием работы с таблицами стилей является к тому же самым перено¬ 
симым и надежным. Элементы <з*у1е> и <1іпк> и объекты СЗЗЗІіуІеЗІіееІ: определи- 
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ют свойство СІізаЫесІ, доступное сценариям на языке ЛѵаЗсгірі для чтения и за¬ 
писи. Как следует из его имени, если свойство СІізаЫесІ принимает значение Іігие, 
таблица стилей оказывается отключенной и будет игнорироваться броузером. - 

Это наглядно демонстрирует функция с!ізаЫе51:у1езМее1:( ), представленная ниже. 
Если передать ей число, она будет интерпретировать его как индекс в массиве 
сіоситепі:. Зі:у1е51пее1:з. Если передать ей строку, она будет интерпретировать ее как 
селектор С88, передаст ее методу сіоситепі:. диегуЗеІесІіогАІІО (раздел 15.2.5) и ус¬ 
тановит в значение Іігие свойство СІізаЫесІ всех полученных элементов: 

^ітсііоп с!ізаЫе8і:у1езІіее1:(зз) { 
і? (іурео? зз === "гштЬег") 

сіоситепі:. 5І:у1еЗІпее1:5[ зз ]. СІізаЫесІ = Іігие; 
еізе { 

ѵаг зііееііз = сіоситепі:. риегуЗеІесІіогАІІСзз); 

1Ч)г(ѵаг і = 0; і < зііееііз. ІепдІЬ; і++) 
зИее1:5[ і ]. сІізаЫесІ = Іігие; 

} 

} 

16.6.2. Получение, вставка и удаление правил 
из таблиц стилей 

В дополнение к возможности включения и отключения таблиц стилей объект 
С8551:у1е5Мееі: также определяет АРІ для получения, вставки и удаления правил 
стиля из таблиц стилей. ІЕ8 и более ранние версии реализуют несколько иной 
АРІ, отличный от стандартного, реализуемого другими броузерами. 

Как правило, непосредственное манипулирование таблицами стилей редко быва¬ 
ет полезным. Вместо того чтобы добавлять новые правила в таблицы стилей, 
обычно лучше оставить их статичными и работать со свойством сІаззМате элемен¬ 
та. В то же время, если необходимо предоставить пользователю возможность пол¬ 
ного управления таблицами стилей веб-страницы, может потребоваться органи¬ 
зовать динамическое манипулирование таблицами. 

Объекты С555і:у1е5Мее1: хранятся в массиве сіоситепі:. зі:у1е5Мее1:з[ ]. Объект СЗЗЗіуІе- 
ЗІіееІ: имеет свойство сззРи1ез[], хранящее массив правил стилей: 

ѵаг ГігзіРиІе = сіоситепі: . 5Ііу1еЗИее1і5[ 0] .сззРи1ез[0]; 

В ІЕ это свойство носит имя гиіез, а не сззРиІез. 

Элементами массива сззРи1ез[] или ги1ез[] являются объекты СЗЗРиІе. В стан¬ 
дартном АРІ объект СЗЗРиІе может представлять С88-правила любого типа, вклю¬ 
чая @-правила, такие как директивы @ітрогіі и @раде. Однако в ІЕ массив ги1ез[] 
может содержать только фактические правила таблицы стилей. 

Объект СЗЗРиІе имеет два свойства, которые могут использоваться переносимым 
способом. (В стандартном АРІ правила, не относящиеся к правилам стилей, не 
имеют этих свойств, и потому, возможно, вам потребуется пропускать их при об¬ 
ходе таблицы стилей.) Свойство зеІесІіогТехі: - это С88-селектор для данного пра¬ 
вила, а свойство зіуіе - это ссылка на доступный для записи объект СЗЗЗіуІейес- 
Іагаііоп, который описывает стили, связанные с этим селектором. Напомню, что 
СЗЗЗІіуІеОесІа гаіііоп - это тот же самый тип, который используется для представ- 
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ления встроенных и вычисленных стилей. Объект СЗЗЗІіуІеОесІагаіііоп может при¬ 
меняться для чтения существующих или создания новых стилей в правилах. Не¬ 
редко при обходе таблицы* стилей интерес представляет сам текст правила, а не, 
разобранное его представление. В этом случае можно использовать свойство 
сззТехТ объекта СЗЗЗІіуІеОесІагаіііоп, в котором содержатся правила в текстовом 
представлении. 

В дополнение к возможности получения и изменения существующих правил таб¬ 
лиц стилей имеется возможность добавлять правила в таблицу стилей и удалять 
их из таблицы. Стандартный прикладной интерфейс определяет методы іпзегіі- 
Ріі1е() и сіе1е1іеНи1е(), позволяющие добавлять и удалять правила: 

сіосцтепі:.5іу1еЗМее1:5[0].іпзегі;Ри1е( ”Н1 { ГехІ-меідМІ:: ЬоІсГ, }", 0); 

Броузер ІЕ не поддерживает методы іпзегііРи1е() и с!е1е1іеРи1е(), но определяет 
практически эквивалентные им функции асІсІНи1е() и гетоѵеРи1е(). Единственное 
существенное отличие (помимо имен функций) состоит в том, что ас!с1Ри1е() ожи¬ 
дает получить селектор и стиль в текстовом виде в двух отдельных аргументах. 

Следующий пример реализует обход правил в таблице стилей и демонстрирует 
АРІ, внося несколько сомнительных изменений в таблицу: 

ѵаг зз = сіоситепі: . з1:у1е5Гіее1:з[ 0]; // Извлечь первую таблицу стилей 

ѵаг гіііез = 55.сз5Ріі1е5?55.с55Віі1е5:55. гіііез; // Извлечь правила 

Гог(ѵаг і = 0; і < гціез.ІепдІМ; і++) { // Цикл по этим правилам 

ѵаг гіііе = ги1ез[і]; 

ІГ (! гиіе. зеІесГогТехІ:) сопііпце; // Пропустить @ітрог1: и др. директивы 

ѵаг зеіесіог = гціе. зеІесГогТехІ:; // Селектор 

ѵаг гііІеТехІ = гцІе.зіуІе.сззТехІ:; // Стили в текстовом виде 

// Если правило применяется к элементам М, применить его к элементам М2 
// Учтите, что этот прием сработает, только если селектор 
// в точности будет иметь вид "М" 

ІГ (зеіесіог == "М") { 

ІГ (зз. іпзегіРцІе) зз. іпзе г1:Ри1е(’’П2 Г +гіі1еТех1:+ "}", гціез.ІепдГМ); 
еізе іГ (зз. асІсІРцІе) зз. ас!с1Рц1е("М2'', гцІеТехГ, гціез. ІепдГМ); 

} 

// Если правило устанавливает свойство іехГ-сІесогаГіоп, удалить его. 
іГ (гціе. зіуіе. ГехЮесогаПоп) { 

іГ (зз.сІеІеГеВцІе) зз.сіе1е1:еРц1е(і); 
еізе іГ (зз.гетоѵеВцІе) зз.гетоѵеВцІе(і); 

і--; // Скорректировать переменную цикла, поскольку прежнее правило с 
//индексом і+1 теперь стало правилом с индексом і 

} 

} 

16.6.3. Создание новых таблиц стилей 

Наконец, имеется возможность создавать совершенно новые таблицы стилей и до¬ 
бавлять их в документ. В большинстве броузеров эта операция выполняется с по¬ 
мощью стандартных приемов, реализованных в модели БОМ: создается новый 
элемент <зіу1е> и вставляется в документ в раздел <МеасІ>, затем с помощью свойст¬ 
ва іппегНТМІ_ добавляется содержимое таблицы стилей. Однако в ІЕ8 и в более ран- 
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них версиях новый объект СЗЗЗііуІеЗІіееі: необходимо создавать с помощью нестан¬ 
дартного метода сіоситепі:.сгеаі:е8і:у1е8Мее1:( ), а текст таблицы стилей добавлять 
с помощью свойства сззТехТ. Пример 16.6 демонстрирует создание новых таблиц* 


Пример 16.6. Создание новой таблицы стилей 

// Добавляет таблицу стилей в документ и заполняет ее указанными стилями. 

// Аргумент зіуіез может быть строкой или объектом. Если это строка, 

// она интерпретируется как текст таблицы стилей. Если это объект, то каждое 
// его свойство должно определять правило стиля, добавляемое в таблицу. 

// Именами свойств являются селекторы, а их значениями - соответствующие стили 
^цпсііоп ас1с)5і:у1ез(зі:у1ез) { 

// Сначала необходимо создать новую таблицу стилей 
ѵаг зІуІеЕН, зіуІеЗИееІ:; 

ІТ (сіосцтепі:. с геаіеЗіуІеЗНееІ:) { //Если определен ІЕ АРІ, использовать его 
зіуІеЗНееІ: = сіоситепі:. с геа1:е51:у1е5Ьее1;( ); 

} 

еізе { 

ѵаг Неасі = сіоситепі;.де1:Е1етеп1:5ВуТадМате('ТіеасГ)[0] 

зіуІеЕІІ: = сіосцтепі:. сгеаІеЕІетепІіС'зІіуІе"); // Новый элемент <з1:у1е> 

Неасі.аррепсіСШсКзІуІеЕІІ:); // Вставить в <Неас1> 

// Теперь новая таблица находится в конце массива 

зіуІеЗНееІ: = сіосцтепі:. зі:у1е5Ьее1:з[ сіосцтепі:. зІуІеЗНееІз. ІепдІН-1] 

} 


// Вставить стили в таблицу 
Н (Іуреоі 1 зіуіез === "зіігіпд") { 

// Аргумент содержит текстовое определение таблицы стилей 

іТ (зіуІеЕІі) зіуІеЕП. іппегНТМІ. = зіуіез; 

еізе зіуІеЗНееІ:.сззТехІ = зіуіез; // ІЕ АРІ 

} 

еізе { 

// Аргумент - объект с правилами для вставки 
ѵаг і = 0; 

Тог(зе1ес*ог іп зіуіез) { 

ІТ (зіуІеЗІіееІ. іпзегіРцІе) { 

ѵаг гціе = зеіесіог + {' + зі:у1ез[зеіесііог] + 

зіуІеЗНееІ:. іпзегі:Пц1е(гц1е, і++): 

} 

еізе { 

5І:у1е5Ііее1:.асісіПц1е(зеіесііог, зіу1ез[зе1есІог], і++): 

} 

} 


} 




17 

Обработка событий 


Клиентские программы на языке ЛѵаЗсгірі основаны на модели программиро¬ 
вания, когда выполнение программы управляется событиями (представленной 
в разделе 13.3.2). При таком стиле программирования веб-броузер генерирует со¬ 
бытие, когда с документом или некоторым его элементом что-то происходит. 
Например, веб-броузер генерирует событие, когда завершает загрузку докумен¬ 
та, когда пользователь наводит указатель мыши на гиперссылку или нажимает 
клавишу на клавиатуре. Если ЛѵаЗсгірі-приложение интересует определенный 
тип события для определенного элемента документа, оно может зарегистрировать 
одну или более функций, которая будет вызываться при возникновении этого со¬ 
бытия. Имейте в виду, что это не является уникальной особенностью веб-про- 
граммирования: все приложения с графическим интерфейсом пользователя дей¬ 
ствуют именно таким образом - они постоянно ожидают, пока что-то произойдет 
(т. е. ждут появления событий), и откликаются на происходящее. 

Обратите внимание, что слово событие не является техническим термином, тре¬ 
бующим строгого определения. События - это просто некоторые происшествия, 
о которых броузер извещает программу. События не являются объектами языка 
ЛѵаЗсгірі и никак не описываются в программном коде программы. Однако су¬ 
ществует множество объектов, имеющих отношение к событиям, использующих¬ 
ся в программном коде, и эти объекты требуют дополнительного технического 
описания. Поэтому мы начнем эту главу с некоторых важных определений. 

Тип события - это строка, определяющая тип происшествия. Тип «тоизетоѵе», 
например, означает, что пользователь переместил указатель мыши. Тип «кеу- 
сіодѵп» означает, что была нажата клавиша на клавиатуре. А тип «ІоасЬ означает, 
что завершилась загрузка документа (или какого-то другого ресурса) из сети. По¬ 
скольку тип события - это просто строка, его иногда называют именем события . 
И действительно, мы будем использовать эти имена для идентификации типов 
событий, о которых будет идти речь. Современные веб-броузеры поддерживают 
множество типов событий, краткий обзор которых приводится в разделе 17.1. 

Цель события - это объект, в котором возникло событие или с которым это собы¬ 
тие связано. Когда говорят о событии, обычно упоминают тип и цель события. 
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Например: событие «Іоасі» объекта Міпсіом или событие «сііск» элемента <Ьи*1оп>. 
Самыми типичными целями событий в клиентских приложениях на языке Лаѵа- 
Зсгірі являются объекты Міпсіом, Ооситепі: и Еіетепі:, но некоторые типы событий 
могут происходить и в других типах объектов. Например, в главе 18 мы познако¬ 
мимся с событием «геасіузіаіесЬап^е», которое возбуждается объектом ХМІ_НИр- 
Рериезі:. 

Обработчик события , или приемник события , - это функция, которая обраба¬ 
тывает, или откликается на событие. 1 Приложения должны зарегистрировать 
свои функции обработчиков событий в веб-броузере, указав тип события и цель. 
Когда в указанном целевом объекте возникнет событие указанного типа, броузер 
вызовет обработчик. Когда обработчики событий вызываются для какого-то объ¬ 
екта, мы иногда говорим, что броузер «возбудил», «сгенерировал» или «доставил» 
событие. Существует несколько способов регистрации обработчиков событий, 
описание которых приводятся в разделах 17.2 и 17.3. 

Объект события - это объект, связанный с определенным событием и содержа¬ 
щий информацию об этом событии. Объекты событий передаются функции обра¬ 
ботчика события в виде аргумента (кроме ІЕ8 и более ранних версий, где объект 
события доступен только в виде глобальной переменной еѵепі:). Все объекты собы¬ 
тий имеют свойство 1;уре, определяющее тип события, и свойство іагдеі, опреде¬ 
ляющее цель события. (В ІЕ8 в более ранних версиях вместо свойства іагдеі: сле¬ 
дует использовать свойство згсЕІешепІ.) Для каждого типа события в связанном 
объекте события определяется набор свойств. Например, объект, связанный с со¬ 
бытиями от мыши, включает координаты указателя мыши, а объект, связанный 
с событиями от клавиатуры, содержит информацию о нажатой клавише и о нажа¬ 
тых клавишах-модификаторах. Для многих типов событий определяются только 
стандартные свойства, такие как *уре и гагдеі, и не передается никакой дополни¬ 
тельной полезной информации. Для таких типов событий важно само наличие 
происшествия события, и никакая другая информация не имеет значения. В этой 
главе нет отдельного раздела, посвященного объекту Еѵепі:. Вместо этого здесь 
описываются свойства объектов событий для событий определенных типов. До¬ 
полнительные сведения об объектах событий вы найдете в справочной статье 
Еѵепі: в четвертой части книги. 2 

Распространение события - это процесс, в ходе которого броузер решает, в каких 
объектах следует вызвать обработчики событий. В случае событий, предназна¬ 
ченных для единственного объекта (таких как событие «Іоасі» объекта Іл/іпсіом), на¬ 
добность в их распространении отсутствует. Однако, когда некоторое событие воз¬ 
никает в элементе документа, оно распространяется, или «всплывает», вверх по 


1 Некоторые источники, включая спецификацию НТМЬб, различают обработчики со¬ 
бытий и приемники событий, в соответствии со способом, которым они были зарегист¬ 
рированы. В этой книге мы будем использовать эти два термина как синонимы. 

2 Стандарты определяют целую иерархию объектов событий для событий различных ти¬ 
пов. Интерфейс Еѵепі: описывает «простые» события, которые не сопровождаются до¬ 
полнительной информацией. Например, подкласс МоизеЕѵепІ: описывает дополнитель¬ 
ные поля, доступные в объектах событий, передаваемых при возбуждении события от 
мыши, а подкласс Кеу Еѵепі описывает поля, которые можно использовать при обработ¬ 
ке событий от клавиатуры. Описания всех этих классов в данной книге помещены в об¬ 
щую справочную статью Еѵепі. 



478 


Глава 17. Обработка событий 


дереву документа. Бели пользователь щелкнет мышью на гиперссылке, событие 
«тоиветоѵе* сначала будет возбуждено в элементе <а>, определяющем эту ссыл¬ 
ку. Затем оно будет доставлено вмещающим элементам: возможно, элементу <р> г 
элементу <с!іѵ> и самому объекту Ооситепі:. Иногда удобнее бывает зарегистриро¬ 
вать единственный обработчик события в объекте Ооситепі: или в другом контей¬ 
нерном элементе, чем выполнять регистрацию во всех интересующих нас элемен¬ 
тах. Обработчик события может прервать дальнейшее распространение события, 
чтобы оно прекратило всплытие и не привело к вызову обработчиков вмещающих 
элементов. Делается это вызовом метода или установкой свойства объекта собы¬ 
тия. Детально распространение событий рассматривается в разделе 17.3.6. 

Еще одна форма распространения событий, которая называется перехватом со¬ 
бытия , позволяет специально зарегистрированным обработчикам или контей¬ 
нерным элементам «перехватывать» события до того, как они достигнут фактиче¬ 
ской цели. Перехват событий не поддерживается в 1Б8 и в более ранних версиях 
и поэтому редко используется на практике. Однако возможность перехватывать 
события от мыши совершенно необходима при обработке событий буксировки 
объектов мышью; как это делается, будет показано в примере 17.2. 

Для некоторых событий предусматриваются связанные с ними действия по умол¬ 
чанию . Например, для события «сііск», возникающего в гиперссылке, по умолча¬ 
нию предусматривается операция перехода по ссылке и загрузки новой страницы. 
Обработчики могут предотвратить выполнение действий по умолчанию, вернув 
соответствующее значение, вызвав метод или установив свойство объекта собы¬ 
тия. Это иногда называют «отменой» события; подробнее эта тема рассматривает¬ 
ся в разделе 17.3.7. 

Дав определения некоторым терминам, можно перейти к изучению вопросов, 
связанных с событиями и их обработкой. В первом разделе, следующем ниже, 
приводится обзор множества типов событий, поддерживаемых веб-броузерами. 
Вы не найдете здесь подробное описание какого-то одного типа событий, но этот 
раздел даст вам представление о том, какие типы событий доступны для исполь¬ 
зования в веб-приложениях. В данном разделе есть ссылки на другие части кни¬ 
ги, где демонстрируются некоторые события в действии. 

После представления типов событий в следующих двух разделах описывается, 
как регистрировать обработчики событий и как броузер вызывает эти обработчи¬ 
ки событий. Из-за особенностей развития модели событий в ЛаѵаЗсгірі и из-за от¬ 
сутствия поддержки стандартной модели в ІЕ8 и в более ранних версиях обе эти 
темы являются более сложными, чем можно было бы ожидать. 

Завершится эта глава серией примеров, демонстрирующих, как правильно обра¬ 
батывать некоторые типы событий. В этих разделах рассматриваются: 

• События загрузки и готовности документа 

• События от мыши 

• Событие от колесика мыши 

• События буксировки мышью 

• События от клавиатуры 

• События ввода текста 
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• 

На заре развития Всемирной паутины веб-разработчикам приходилось иметь де¬ 
ло лишь с небольшим количеством событий: «ІоасЬ, «сііск», «тоивеоѵег» и други¬ 
ми. Эти довольно старые типы событий хорошо поддерживаются всеми броузера¬ 
ми и рассматриваются в разделе 17.1.1. По мере развития веб-платформы в нее 
были включены более мощные прикладные интерфейсы, а количество событий 
существенно увеличилось. Не существует стандарта, который определял бы пол¬ 
ный набор событий, и к моменту написания этих строк количество поддерживае¬ 
мых событий продолжает быстро увеличиваться. Эти новые события определя¬ 
ются в следующих трех источниках: 

• Спецификация «БОМ Ьеѵеі 3 Еѵепів», которая после долгих лет застоя стала 
активно разрабатываться под эгидой консорциума ДѴЗС. События БОМ рас¬ 
сматриваются в разделе 17.1.2. 

• Множество новых прикладных интерфейсов в спецификации НТМЬб (и в свя¬ 
занных с ней дополнительных спецификациях) определяют новые события, 
используемые, например, для управления историей посещений, механизмом 
сіга^-апсі-сігор (перетащил и бросил), обмена сообщениями между документа¬ 
ми и проигрывания аудио- и видеороликов. Обзор этих событий приводится 
в разделе 17.1.3. 

• С появлением мобильных устройств с сенсорными экранами, поддерживаю¬ 
щих ЛѵаЗсгірі, таких как іРЬопе, возникла необходимость в определении но¬ 
вых типов событий касаний и жестов. Некоторые примеры, специфические 
для устройств, выпускаемых компанией Арріе, приводятся в разделе 17.1.4. 

Обратите внимание, что многие из этих новых типов событий пока еще не полу¬ 
чили широкой поддержки и определяются стандартами, которые еще находятся 
на стадии проектирования. В последующих разделах дается краткий обзор этих 
событий, но подробное их описание отсутствует. Оставшаяся часть главы полно¬ 
стью охватывает модель обработки событий и включает множество примеров ра¬ 
боты с поддерживаемыми событиями. Если вы поймете, как работать с события¬ 
ми в целом, вы легко сможете реализовать обработку этих новых типов событий, 
как только будут определены и реализованы соответствующие прикладные ин¬ 
терфейсы. 

17.1.1. Старые типы событий 

События, которые вам чаще всего придется использовать в своих веб-приложени- 
ях, обычно будут относиться к категории давно существующих и поддерживае¬ 
мых всеми броузерами: это события для работы с мышью, с клавиатурой, 
с НТМЬ-формами и с объектом Іл/іпсіом. В следующих разделах описывается мно¬ 
жество важных особенностей событий этих типов. 

17.1.1.1. События форм 

Формы и гиперссылки стали первыми элементами веб-страниц, возможность 
управления которыми была реализована в начале развития Всемирной паутины 
и ^ѵаЗсгірі. Это означает, что события форм являются наиболее устойчивыми 
и хорошо поддерживаемыми из всех типов событий. Элементы <^огт> возбуждают 
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события «зиЪтіі», при отправке формы, и «гезеі», перед сбросом формы в исход¬ 
ное состояние. Элементы форм, внешним видом напоминающие кнопки (вклю¬ 
чая радиокнопки и флажки), возбуждают события «сііск», когда пользователе 
взаимодействуют с ними. Элементы форм, позволяющие вводить некоторую ин¬ 
формацию, обычно возбуждают события «сЬап^е», когда пользователь изменяет 
их состояние, вводя текст, выбирая элемент списка или отмечая флажок. Для 
текстовых элементов ввода событие «сЬап^е» не возбуждается, пока пользова¬ 
тель не завершит взаимодействие с ними и не передаст фокус ввода другому эле¬ 
менту. Элементы форм откликаются на изменение фокуса ввода, возбуждая со¬ 
бытия «&>сиз» и «Ыиг» при получении и утере фокуса ввода. 

Все эти события, связанные с формами, подробно рассматривались в разделе 15.9.3. 
Тем не менее здесь следует сделать несколько важных дополнений. 


Категории событий 

События могут быть сгруппированы в некоторые обобщенные категории, 
знание которых поможет вам понять длинный перечень событий, следую¬ 
щий далее: 

Аппаратно-зависимые события ввода 

События из этой категории непосредственно связаны с конкретными 
устройствами ввода, такими как мышь или клавиатура. В эту категорию 
входят такие старые события, как «тоизесіоѵѵп», «тоизетоѵе», «тоизе- 
ир», «кеусіодѵп», «кеургезз» и «кеуир», а также новые события, имеющие 
отношение к сенсорным устройствам, такие как «іоисЬтоѵе» и «^езіи- 
гесЬап^е». 

Аппаратно-независимые события ввода 

Эти события ввода не связаны непосредственно с каким-то определен¬ 
ным устройством. Например, событие «сііск» указывает на то, что была 
активирована ссылка или кнопка (или другой элемент документа). Это 
событие часто порождается щелчком мыши, но его причиной также мо¬ 
жет быть нажатие клавиши на клавиатуре или (для сенсорных уст¬ 
ройств) некоторое перемещение по экрану. Событие «іехііприі» (которое 
пока реализовано не во всех броузерах) является аппаратно-независи¬ 
мой альтернативой событию «кеургезз» и поддерживает не только ввод 
с клавиатуры, но и такие альтернативы, как вставка из буфера обмена 
и ввод рукописного текста. 

События пользовательского интерфейса 

События ПИ - это высокоуровневые события, которые часто возникают 
в элементах НТМЬ-форм, составляющих пользовательский интерфейс 
веб-приложения. В эту категорию входит событие «Іосиз» (возникаю¬ 
щее, когда текстовое поле получает фокус ввода), событие «сЬап^е» (воз¬ 
никающее, когда пользователь изменяет значение, отображаемое эле¬ 
ментом формы) и событие «зиЪтіі» (возникающее, когда пользователь 
щелкает на кнопке отправки формы). 
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События изменения состояния 

Некоторые события не связаны непосредственно с деятельностью пользо¬ 
вателя, но имеют отношение к выполнению сетевых операций броузером 
и указывают на переход к другому этапу операции или на изменение со¬ 
стояния. Событие «Іоасі», которое возбуждается в объекте іл/іпсіом по окон¬ 
чании загрузки документа, является, пожалуй, наиболее часто исполь¬ 
зуемым типом событий из этой категории. Еще одним представителем из 
этой категории является событие « БОМСопіепіЬоасІесІ » (обсуждалось 
в разделе 13.3.4). Механизм управления историей посещений, определяе¬ 
мый стандартом НТМЬб (раздел 22.2), возбуждает событие «рорзіаіе» 
в ответ на нажатие клавиши Васк (Назад) броузера. Прикладной интер¬ 
фейс автономных веб-приложений, описываемый стандартом НТМЬб 
(раздел 20.4), включает события «опііпе» и «оШіпе». В главе 18 демонст¬ 
рируется, как пользоваться событием «геасІузіаіесЬап&е», сообщающем 
о получении данных с сервера. Аналогично новый АРІ чтения локаль¬ 
ных файлов, выбранных пользователем (раздел 22.6.6), использует со¬ 
бытия, такие как «Іоасізіагі», «рго^гезз» и «Іоасіепсі», для отправки асин¬ 
хронных извещений о ходе выполнения операций ввода-вывода. 

Прикладные события 

Некоторые прикладные интерфейсы, определяемые стандартом НТМЬб 
и связанными с ним спецификациями, включают собственные типы со¬ 
бытий. Интерфейс бга^-апб-бгор (раздел 17.7) определет такие события, 
как «бга^зіагі», «бга^епіег», «бга^оѵег» и «бгор». Приложения, обеспе¬ 
чивающие поддержку буксировки элементов мышью, должны реализо¬ 
вать обработку некоторых из этих событий. Элементы <ѵіс!ео> и <аис!іо> 
(раздел 21.2), определяемые стандартом НТМЬб, добавляют длинный 
список связанных с ними типов событий, таких как «дѵаіііпз», «ріауіп^», 
«зеекіп#», «ѵоІитесЬап^е» и т. д. Эти события обычно представляют ин¬ 
терес только для веб-приложений, определяющих собственные элемен¬ 
ты управления проигрыванием аудио- и видеороликов. 

Обработчики ошибок и событий от таймеров 

Обработчики ошибок и событий от таймеров (были описаны в главе 14) 
являются частью асинхронной модели программирования в клиент¬ 
ском ЛѵаЗсгірі и похожи на обработчики обычных событий. Несмотря 
на то что обработчики ошибок и событий от таймеров не рассматривают¬ 
ся в этой главе, их очень удобно воспринимать как обработчики обыч¬ 
ных событий, и, возможно, вам будет интересно прочитать разделы 14.1 
и 14.6 еще раз, с позиций, предлагаемых этой главой. 


Для событий «зиЪтіІ» и «гезеі» предусматриваются действия по умолчанию, вы¬ 
полнение которых можно отменить в обработчиках событий, как и в случае неко¬ 
торых событий «сііск». Все события форм всплывают, кроме событий «Іосиз» 
и «Ыиг». ІЕ определяет события «Іосизіп» и «Іосизоиі», которые являются всплы¬ 
вающими альтернативами событий «Іосиз» и «Ыиг». Библиотека іСіиег у (глава 19) 
имитирует события «Іосизіп» и «Іосизоиі» в броузерах, не поддерживающих их. 
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Кроме того, эти события были стандартизованы спецификацией «БОМ Ьеѵеі 3 
Еѵепів». 

Наконец, имейте в виду, что все броузеры, кроме ІЕ, возбуждают событие «іприі» 
в элементах <1:ех1:агеа> и в других текстовых элементах ввода, когда пользователь 
вводит текст (посредством клавиатуры или вставкой из буфера обмена) в элемент. 
В отличие от события «сЬап&е», данное событие «іприі» возбуждается при каж¬ 
дой вставке. К сожалению, объект события, соответствующий событию «іприі», 
не позволяет узнать, какой текст был введен. (Более полезной альтернативой это¬ 
му событию является новое событие «іехііприи, описываемое ниже.) 

17.1.1.2. События объекта ѴѴіпсІоѵѵ 

События объекта Ыіпсіоѵѵ представляют происшествия, имеющие отношение к са¬ 
мому окну броузера, а не к определенному содержимому документа, отображае¬ 
мому в окне. (Однако некоторые из этих событий имеют имена, совпадающие 
с именами событий, возбуждаемых для элементов документа.) 

Самым важным из этих событий является событие «ІоасЬ: оно возбуждается сра¬ 
зу после того, как будут загружены и отображены документ и все внешние ресур¬ 
сы (такие как изображения). Событие «ІоасЬ обсуждалось на протяжении гла¬ 
вы 13. Альтернативами событию «ІоасЬ являются события «БОМСопІепІЬоасіесЬ 
и «геасІу8І;а1;есЬап2е»: они возбуждаются сразу же, как только документ и его эле¬ 
менты будут готовы к выполнению операций, но до того, как полностью будут 
загружены внешние ресурсы. Примеры использования этих событий, имеющих 
отношение к документу, приводятся в разделе 17.4. 

Событие «ипІоасЬ является противоположностью событию «ІоасЬ: оно возбужда¬ 
ется, когда пользователь покидает документ. Обработчик события «ипІоасЬ мож¬ 
но использовать, чтобы сохранить информацию о состоянии, но в нем нельзя от¬ 
менить переход на другую страницу. Событие «Ъе^огеипІоасЬ похоже на событие 
«ипІоасЬ, но оно дает возможность узнать у пользователя, действительно ли он 
желает покинуть вашу веб-страницу. Если обработчик события «ЪеіЪгеипІоасЬ 
вернет строку, эта строка будет выведена в диалоге подтверждения перед тем, как 
будет загружена новая страница; этот диалог даст пользователю возможность от¬ 
менить переход и остаться на текущей странице. 

Свойство опеггог объекта Ыіпсіоѵѵ является своего рода обработчиком событий, ко¬ 
торый вызывается в случае появления ошибок в программном коде на языке 
ѵаЗсгірі. Однако это не настоящий обработчик событий, потому что он вызывает¬ 
ся совсем с другим набором аргументов. Подробности смотрите в разделе 14.6. 

Имеется также возможность регистрировать обработчики событий «ІоасЬ и «еггог» 
для отдельных элементов документа, таких как <ітд>. Эти события возбуждаются, 
когда внешний ресурс (например, изображение) будет полностью загружен или ко¬ 
гда возникнет ошибка, препятствующая его загрузке. Некоторые броузеры поддер¬ 
живают также событие «аЪогі» (стандартизованное спецификацией НТМЬб), кото¬ 
рое возбуждается, когда загрузка изображения (или другой ресурс, загружаемый 
из сети) прерывается из-за того, что пользователь остановил процесс загрузки. 

События «?осіі8» и «Ыиг», описанные выше вместе с другими событиями элемен¬ 
тов форм, также поддерживаются объектом Ыіпсіоѵѵ: они возбуждаются, когда те¬ 
кущее окно броузера получает или теряет фокус ввода. 



17.1. Типы событий 


483 


Наконец, события «гезіге» и «зсгоіі» возбуждаются в объекте Міпсіоѵѵ, когда выпол¬ 
няется изменение размеров или прокрутка окна броузера. События «зсгоіі» могут 
также возбуждать все прокручиваемые элементы документа, например те, что 
имеют С88-свойство оѵегИоѵѵ (раздел 16.2.6). Объект события, передаваемый обра¬ 
ботчикам событий «гезіге» и «зсгоіі», - это самый обычный объект Еѵепі:, не имею¬ 
щий свойств, которые позволяли бы узнать новый размер окна или величину про¬ 
крутки. Чтобы узнать новый размер окна или позиции полос прокрутки, следует 
использовать приемы, продемонстрированные в разделе 15.8. 

17.1.1.3. События мыши 

События от мыши возбуждаются, когда пользователь перемещает указатель мы¬ 
ши или выполняет щелчок. Эти события генерируются в наиболее глубоко вло¬ 
женных элементах, над которыми находится указатель мыши, но они всплыва¬ 
ют вверх по дереву документа. Объект события, передаваемый обработчикам со¬ 
бытий от мыши, имеет свойства, позволяющие узнать координаты указателя, 
состояние кнопок мыши, а также состояние клавиш-модификаторов на момент 
возникновения события. Свойства сІіепІіХ и сІіепІіУ определяют положение указа¬ 
теля мыши в системе координат окна. Свойства ЬиНоп и ѵѵМісМ позволяют узнать, 
какая кнопка была нажата. (Обязательно ознакомьтесь со справочной статьей 
Еѵепі: в четвертой части книги, чтобы знать, как организовать работу с этими 
свойствами переносимым способом.) Свойства аІІіКеу, сШКеу, теІіаКеу и зМіІЧКеу по¬ 
лучают значение Іігие, если в момент возникновения события удерживалась на¬ 
жатой соответствующая клавиша-модификатор. А свойство сіеііаіі для события 
«сііск» указывает, был ли выполнен одинарный, двойной или тройной щелчок. 

Событие «тоизетоѵе» генерируется всякий раз, когда пользователь перемещает 
указатель мыши. Это событие возбуждается очень часто, поэтому его обработчики 
не должны выполнять тяжелые вычисления. События «тоизесіолѵп» и «тоизеир» 
генерируются, когда пользователь нажимает и отпускает кнопку мыши. Зарегист¬ 
рировав обработчик события «тоизесклѵп», который регистрирует обработчик со¬ 
бытия «тоизетоѵе», можно организовать определение и обработку ситуаций бук¬ 
сировки элементов мышью. При этом необходимо обеспечить возможность перехва¬ 
тывать события от мыши, чтобы продолжать получать события «тоизетоѵе», даже 
когда указатель мыши выходит за пределы элемента, где была начата буксиров¬ 
ка. В разделе 17.5 приводится пример реализации буксировки элементов мышью. 

После последовательности событий «тоизесіолѵп» и «тоизеир» броузер генериру¬ 
ет событие «сііск». Событие «сііск» было описано выше, как аппаратно-независи¬ 
мое событие форм, но на самом деле оно может генерироваться для любого эле¬ 
мента документа, а не только для элементов форм, и вместе с ним обработчику 
передается объект события со всеми дополнительными полями, описанными вы¬ 
ше. Если вы дважды щелкнете мышью на строке (в течение достаточно короткого 
промежутка времени), второй щелчок сгенерирует событий «бЫсІіск». Когда щел¬ 
чок выполняется правой кнопкой мыши, броузеры часто выводят контекстное 
меню. Вообще, прежде чем вывести контекстное меню, они возбуждают событие 
«сопіехітепи», и, если отменить это событие в обработчике, можно предотвра¬ 
тить появление меню. Кроме того, это наиболее простой способ организовать об¬ 
работку щелчка правой кнопкой мыши. 

Когда пользователь перемещает указатель мыши так, что он оказывается над 
другим элементом, броузер возбуждает событие «шоизеоѵег» для этого элемента. 
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Когда указатель мыши покидает границы элемента, броузер генерирует для него 
событие «тоизеоиі». Объект события для этих событий будет иметь свойство геіа- 
ІесІТагдеІ, определяющее другой элемент, вовлеченный в переход. (Эквивалент 
свойства геІаІесІТагдеІ: в ІЕ вы найдете в справочной статье Еѵепі:.) События 
«тоизеоѵег» и «тоизеоиі» всплывают, как и все остальные описанные здесь со¬ 
бытия от мыши. Иногда это оказывается неудобно, потому что в обработчике со¬ 
бытия «тоизеоиі» приходится проверять, действительно ли указатель мыши по¬ 
кинул данный элемент или он просто переместился из одного дочернего элемента 
в другой. По этой причине в ІЕ поддерживается невсплывающие версии этих со¬ 
бытий, известные как «тоизеепіег» и «тоизеіеаѵе». Библиотека іС^иегу эмулиру¬ 
ет поддержку этих событий в броузерах, отличных от ІЕ (глава 19), а кроме того, 
эти события стандартизованы в спецификации «БОМ Ьеѵеі 3 Еѵепіз». 

Когда пользователь вращает колесико мыши, броузеры генерируют событие «тои- 
зедѵЬееІ» (или в Гігеіох событие «БОММоизеЗсгоІІ»). Объект события, передавае¬ 
мый вместе с этими событиями, включает свойства, позволяющие узнать, на какое 
расстояние и в каком направлении было повернуто колесико. Спецификация «БОМ 
Ьеѵеі 3 Еѵепіз» стандартизует более универсальное многомерное событие от коле¬ 
сика, которое, если будет реализовано, заменит оба события, «тоизеѵѵЬееІ» и «БОМ- 
МоизеЗсгоІІ». Пример обработки события «тоизедѵЬееІ» приводится в разделе 17.6. 

17.1.1.4. События клавиатуры 

Когда веб-броузер получает фокус ввода, он начинает генерировать события вся¬ 
кий раз, когда пользователь нажимает и отпускает клавиши на клавиатуре. На¬ 
жатия горячих комбинаций, имеющих значение для операционной системы или 
самого броузера, часто «съедаются» операционной системой или броузером и не пе¬ 
редаются обработчикам событий на ЛѵаЗсгірі. События от клавиатуры генериру¬ 
ются в любом элементе документа, обладающем фокусом ввода, и всплывают вверх 
до объектов документа и окна. Если ни один элемент не обладает фокусом ввода, 
события возбуждаются непосредственно в объекте документа. Обработчикам со¬ 
бытий от клавиатуры передается объект события, имеющий свойство кеуСосіе, по¬ 
зволяющее узнать, какая клавиша была нажата или отпущена. В дополнение 
к свойству кеуСосіе объект события от клавиатуры также имеет свойства аІіКеу, 
сігІКеу, теіаКеу и 5ІііГ1:Кеу, описывающие состояние клавиш-модификаторов. 

События «кеусіолѵп» и «кеуир» являются низкоуровневыми событиями от клавиа¬ 
туры: они генерируются, когда производится нажатие или отпускание клавиши 
(даже если это клавиша-модификатор). Когда событие «кеуболѵп» генерируется 
нажатием клавиши, соответствующей печатаемому символу, после события «кеу- 
сіоѵѵп», но перед событием «кеуир» дополнительно генерируется событие «кеу¬ 
ргезз». (В случае если клавиша удерживается в нажатом состоянии настолько 
долго, что начинается автоповтор символа, перед событием «кеуир» будет сгене¬ 
рировано множество событий «кеургезз».) Событие «кеургезз» является высоко¬ 
уровневым событием ввода текста и соответствующий ему объект события содер¬ 
жит информацию о введенном символе, а не о нажатой клавише. 

События «кеусіодѵп», «кеуир» и «кеургезз» поддерживаются всеми броузерами, 
однако существуют некоторые проблемы совместимости из-за того, что не были 
стандартизованы значения свойства кеуСосіе объекта события. Спецификация 
«БОМ Ьеѵеі 3 Еѵепіз», описываемая ниже, пытается решить эти проблемы со¬ 
вместимости, но эти решения пока не реализованы. Пример обработки событий 
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«кеусіолѵп» приводится в разделе 17.9, а в разделе 17.8 приводится пример обра¬ 
ботки событий «кеургезз». 

ф 

17.1.2. События модели ООМ 

Спецификация «БОМ Ьеѵеі 3 Еѵепіз» разрабатывалась консорциумом ДѴЗС около 
десяти лет. К моменту написания этих строк она была подвергнута существенно¬ 
му пересмотру с целью привести в соответствие с текущими реалиями и наконец 
достигла стадии стандартизации «последней версии рабочего проекта». Она стан¬ 
дартизует многие из старых событий, описанных выше, и добавляет несколько 
новых событий, описываемых здесь. Эти новые типы событий пока не получили 
широкой поддержки, но производители броузеров предполагают реализовать их 
к моменту окончательного утверждения стандарта. 

Как отмечалось выше, спецификация «БОМ Ьеѵеі 3 Еѵепіз» стандартизует со¬ 
бытия «?оси8Іп» и «йэсизоііі» как всплывающие альтернативы событий «іЪсиз» 
и «Ыиг», а также события «тоизеепіег» и «тоизеіеаѵе» - как невсплывающие аль¬ 
тернативы событий «тоизеоѵег» и «тоизеоиі». Кроме того, эта версия стандарта 
не рекомендует использовать некоторые типы событий, которые были определе¬ 
ны спецификацией «БОМ Ьеѵеі 2 Еѵепіз», но никогда не были реализованы. Бро¬ 
узеры по-прежнему обеспечивают поддержку событий, таких как «БОМАсііѵаіе», 
«БОМЕосизІп» и «БОМ№хіеІп8егіе<1», но теперь это необязательно, и потому дан¬ 
ные события не описываются в этой книге. 1 

Из новшеств, появившихся в спецификации «БОМ Ьеѵеі 3 Еѵепіз», можно на¬ 
звать стандартизацию поддержки двунаправленных колесиков мыши через собы¬ 
тие «\ѵЬее1» и улучшенную поддержку событий ввода текста через событие «іехі- 
іприі» и новый объект КеуЬоагсІЕѵепІ:, который передается обработчикам событий 
«кеусіодѵп», «кеуир» и «кеургезз». 

Согласно этой спецификации обработчику события «лѵЬееЬ должен передаваться 
объект события, содержащий все свойства, обычные для объектов событий от 
мыши, а также свойства йеІІіаХ, сІеІІіаУ и с!е11:а7, позволяющие узнать величину 
прокрутки вокруг трех разных осей колесика мыши. (В большинстве мышей ко¬ 
лесико вращается в одном или двух измерениях, и поэтому свойство Йе11:а7 пока 
остается неиспользуемым.) Подробнее о событиях «тоизедѵІіееЬ рассказывается 
в разделе 17.6. 

Стандарт «БОМ Ьеѵеі 3 Еѵепіз» определяет событие «кеургезз», описанное выше, 
но не рекомендует использовать его и отдает предпочтение новому событию с име¬ 
нем «іехііприі». Вместо сложного в использовании числового значения в свойстве 
кеуСосІе, объект события, передаваемый обработчикам события «іехііприі», имеет 
свойство сіаіа, содержащее введенную строку текста. Событие «іехііприі» не явля¬ 
ется в полной мере событием от клавиатуры: оно возбуждается при выполнении 
любой операции ввода текста, которая может быть выполнена с помощью клавиа¬ 
туры, копированием из буфера обмена, операцией буксировки (бга^-апб-бгор) 
и т. д. Спецификация определяет свойство 1при1:Ме1:Ьос1 объекта события и множе¬ 
ство констант, представляющих различные способы ввода текста (с клавиатуры. 


1 Единственным часто используемым событием, в имени которого присутствует при¬ 
ставка «БОМ», является событие «ВОМСопіепіЬоасіесІ». Это событие было введено ком¬ 
панией МогШа и никогда не являлось частью стандарта «БОМ Еѵепіз». 
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копированием из буфера обмена или буксировкой мышью, путем распознавания 
рукописного текста или голоса и т. д.). К моменту написания этих строк броузе¬ 
ры За^агі и СЬготе поддерживали версию этого события с именем «іехііприі»! 
Соответствующий ему объект события включает свойство йаіа, но в нем отсутст¬ 
вует свойство іпри^Ме'Ы’іосІ. Пример использования события «іехііприі» приводит¬ 
ся в разделе 17.8. 

Новый стандарт БОМ также упрощает события «кеусіолѵп», «кеуир» и «кеургезз», 
добавляя новые свойства кеу и сЬаг в объект события. Оба эти свойства содержат 
строковые значения. Для клавиш, генерирующих печатаемые символы, свойства 
кеу и сЬаг будут хранить один и тот же сгенерированный текст. Для управляю¬ 
щих клавиш свойство кеу будет хранить строку вида «Епіег», «Беіеіе» или «ЬеіЪ», 
идентифицирующую клавишу. А свойство сЬаг будет хранить либо значение пиіі, 
либо, для таких управляющих клавиш, как ТаЬ, - имеющих соответствующий 
управляющий символ, - строку, сгенерированную клавишей. На момент написа¬ 
ния этих строк ни один броузер не поддерживал эти свойства кеу и сМаг, но при¬ 
мер 17.8 будет использовать свойство кеу, когда оно будет реализовано. 


17.1.3. События НТМІ.5 


Стандарт НТМЬб и связанные с ним стандарты определяют основу новых АРІ 
для веб-приложений (глава 22). Многие из этих АРІ определяют события. В этом 
разделе перечисляются и коротко описываются эти события НТМЬб и веб-прило- 
жений. Некоторые из этих событий уже готовы к использованию и более подроб¬ 
но описываются в разных главах книги. Другие пока реализованы не во всех бро¬ 
узерах и не описываются подробно. 


Одной из широко рекламируемых особенностей НТМЬ является возможность 
включения элементов <аис!іо> и <ѵійео> для проигрывания аудио- и видеороликов. 
Эти элементы имеют длинный перечень генерируемых ими событий, позволяю¬ 
щих отправлять извещения о сетевых событиях, о состоянии механизма буфери¬ 
зации данных и механизма воспроизведения: 


сапріау Іоасіесісіаіа ріауіпд 

сапрІауІМгоидМ Іоасіесітеіасіаііа ргодгезз 

сІигаІіопсМапде Іоасізіагі: гаІесМапде 

етрііесі раизе зеекесі 

епсіесі ріау зеекіпд 


зіаііесі 

зизрепсі 

итеирсіаііе 

ѵоІитесМапде 

маШпд 


Эти события, имеющие отношение к медиапроигрывателям, передаются в виде 
простого объекта события, не имеющего специальных свойств. Однако свойство 
Ііагдеі: идентифицирует элемент <аис!іо> или <ѵійео>, и этот элемент имеет множе¬ 
ство специфических свойств и методов. Более подробно об этих элементах, их 
свойствах и событиях рассказывается в разделе 21.2. 

Интерфейс механизма буксировки ((іга^-апсі-сігор), определяемый стандартом 
НТМЬб, позволяет приложениям на языке ^ѵаЗсгірі участвовать в операциях 
буксировки объектов мышью, опираясь на механизмы, реализованные в операци¬ 
онной системе, и обмениваться данными с обычными приложениями. Этот при¬ 
кладной интерфейс определяет следующие семь типов событий: 


сігадзіагі: 

сігадепіег 

сігор 


сігад 

сігадоѵег 


сігадепсі 

сігадіеаѵе 
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Эти события буксировки сопровождаются объектами событий, подобными тем, 
что передаются вместе с событиями от мыши. Отличаются они единственным до¬ 
полнительным свойством сІаТаТгапзТег, хранящим объект ОаІіаТгапзРег с информа¬ 
цией о передаваемых данных и о форматах, в которых эти данные доступны. При¬ 
кладной интерфейс механизма бга^-апб-бгор, определяемый стандартом НТМЬб, 
описывается и демонстрируется в разделе 17.7. 

Спецификация НТМЬб определяет также механизм управления историей посе¬ 
щений (раздел 22.2), что позволяет веб-приложениям взаимодействовать с кноп¬ 
ками броузера Васк (Назад) и Рогѵѵагсі (Вперед). Этот механизм вводит события с име¬ 
нами «ЬавЬсЬап&е» и «рорзіаіе», которые возникают тогда же, когда и события 
«ІоасЬ и «ипіоасі», и возбуждаются в объекте Ыіпсіоѵѵ, а не в документе. 

В НТМЬб определяется множество новых особенностей НТМЬ-форм. В дополне¬ 
ние к событиям ввода, описанным выше, спецификация НТМЬб также определя¬ 
ет механизм проверки форм, который привносит событие «іпѵаіні», возбуждае¬ 
мое в элементе формы, не прошедшем проверку. Однако производители броузе¬ 
ров, кроме Орега, не торопятся воплощать новые особенности форм и новые собы¬ 
тия, поэтому они не рассматриваются в этой книге. 

Спецификация НТМЬб включает поддержку веб-приложений, способных выпол¬ 
няться без подключения к сети (раздел 20.4), которые могут быть установлены 
локально в кэше приложений, чтобы их можно было запускать, даже когда бро¬ 
узер работает в автономном режиме (например, когда мобильное устройство на¬ 
ходится вне сети). С этой поддержкой связаны два наиболее важных события, 
«оШіпе» и «опііпе»: они генерируются в объекте Міпсіоѵѵ, когда броузер теряет или 
обретает соединение с сетью. Кроме того, определено несколько дополнительных 
событий, посредством которых приложение извещается о ходе выполнения за¬ 
грузки и обновления кэша приложений: 

сасііесі сМескіпд сіоѵѵ/піоасііпд еггог 

поіфсіаіе оЬзоІеІе ргодгезз іірсіаіегеасіу 

Событие «тевва^е» используется множеством новых АРІ веб-приложений для ор¬ 
ганизации асинхронных взаимодействий. Прикладной интерфейс взаимодейст¬ 
вий между документами (раздел 22.3) позволяет сценариям в документе с одного 
сервера обмениваться сообщениями со сценариями в документе с другого сервера. 
Это дает возможность безопасно обойти ограничения политики общего происхож¬ 
дения (раздел 13.6.2). При передаче каждого сообщения в объекте Ѵ\1іпс1см докумен¬ 
та, принимающего сообщение, генерируется событие «тевва^е». Объект события, 
передаваемый обработчику, включает свойство сіаііа, хранящее содержимое сооб¬ 
щения, а также свойства зоигсе и огідіп, идентифицирующие отправителя сооб¬ 
щения. Событие «тевва^е» используется также для взаимодействия с фоновыми 
потоками АѴеЬ ДѴогкегв (раздел 22.4) и для сетевых взаимодействий посредством 
прикладных интерфейсов, определяемых спецификациями «8егѵег-8епі Еѵепів» 
(раздел 18.3) и «ЛѴеЪ8оскеів» (раздел 22.9). 

Стандарт НТМЬб и связанные с ним спецификации определяют некоторые собы¬ 
тия, генерируемые в объектах, не являющихся окнами, документами и элемента¬ 
ми документов. Версия 2 спецификации «ХМЬНМрКециеві», а также специфика¬ 
ция «Еііе АРІ» определяют множество событий, помогающих следить за ходом вы¬ 
полнения асинхронных операций ввода/вывода. Эти события генерируются в объ¬ 
ектах ХМЬНІіІірРедиезІ: или РіІеРеасІег. Каждая операция чтения начинается с события 
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«Іоасівіагі», за которым следует последовательность событий «рго^гезв» и собы¬ 
тие «Іоасіепсі». Кроме того, каждая операция завершается событием «Іоасі», «еггог» 
или «аЪогі», генерируемым непосредственно перед заключительным событие**' 
«Іоасіепсі». Подробнее об этих событиях рассказывается в разделах 18.1.4 и 22.6.5. 

Наконец, стандарт НТМЬб и связанные с ним спецификации определяют еще 
несколько различных типов событий. Спецификация «АѴеЬ Зіога^е АРІ» (раз¬ 
дел 20.1) определяет событие «зіога^е» (генерируемое в объекте Міпсіоѵѵ), извещаю¬ 
щее об изменении хранимых данных. В спецификации НТМЬб также определе¬ 
ны события «Ье^огергіпі» и «аНегргіпі», впервые введенные компанией МісгозоН; 
в ІЕ. Как следует из их имен, эти события генерируются в окне Іл/іпйоѵѵ непосредст¬ 
венно до и после того, как документ будет напечатан, и предоставляют возмож¬ 
ность добавить или удалить содержимое, такое как дата и время печати докумен¬ 
та. (Эти события не должны использоваться для изменения представления доку¬ 
мента для печати, потому что для этой цели в С88 уже имеются директивы опре¬ 
деления типа носителя.) 

17.1.4. События, генерируемые сенсорными экранами 
и мобильными устройствами 

Широкое распространение мощных мобильных устройств, особенно устройств 
с сенсорными экранами, потребовало создания новых категорий событий. Во мно¬ 
гих случаях события от сенсорных экранов отображаются на традиционные ти¬ 
пы событий, такие как «сііск» и «зсгоІЬ. Но не все виды взаимодействий с пользо¬ 
вательским интерфейсом через сенсорный экран можно имитировать с помощью 
мыши, и не все прикосновения к такому экрану можно интерпретировать, как 
события от мыши. В этом разделе кратко описываются жесты и события прикос¬ 
новений, генерируемые броузером 8а^агі, когда он выполняется на устройствах 
іРЬопе и іРаб компании Арріе, а также рассматривается событие «огіепіаііоп- 
сЬап&е», генерируемое, когда пользователь поворачивает устройство. На момент 
написания этих строк данные события не были стандартизованы, но консорциум 
АѴЗС уже приступил к работе над спецификацией «ТоисЬ Еѵепіз ЗресШсаііоп», 
в которой за основу приняты события прикосновения, внедренные компанией 
Арріе. Эти события не описываются в справочном разделе данной книги, но до¬ 
полнительную информацию вы сможете найти на сайте Арріе Беѵеіорег Сепіег 
(Мір://сІеѵеІорег.арріе. сот/). 

Броузер 8а?агі генерирует события для жестов масштабирования и вращения из 
двух пальцев. Событие «^езіигезіагі» возбуждается, когда начинается выполне¬ 
ние жеста, а событие «^езіигеепб» по его окончании. Между этими двумя собы¬ 
тиями генерируется последовательность событий «^езіигесііап^е», позволяющих 
отслеживать выполнение жеста. Объект события, передаваемый вместе с этими 
событиями, имеет числовые свойства $са1е и гоіаііоп. Свойство зсаіе определяет 
отношение текущего и начального расстояний между двумя пальцами. Для жес¬ 
та, когда пальцы сводятся, свойство зсаіе получает значение меньше 1.0, а для 
жеста, когда пальцы разводятся, свойство зсаіе получает значение больше 1.0. 
Свойство гоііаіііоп определяет угол поворота пальцев с момента события «^езіиге- 
зіагі». Значение угла всегда является положительным и измеряется в градусах 
по часовой стрелке. 
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События жестов являются высокоуровневыми событиями, извещающими о жес¬ 
те, уже прошедшем интерпретацию. Реализовать поддержку собственных жес¬ 
тов можно с помощью обработчиков низкоуровневых событий прикосновений. 
Когда палец касается экрана, генерируется событие «іоисЬвіагі». Когда палец пе¬ 
ремещается, генерируется событие «іоисЬтоѵе». А когда палец отнимается от эк¬ 
рана, генерируется событие «іоисЬепсЬ. В отличие от событий мыши, события 
прикосновений не несут непосредственной информации о координатах прикосно¬ 
вения. Вместо этого в объекте события, который поставляется вместе с событием 
прикосновения, имеется свойство сЬапдесГГоисЬез. Это свойство хранит объект, по¬ 
добный массиву, каждый элемент которого описывает позицию прикосновения. 

Событие « огіепіаііопсЬап^ес! » генерируется в объекте Ыіпсіоѵѵ устройствами, по¬ 
зволяющими пользователям поворачивать экран для перехода из книжной ориен¬ 
тации в альбомную. Объект, передаваемый вместе с событием «огіепіаііопсЬап- 
2есЬ, не очень полезен сам по себе. Однако в мобильной версии броузера 8аІагі 
объект іл/іпсісм имеет свойство огіепіаіііоп, определяющее текущую ориентацию 
в виде числовых значений 0, 90, 180 или -90. 

17.2. Регистрация обработчиков событий 

Существует два основных способа регистрации обработчиков событий. Первый, 
появившийся на раннем этапе развития Всемирной паутины, заключается в ус¬ 
тановке свойства объекта или элемента документа, являющегося целью события. 
Второй способ, более новый и более универсальный, заключается в передаче об¬ 
работчика методу объекта или элемента. Дело осложняется тем, что каждый 
прием имеет две версии. Свойство обработчика события можно установить в про¬ 
граммном коде на языке ЛѵаЗсгірі или в элементе документа, определив соот¬ 
ветствующий атрибут непосредственно в разметке НТМЬ. Регистрация обработ¬ 
чиков вызовом метода может быть выполнена стандартным методом с именем 
ас№Еѵеп1:І_із1:епег( ), который поддерживается всеми броузерами, кроме ІЕ версии 8 
и ниже, и другим методом, с именем аНасМЕѵепіО, поддерживаемым всеми вер¬ 
сиями ІЕ до ІЕ9. 

17.2.1. Установка свойств обработчиков событий 

Самый простой способ зарегистрировать обработчик события заключается в том, 
чтобы присвоить свойству целевого объекта события желаемую функцию обра¬ 
ботчика. По соглашению свойства обработчиков событий имеют имена, состоя¬ 
щие из слова «оп», за которым следует имя события: опсііск, опсМапде, опіоасі, 
оптоизеоѵег и т. д. Обратите внимание, что эти имена свойств чувствительны к ре¬ 
гистру и в них используются только строчные символы, даже когда имя типа со¬ 
бытия состоит из нескольких слов (например «геасіувіаіесЬап^е»). Ниже приво¬ 
дятся два примера регистрации обработчиков событий: 

// Присвоить функцию свойству опіоасі объекта Міпсіоѵу/. 

// Функция - обработчик события: она вызывается, когда документ будет загружен. 

\л/іпсіо\л/. опіоасі = ГипсІіопО { 

// Отыскать элемент <Гогт> 

ѵаг еіі = с1оситеп!.деШетепі:ВуІс1("5І-)ірріпд_асІс1ге55"); 

// Зарегистрировать обработчик события, который будет вызываться 
// непосредственно перед отправкой формы. 
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еіі.опзиЬтіІ; = Гипсі:іоп() { геіигп ѵа1іс!а1:е( іііііз); } 

} 

Такой способ регистрации обработчиков событий поддерживается во всех броузе* 
рах для всех часто используемых типов событий. Вообще говоря, все прикладные 
интерфейсы, получившие широкую поддержку, которые определяют свои собы¬ 
тия, позволяют регистрировать обработчики установкой свойств обработчиков 
событий. 

Недостаток использования свойств обработчиков событий состоит в том, что они 
проектировались в предположении, что цели событий будут иметь не более одно¬ 
го обработчика для каждого типа событий. При создании библиотеки для исполь¬ 
зования в произвольных документах для регистрации обработчиков лучше ис¬ 
пользовать прием (такой как вызов метода ас№Еѵеп1:І_із1:епег()), не изменяющий 
и не затирающий ранее зарегистрированные обработчики. 


17.2.2. Установка атрибутов обработчиков событий 

Свойства обработчиков событий в элементах документа можно также устанавли¬ 
вать, определяя значения атрибутов в соответствующих НТМЬ-тегах. В этом слу¬ 
чае значение атрибута должно быть строкой программного кода на языке Лѵа- 
Зсгірі. Этот программный код должен быть не полным объявлением функции 
обработчика события, а только ее телом. То есть реализация обработчика собы¬ 
тия в разметке НТМЬ не должна заключаться в фигурные скобки и предваряться 
ключевым словом ГипсСіоп. Например: 

<Ьииоп опс1іск="а1егі:( 'Спасибо'); "МЦелкните здесь</ЬиПоп> 


Если значение НТМЬ-атрибута обработчика события состоит из нескольких ^ауа- 
бсгірі-инструкций, они должны отделяться точками с запятой либо значение ат¬ 
рибута должно располагаться в нескольких строках. 

Некоторые типы событий предназначены для броузера в целом, а не для какого- 
то конкретного элемента документа. Обработчики таких событий в языке Лѵа- 
Зсгірі регистрируются в объекте Ілііпсіоѵѵ. В разметке НТМЬ они должны поме¬ 
щаться в тег <Ьос1у>, но броузер зарегистрирует их в объекте Ілііпсіоѵѵ. Ниже приво¬ 
дится полный список таких обработчиков событий, определяемых проектом спе¬ 
цификации НТМЬб: 


опаПегргіпі: 

опЬеГогергіпІ: 

опЬеІ'огеипІоасІ 

опЫиг 

опеггог 


опГосиз 

опІіазМсМапде 

опіоасі 

оптеззаде 

опоГШпе 


опопііпе 

опрадеМісІе 

опрадезМоѵу/ 

опрорзіаіе 

опгесіо 


опгезіге 

опзіогаде 

0ПІІПСІ0 

опііпіоасі 


Когда в качестве значения атрибута обработчика события в разметке НТМЬ ука¬ 
зывается строка с программным кодом на языке ^ѵаЗсгірі, броузер преобразует 
эту строку в функцию, которая будет выглядеть примерно так: 

Гипсііоп(еѵегц) { 

\л/і1:М(с1оситеп1:) { 

мШі(*Ііі5. Гогт || {}) { 
ѵуііИ(ІИіз) { 

/* ваш программный код */ 

} 
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} 

> 

} 

Если броузер поддерживает стандарт Е85, функция определяется в нестрогом ре¬ 
жиме (раздел 5.7.3). Мы еще встретимся с аргументом еѵепі: и инструкциями ѵѵіііМ, 
когда будем рассматривать вызов обработчиков событий в разделе 17.3. 

При разработке клиентских сценариев обычно принято отделять разметку НТМЬ 
от программного кода на языке ЛѵаЗсгірі. Программисты, следующие этому пра¬ 
вилу, избегают (или, по крайней мере, стараются избегать) использовать НТМЬ- 
атрибуты обработчиков событий, чтобы не смешивать программный код на языке 
ЛѵаЗсгірі и разметку НТМЬ. 

17.2.В. ас№ЕѵепШ5Іепег() 

В стандартной модели событий, поддерживаемой всеми броузерами, кроме 1Е 
версии 8 и ниже, целью события может быть любой объект - включая объекты 
Іл/іпйсм и Ооситепі: и все объекты Еіетепііз элементов документа - определяющий 
метод с именем ас!с1Еѵепі:І_і5І:епег( ), с помощью которого можно регистрировать об¬ 
работчики событий для этой цели. Метод ас!с1Еѵеп1:І_і5І:епег() принимает три аргу¬ 
мента. Первый - тип события, для которого регистрируется обработчик. Тип 
(или имя) события должен быть строкой и не должен включать префикс «оп», ис¬ 
пользуемый при установке свойств обработчиков событий. Вторым аргументом 
методу ас!с1Еѵеп1:І_і5І:епег() передается функция, которая должна вызываться при 
возникновении события указанного типа. В последнем аргументе методу асІсІЕѵепІ:- 
І_і8Іепег() передается логическое значение. Обычно в этом аргументе передается 
значение 1"а1зе. Если передать в нем значение Іігие, функция будет зарегистриро¬ 
вана как перехватывающий обработчик и будет вызываться в другой фазе рас¬ 
пространения события. Более подробно фаза перехвата событий будет рассматри¬ 
ваться в разделе 17.3.6. Спецификация со временем может измениться так, что 
будет допустимо опускать третий аргумент вместо того, чтобы явно передавать 
в нем значение І'аізе, но на момент написания этих строк отсутствие третьего ар¬ 
гумента в некоторых текущих броузерах приводила к ошибке. 

Следующий фрагмент регистрирует два обработчика события «сііск» в элементе 
<Ьи1:1оп>. Обратите внимание на различия двух используемых приемов: 

<Ьи1:1:оп ісІ="туЬи1:1:оп ”>Щелкни на мне</Ьи1:1:оп> 

<зсгірі:> 

ѵаг Ь = сіоситепі: . де1:Е1етепі:ВуІс1( "туЬиІИіоп”); 

Ь.опсііск = ^ітсІіопО { а1егі:("Спасибо, что щелкнули на мне!"); }; 

Ь.ас!с1Еѵеп1:Іі5І:епег("сііск”, ^псііопО { а1ег*("Еще раз спасибо!"); }, Шзе); 

</зсгір*> 

Вызов метода асісіЕѵепі:І_із1епег() со строкой «сііск» в первом аргументе никак не 
влияет на значение свойства опсііск. Во фрагменте, приведенном выше, щелчок на 
кнопке приведет к выводу двух диалогов а1ег1( ). Но важнее то, что метод асІсІЕѵепІ- 
ИзІепегО можно вызвать несколько раз и зарегистрировать с его помощью не¬ 
сколько функций-обработчиков для одного и того же типа события в том же самом 
объекте. При появлении события в объекте будут вызваны все обработчики, заре¬ 
гистрированные для этого типа события, в порядке их регистрации. Многократ¬ 
ный вызов метода ас!с1ЕѵепШ.5Іепег( ) для одного и того же объекта с теми же самы- 
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ми аргументами не дает никакого эффекта - функция-обработчик регистрируется 
только один раз и повторные вызовы не влияют на порядок вызова обработчиков. 

Парным к методу асісіЕѵепі:1_і5І:епег() является метод гетоѵеЕѵепі:1_і5І:епег(), который 
принимает те же три аргумента, но не добавляет, а удаляет функцию-обработчик из 
объекта. Это часто бывает удобно, когда необходимо зарегистрировать временный 
обработчик события, а затем удалить его в какой-то момент. Например, при полу¬ 
чении события «тоизес1о\ѵп» может потребоваться зарегистрировать временный 
перехватывающий обработчик событий «тоизетоѵе» и «тоивеир», чтобы можно 
было наблюдать за тем, как пользователь выполняет буксировку объектов мышью, 
а по событию «тоивеир» эти обработчики могут удаляться. В такой ситуации реа¬ 
лизация удаления обработчиков событий может иметь вид, как показано ниже: 

сіоситепі:. гетоѵеЕѵепГІлзіепегС'тоизетоѵе", ГіапсІІеМоизеМоѵе, Ггие); 
сіоситепі:. гетоѵеЕѵепГІлзГепегС’тоизеир", ЬапсНеМоизеІІр, Ггие); 

17.2.4. аиасНЕѵепІ() 

Іпіегпеі Ехріогег версии ниже ІЕ9 не поддерживает методы ас!с 1 Еѵепі: 1 _і 5 І:епег() 
и гетоѵеЕѵеп1:1_і5І:егіег(). В версии ІЕ5 и выше определены похожие методы, аГГасИ- 
ЕѵептО и с!е1;асЬЕѵепі;(). 

По своему действию методы аНасНЕѵегѵЦ) и с!е1:асИЕѵепі;() похожи на методы асісі- 
Еѵепі:1_і5І:епег() и гетоѵеЕѵепі:1_і5І:епег() со следующими исключениями: 

• Поскольку модель событий в ІЕ не поддерживает фазу перехвата, методы аТ- 
ГасИЕѵепі:() и с!е1;асГіЕѵеп1;() принимают только два аргумента: тип события 
и функцию обработчика. 

• В первом аргументе методам в ІЕ передается имя свойства обработчика с пре¬ 
фиксом «оп», а не тип события без этого префикса. Например, методу аГГасИ- 
Еѵепі;( ) должно передаваться имя «опсііск», тогда как методу ас!с1Еѵеп1:1_і5І:епег( ) 
должно передаваться имя «сііск». 

• Метод аГГасГіЕѵепііО позволяет зарегистрировать одну и ту же функцию обра¬ 
ботчика несколько раз. При возникновении события указанного типа зареги¬ 
стрированная функция будет вызвана столько раз, сколько раз она была заре¬ 
гистрирована. 

Ниже показано, как обычно выполняется регистрация обработчика с помощью 
метода асІсІЕѵепШ.з'ГепегО в броузерах, поддерживающих его, и с помощью метода 
аТТасНЕѵепТ() в других броузерах: 

ѵаг Ь = сіоситепі:.деіЕІетепІВуІсІС'туЬиПоп"); 
ѵаг Иапсііег = ГипсГіоп() { а1егГ( "Спасибо!"); }; 

ІГ (Ь.асІсІЕѵепШзІепег) 

Ь.ас!с1Еѵеп1:І_і5І:епег("сііск", Иапсііег. ^аізе); 
еізе ІГ (Ь. аПасЬЕѵепІ:) 

Ь.аГГасЬЕѵепК"опсііск", Иапсііег); 

17.3. Вызов обработчиков событий 

После регистрации обработчика событий веб-броузер будет вызывать его автома¬ 
тически, когда в указанном объекте будет возникать событие указанного типа. 
В этом разделе подробно описывается порядок вызова обработчиков событий, ар- 
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гументы обработчиков, контекст вызова (значение 1:Ыз), область видимости и на¬ 
значение возвращаемого значения обработчика. К сожалению, некоторые из этих 
подробностей отличаются между ІЕ версии 8 и ниже и другими броузерами. * 

Кроме того, с целью описать, как вызываются отдельные обработчики событий, 
в этом разделе также разъясняется, как происходит распространение событий: 
как единственное событие может привести к вызову нескольких обработчиков 
в оригинальном целевом объекте и в содержащих его элементах документа. 

17.3.1. Аргумент обработчика событий 

При вызове обработчика событий ему обычно (за одним исключением, о котором 
рассказывается ниже) передается объект события в виде единственного аргумен¬ 
та. Свойства объекта события содержат дополнительную информацию о событии. 
Свойство 1;уре, например, определяет тип возникшего события. В разделе 17.1 упо¬ 
миналось множество других свойств объекта события для различных типов со¬ 
бытий. 

В ІЕ версии 8 и ниже обработчикам событий, зарегистрированным установкой 
свойства, объект события при вызове не передается. Вместо этого объект события 
сохраняется в глобальной переменной міпсісм. еѵепі;. Для переносимости обработ¬ 
чики событий можно оформлять, как показано ниже, чтобы они использовали 
переменную міпсісм. еѵепі; при вызове без аргумента: 

^цпсііоп ЬапсІ1ег(еѵеп1:) { 

еѵепі: = еѵепі || міпсісм. еѵепі; 

// Здесь находится реализация обработчика 

} 

Объект события передается обработчикам событий, зарегистрированным с помо¬ 
щью метода аііас^ЕѵепіО, но они также могут использовать переменную міпсісм. 
еѵепі. 

В разделе 17.2.2 говорилось, что при регистрации обработчика события посредст¬ 
вом НТМЬ-атрибута броузер преобразует строку с программным кодом на языке 
ЛѵаЗсгірІ в функцию. Броузеры, отличные от ІЕ, создают функцию с единствен¬ 
ным аргументом еѵепі;. В ІЕ создается функция, не принимающая аргументов. 
Если в таких функциях использовать идентификатор еѵепі;, он будет ссылаться 
на міпсісм. еѵепі;. В любом случае обработчики событий, определяемые в разметке 
НТМЬ, могут ссылаться на объект события, используя идентификатор еѵепі;. 

17.3.2. Контекст обработчиков событий 

Когда обработчик событий регистрируется установкой свойства, это выглядит 
как определение нового метода элемента документа: 

е.опсііск = ІцпсІіопО { /* реализация обработчика */ }; 

Поэтому нет ничего удивительного, что обработчики событий вызываются (с од¬ 
ним исключением, касающимся ІЕ, которое описывается ниже) как методы объ¬ 
ектов, в которых они определены. То есть в теле обработчика событий ключевое 
слово 1;Ыз ссылается на цель события. 

В обработчиках ключевое слово Ііііз ссылается на целевой объект, даже когда они 
были зарегистрированы с помощью метода ас)сІЕѵепіІ_і 5 Іепег(). Однако, к сожале- 
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нию, это не относится к методу аі*асІіЕѵепі(): обработчики, зарегистрированные 
с помощью метода а11:асНЕѵепі:(), вызываются как функции, и в них ключевое сло¬ 
во 1;Ыз ссылается на глобальный (Іл/іпсісм) объект. Эту проблему можно решить 
следующим способом: 

Л 

* Регистрирует указанную функцию как обработчик событий указанного типа в указанном 

* объекте. Гарантирует, что обработчик всегда будет вызываться как метод целевого объекта. 

*/ 

Гцпсііоп асШЕѵепКіагдеІ:, Іуре, ЬапсІІег) { 

ІГ (ІагдеІ.асІсІЕѵепІІлзІепег) 

Іагде1.асІс1Еѵеп1:І_і5І:епег(і:уре. Ьапсііег, Гаізе); 

еізе 

ІагдеІ.аПасЬЕѵеггЕС'оп" + іуре, 

Гцпс1:іоп(еѵеп1:) { 

// Вызвать обработчик как метод цели, 

// и передать ему объект события 
геіцгп ЬапсІІег.са11(ІагдеІ, еѵепі); 


Обратите внимание, что обработчики событий, зарегистрированные таким спосо¬ 
бом, нельзя удалить, потому что ссылка на функцию-обертку, передаваемую ме¬ 
тоду аИасИЕѵеп*(), нигде не сохраняется, чтобы ее можно было передать методу 
сіе1:асГіЕѵеп1:(). 

17.3.3. Область видимости обработчика событий 

Подобно всем функциям в языке ЛаѵаЗсгірі, обработчики событий имеют лекси¬ 
ческую область видимости. Они выполняются в той области видимости, в какой 
были определены, а не в той, где они были вызваны, и имеют доступ ко всем ло¬ 
кальным переменным в этой области видимости. (Это, например, демонстрирует¬ 
ся в функции ас№Еѵепі:(), представленной выше.) 

Особый случай представляют обработчики событий, которые регистрируются по¬ 
средством НТМЬ-атрибутов. Они преобразуются в функции верхнего уровня, кото¬ 
рые не имеют доступа ни к каким локальным переменным - только к глобальным. 
Но по историческим причинам они выполняются в модифицированной цепочке об¬ 
ластей видимости. Обработчики событий, определяемые посредством НТМЬ-атри- 
бутов, могут использовать свойства целевого объекта, объемлющего элемента 
<Гогт> (если таковой имеется) и объекта Ооситепі:, как если бы они были локальны¬ 
ми переменными. В разделе 17.2.2 было показано, как из НТМЬ-атрибута созда¬ 
ется функция обработчика события, программный код в которой использует це¬ 
почку областей видимости, модифицированную с помощью инструкций мШ. 

НТМЬ-атрибуты плохо подходят для включения длинных строк программного 
кода, и такая модифицированная цепочка областей видимости помогает сокра¬ 
тить его. Она позволяет использовать ІіадМате вместо Шз.1:адМате, де1:Е1етепі:ВуІсі 
вместо гіоситеп1:.де1:Е1етепі:ВуІсі, а в обработчиках, привязанных к элементам доку¬ 
мента внутри элемента <Гогт>, можно ссылаться на другие элементы формы по 
значению атрибута Ій, используя, например, имя гірсосіе вместо ІіИіз.Гогт.іірсосІе. 

С другой стороны, модифицированная цепочка областей видимости обработчика 
событий, определяемого с помощью НТМЬ-атрибута, может стать источником 
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ошибок, потому что свойства всех объектов в цепочке видимости скрывают одно¬ 
именные свойства глобального объекта. Например, объект Ооситепі: определяет 
(редко используемый) метод ореп(), поэтому если обработчику событий, созданно¬ 
му с помощью НТМЬ-атрибута, потребуется вызвать метод ореп() объекта Міп Ром, он 
вынужден будет явно вызывать его как міпРом.ореп(), вместо ореп(). Аналогичная 
(но более пагубная) проблема наблюдается при работе с формами, потому что имена 
и значения атрибутов іб элементов формы определяют свойства во вмещающем 
элементе формы (раздел 15.9.1). То есть если, к примеру, форма содержит элемент 
со значением «Іосаііоп» атрибута ІР, все обработчики событий, созданные внутри 
этой формы с помощью НТМЬ-атрибутов, должны будут использовать міпРом.Іо- 
саі:іоп вместо Іосаііоп, если им потребуется сослаться на объект І_оса1:іоп окна. 

17.3.4. Возвращаемые значения обработчиков 

Значение, возвращаемое обработчиком события, зарегистрированным установ¬ 
кой свойства объекта или с помощью НТМЬ-атрибута, следует учитывать. Обыч¬ 
но возвращаемое значение І'аізе сообщает броузеру, что он не должен выполнять 
действия, предусмотренные для этого события по умолчанию. Например, обра¬ 
ботчик опсііск кнопки отправки формы может вернуть ^аізе, чтобы предотвра¬ 
тить отправку формы броузером. (Это может пригодиться, если ввод пользовате¬ 
ля не прошел проверку на стороне клиента.) Аналогично обработчик события 
опкеургезз поля ввода может фильтровать ввод с клавиатуры, возвращая "Гаізе 
при вводе недопустимых символов. (Пример 17.6 фильтрует ввод с клавиатуры 
именно таким способом.) 

Также важно значение, возвращаемое обработчиком опЬеІ'огеипІоасі объекта Міп- 
сіом. Это событие генерируется, когда броузер выполняет переход на другую стра¬ 
ницу. Если этот обработчик вернет строку, она будет выведена в модальном диало¬ 
ге, предлагающем пользователю подтвердить свое желание покинуть страницу. 

Важно понимать, что учитываются значения, возвращаемые обработчиками 
событий, только если обработчики зарегистрированы посредством установки 
свойств. Далее мы увидим, что обработчики, зарегистрированные с помощью асісі- 
Еѵепі:1_і5І:епег() или аііасІіЕѵеп*() вместо этого должны вызывать метод ргеѵепі;- 
Эе1 = аи11:() или устанавливать свойство ге1:игпѴа1ие объекта события. 

17.3.5. Порядок вызова 

Для элемента документа или другого объекта можно зарегистрировать более од¬ 
ного обработчика одного и того же типа события. При возникновении этого собы¬ 
тия броузер вызовет все обработчики в порядке, определяемом следующими пра¬ 
вилами: 

• В первую очередь вызываются обработчики, зарегистрированные установкой 
свойства объекта или с помощью НТМЬ-атрибута, если таковые имеются. 

• Затем вызываются обработчики, зарегистрированные с помощью метода асісі- 
Еѵепі:І_і5І:епег(), в порядке их регистрации. 1 


1 Стандарт «БОМ Ьеѵеі 2» не определяет порядок вызова обработчиков, но все текущие 
броузеры вызывают обработчики в порядке их регистрации, а текущий проект стан¬ 
дарта «БОМ Ьеѵеі 3» определяет именно такой порядок вызова. 
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• Обработчики, зарегистрированные с помощью метода а**асІіЕѵеп*(), могут вы¬ 
зываться в произвольном порядке, поэтому ваши сценарии не должны пола¬ 
гаться на какой-то определенный порядок. 

17.3.6. Распространение событий 

Когда целью события является объект ілііпсіом или какой-то другой самостоятель¬ 
ный объект (такой как ХМЫНІііірВедиезі:), броузер откликается на событие простым 
вызовом соответствующего обработчика в этом объекте. Однако когда целью со¬ 
бытия является объект Ооситепі; или элемент Еіетепі документа, ситуация не¬ 
сколько осложняется. 

После вызова обработчиков событий, зарегистрированных в целевом элементе, 
большинство событий «всплывают» вверх по дереву БОМ. В результате вызыва¬ 
ются обработчики в родителе целевого элемента. Затем вызываются обработчи¬ 
ки, зарегистрированные в родителе родителя целевого элемента. Так продолжа¬ 
ется, пока не будет достигнут объект Ооситепі; и затем объект Іл/іпсіом. Способность 
событий всплывать обеспечивает возможность реализации альтернативы множе¬ 
ству обработчиков, зарегистрированных в отдельных элементах документа: мож¬ 
но зарегистрировать единственный обработчик в общем элементе-предке и обра¬ 
батывать события в нем. Например, вместо того чтобы регистрировать обработ¬ 
чик события «сЬап&е» в каждом элементе формы, его можно зарегистрировать 
в единственном элементе <Гогт>. 

Способностью всплывать обладает большинство событий, возникающих в эле¬ 
ментах документа. Заметным исключением являются события «Іосив», «Ыиг» 
и «всгоИ». Событие «ІоасЬ, возникающее в элементах, также всплывает, но оно 
прекращает всплывать в объекте Ооситепі; и не достигает объекта Іл/іпсіом. Событие 
«ІоасЬ в объекте ілііпсіоѵі/ возбуждается, только когда будет загружен весь документ. 

Всплытие - это третья «фаза» распространения события. Вызов обработчика со¬ 
бытия в целевом объекте - это вторая фаза. Первая фаза протекает еще до вызова 
обработчиков целевого объекта и называется фазой «перехвата». Напомню, что 
метод ас!(1Еѵепі;І_і5І;епег( ) имеет третий аргумент, в котором принимает логическое 
значение. Если передать в этом аргументе значение Ігие, обработчик события бу¬ 
дет зарегистрирован как перехватывающий обработчик для вызова в первой фазе 
распространения события. Фаза всплытия событий реализована во всех броузе¬ 
рах, включая ІЕ, и в ней участвуют все обработчики, независимо от того, как они 
были зарегистрированы (если только они не были зарегистрированы как пере¬ 
хватывающие обработчики). В фазе перехвата, напротив, участвуют только обра¬ 
ботчики, зарегистрированные с помощью метода ас!с1Еѵеп1;1_і$1;епег( ), когда в треть¬ 
ем аргументе ему было передано значение Ігие. Это означает, что фаза перехвата 
событий недоступна в ІЕ версии 8 и ниже, и на момент написания этих строк име¬ 
ла ограничения в использовании. 

Фаза перехвата напоминает фазу всплытия, только событие распространяется 
в обратном направлении. В первую очередь вызываются перехватывающие обра¬ 
ботчики объекта Ілііпсіом, затем вызываются перехватывающие обработчики объ¬ 
екта Ооситепі;, затем обработчики объекта Ьосіу и так далее, вниз по дереву БОМ, 
пока не будут вызваны перехватывающие обработчики родителя целевого объек¬ 
та. Перехватывающие обработчики, зарегистрированные в самом целевом объек¬ 
те, не вызываются. 
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Наличие фазы перехвата позволяет обнаруживать события еще до того, как они 
достигнут своей цели. Перехватывающий обработчик может использоваться для 
отладки или для фильтрации событий, чтобы в комплексе с приемом отмены со¬ 
бытия, описываемом ниже, предотвратить вызов обработчиков в целевом объек¬ 
те. Одной из типичных областей применения фазы перехвата является реализа¬ 
ция буксировки элементов мышью, когда событие перемещения указателя мыши 
должен обрабатывать буксируемый объект, а не документ, в пределах которого 
осуществляется буксировка. Пример реализации приводится в примере 17.2. 

17.3.7. Отмена событий 

В разделе 17.3.4 говорилось, что значение, возвращаемое обработчиком события, 
зарегистрированным как свойство, можно использовать для отмены действий, вы¬ 
полняемых броузером по умолчанию в случае этого события. В броузерах, поддер¬ 
живающих метод айсіЕѵепІІ_і 5 Іепег(), отменить выполнение действий по умолча¬ 
нию можно также вызовом метода ргеѵепЮе'РаиІіО объекта события. Однако в ІЕ, 
версии 8 и ниже, тот же эффект достигается установкой свойства геІигпѴаІие объек¬ 
та события в значение І'аізе. В следующем фрагменте демонстрируется обработчик 
вымышленного события, который использует все три способа отмены события: 

Іііпсііоп сапсеІНапсЯег(еѵепІ) { 

ѵаг еѵепі = еѵепі || ѵ\/іпсіоѵ\/. еѵепі; // Для ІЕ 

/* Здесь выполняется обработка события */ 

// Теперь отменить действие по умолчанию, связанное с событием 

іі (еѵепі:.ргеѵепЮеІаіЛІ) еѵепі.ргеѵепЮеІаіЛК); // Стандартный прием 

іі (еѵепі. геІьгпѴаІие) еѵепі. геІіігпѴаІііе = Іаізе; // ІЕ 

геііігп Іаізе; // Для обработчиков, зарегистрированных как свойства 

} 

Текущий проект модуля «БОМ Еѵепів» определяет в объекте Еѵепі свойство с име¬ 
нем (ІеТаиІіРгеѵепіесІ. Оно пока поддерживается не всеми броузерами, но суть его 
в том, что при обычных условиях оно имеет значение Таізе и принимает значение 
Ігие только в случае вызова метода ргеѵепЮеТаи11( ).* 

Отмена действий, по умолчанию связанных с событием, - это лишь одна из раз¬ 
новидностей отмены события. Имеется также возможность остановить распро¬ 
странение события. В броузерах, поддерживающих метод асЮЕѵепІІ_і 5 Іепег(), объ¬ 
ект события имеет метод 5ІорРгорадаІіоп( ), вызов которого прерывает дальнейшее 
распространение события. Если в том же целевом объекте будут зарегистрирова¬ 
ны другие обработчики этого события, то остальные обработчики все равно будут 
вызваны, но никакие другие обработчики событий в других объекта не будут вы¬ 
званы после вызова метода зіорРгорадаііоп(). Метод зІорРгорадаііоп() можно вы¬ 
звать в любой момент в ходе распространения события. Он действует и в фазе пе¬ 
рехвата, и в вызове обработчика целевого объекта, и в фазе всплытия. 

В ІЕ версии 8 и ниже метод 5 ІорРгорадаІіоп() не поддерживается. Вместо этого 
объект события в ІЕ имеет свойство сапсеІВііЬЫе. Установка этого свойства в зна¬ 
чение Ігие предотвращает распространение события. (В ІЕ версии 8 и ниже фаза 


1 Объект события, определяемый в библиотеке іСіиегу (глава 19), вместо свойства имеет 
метод РеІаііНРгеѵепІесК ). 
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перехвата не поддерживается, поэтому отменить событие можно только в фазе 
всплытия.) 

Текущий проект спецификации «БОМ Еѵепіз» определяет в объекте Еѵепі: еще 
один метод - метод с именем 5І:орІттесііа1:еРгорадаі:іоп( ). Подобно методу зІорРгора- 
даі:іоп(), он предотвращает распространение события по любым другим объек¬ 
там. Но кроме того, он также предотвращает вызов любых других обработчиков 
событий, зарегистрированных в том же объекте. На момент написания этих 
строк метод 5І:орІттеРіа1:еРгорадаі:іоп( ) поддерживался не во всех броузерах. Неко¬ 
торые библиотеки, такие как і(}иегу и УТЛ, определяют свою, переносимую, вер¬ 
сию метода 5І:орІттес1іа1:еРгорадаі:іоп(). 

17.4. События загрузки документа 

Теперь, когда мы познакомились с основами обработки событий в языке Лѵа- 
Зсгірі, можно приступать к изучению подробностей, касающихся отдельных ка¬ 
тегорий событий. В этом разделе мы начнем с событий, возникающих при загруз¬ 
ке документа. 

Большинству веб-приложений совершенно необходимо, чтобы веб-броузер изве¬ 
щал их о моменте, когда закончится загрузка документа и он будет готов для вы¬ 
полнения операций над ним. Этой цели служит событие «ІоасЬ в объекте Іл/іпсісм, 
и оно уже подробно обсуждалось в главе 13, где в примере 13.5 была представлена 
реализация вспомогательной функции опІ_оасЦ). Событие «ІоасЬ возбуждается 
только после того, как документ и все его изображения будут полностью загруже¬ 
ны. Однако обычно сценарии можно запускать сразу после синтаксического ана¬ 
лиза документа, до того как будут загружены изображения. Можно существенно 
сократить время запуска веб-приложения, если начинать выполнение сценариев 
по событиям, отличным от «ІоасЬ. 

Событие «БОМСопІепІЬоасІесЬ возбуждается, как только документ будет загру¬ 
жен, разобран синтаксическим анализатором, и будут выполнены все отложен¬ 
ные сценарии. К этому моменту изображения и сценарии с атрибутом азупс могут 
продолжать загружаться, но сам документ уже будет готов к выполнению опера¬ 
ций. (Отложенные и асинхронные сценарии обсуждались в разделе 13.3.1.) Это 
событие впервые было введено в Еіге&эх и впоследствии заимствовано всеми дру¬ 
гими производителями броузеров, включая корпорацию МісговоЙ, которая доба¬ 
вила поддержку этого события в ІЕ9. Несмотря на приставку «БОМ» в имени, это 
событие не является частью стандарта модели событий «БОМ Ьеѵеі 3 Еѵепів», но 
оно стандартизовано спецификацией НТМЬб. 

Как описывалось в разделе 13.3.4, в ходе загрузки документа изменяется значе¬ 
ние свойства сіоситепі:. геас!уЗі:аі:е. Каждое изменение значения этого свойства в ІЕ 
сопровождается событием «геасІувІаІесЬапзе» в объекте Ооситепі:, благодаря чему 
в ІЕ это событие можно использовать для определения момента появления со¬ 
стояния «сотріеіе». Спецификация НТМЬб стандартизует событие «геасіувіаіе- 
сЬап&е», но предписывает возбуждать его непосредственно перед событием «ІоасЬ, 
поэтому не совсем понятно, в чем заключается преимущество события «геасіувіа- 
іесЬап^е» перед «ІоасЬ. 

В примере 17.1 определяется функция \л/ИепВеас!у(), близко напоминающая функ¬ 
цию опІ_оасК) из примера 13.5. Функция, передаваемая функции мИепРеайуО, вы- 
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зывается (как метод объекта Ооситепі:) сразу, как только документ будет готов 
к выполнению операций. В отличие от ранее представленной функции опІ_оас!(), 
мИепПеасІуО ожидает появления событий «БОМСопІепіЬоасІегі» и «геасІузІаіесЬап- 
&е» и использует событие «Іоасі» только как запасной вариант, на случай если она 
будет задействована в старых броузерах, не поддерживающих первые два собы¬ 
тия. Функция ѵ^епРеасІуО будет использоваться в некоторых сценариях, следую¬ 
щих далее (в этой и в других главах). 

Пример 17.1. Вызов функций, когда документ будет готов к выполнению операций 

/* 

* Передайте функции ѵЛіепНеас!у( ) свою функцию, и она вызовет ее (как метод 

* объекта документа), как только завершится синтаксический анализ документа 

* и он будет готов к выполнению операций. Зарегистрированные функции 

* вызываются при первом же событии ООМСопІепНоасІесІ, геасіузіаіесііапде или Іоасі. 

* Как только документ станет готов и будут вызваны все функции, 

* \л/ИепРеас1у() немедленно вызовет все функции, которые были ей переданы. 

*/ 

ѵаг ѵЛіепНеасІу = (ГцпсІіопО { // Эта функция возвращается функцией ѵЛіепНеас!у( ) 

ѵаг Гцпсз = []; // Функции, которые должны вызываться по событию 

ѵаг геасіу = Гаізе; // Получит значение Ігце при вызове функции Ьапсііег 

// Обработчик событий, который вызывается, как только документ 
// будет готов к выполнению операций 
Гцпсііоп ЬапсІІег(е) { 

// Если обработчик уже вызывался, просто вернуть управление 
ІГ (геасіу) геіцгп; 

// Если это событие геасІузіаГесЬапде и состояние получило значение, 

// отличное от "сотріеіе", значит, документ пока не готов 
ІГ (е. 1:уре===" геасІузІаІесЬапде" && сіосшпепі: . геасІуЗіаІе !== "сотріеіе") 
геіцгп; 

// Вызвать все зарегистрированные функции. 

// Обратите внимание, что здесь каждый раз проверяется значение 
// свойства Гцпсз.ІепдІЬ, на случай если одна из вызванных функций 
// зарегистрирует дополнительные функции. 

Гог(ѵаг і = 0; і < Гцпсз. ІепдІЬ; і++) 

Гцпсз[і].са11(с1оситеп1:); 

// Теперь можно установить флаг геасіу в значение Ігііе и забыть 
// о зарегистрированных функциях 
геасіу = Ігце; 

Гцпсз = пцП; 

} 

// Зарегистрировать обработчик Ьапсііег для всех ожидаемых событий 
іГ (сІосцтепІ.асІсІЕѵепІІлзГепег) { 

с!осцтеп1:.ас1с1Еѵеп1:І_і5І:епег(”00МСоп1:еп1:І_оас1есГ, Ьапсііег, Гаізе); 
сіосіітепі:.ас!с1Еѵеп1:І_і5І:епег(" геайузТаГесПапде” , Ьапсііег, Гаізе); 
ѵу/іпсіоѵѵ. асІсІЕѵепНізІепег("Іоасі", Ьапсііег, Гаізе); 

> 

еізе іГ (сіосьтепі:.аПасЬЕѵепІ:) { 

сіосцтепі:.аиасЬЕѵеп1:( "опгеайузГаГесЬапде" , Ьапсііег); 
ѵѵіпсіохѵ. а1:1:асИЕѵеп1:( ’опіоасі”, Ьапсііег); 


} 
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// Вернуть функцию ѵѵЬепВеасІу 
геііігп ^цпсііоп ѵЛіепВеасМО { 

і? (геасіу) саІИсІосцшепІ:); // Вызвать функцию, если документ готов • 
еізе ^цпсз.рцзЬ(Г); // Иначе добавить ее в очередь, 

} // чтобы вызвать позже. 

}()): 

17.5. События мыши 

С мышью связано довольно много событий. Все они перечислены в табл. 17.1. Все 
события мыши, кроме «тоивеепіег» и «тоивеіеаѵе», всплывают. Для событий 
«сііск», возникающих в ссылках и кнопках отправки форм, предусматриваются 
действия по умолчанию, которые можно отменить. Теоретически имеется воз¬ 
можность отменить событие «сопіехітепи» и предотвратить появление контекст¬ 
ного меню, но некоторые броузеры имеют параметры настройки, которые делают 
это событие неотменяемым. 

Таблица 17.1. События мыши 

Тип _ Описание _ 

сііск Высокоуровневое событие, возбуждаемое, когда пользователь нажимает 

и отпускает кнопку мыши или иным образом «активирует» элемент. 

сопіехітепц Отменяемое событие, возбуждаемое перед выводом контекстного меню. Теку¬ 
щие броузеры выводят контекстное меню по щелчку правой кнопки мыши, 
поэтому данное событие можно также использовать как событие «сііск». 

йЫсІіск Возбуждается, когда пользователь выполняет двойной щелчок. 

тоцзесіомп Возбуждается, когда пользователь нажимает кнопку мыши. 

тоіізецр Возбуждается, когда пользователь отпускает кнопку мыши. 

тоцзетоѵе Возбуждается, когда пользователь перемещает указатель мыши. 

тоцзеоѵег Возбуждается, когда указатель мыши помещается над элементом. Свойство 
геІаіесІТагдеІ: (или ГготЕІетепІ: в ІЕ) определяет элемент, с которого был пере¬ 
мещен указатель мыши. 

тоцзеоці: Возбуждается, когда указатель мыши покидает элемент. Свойство геіаіесі- 

Тагдеі (или ІоЕІетепІ: в ІЕ) определяет элемент, на который был перемещен 
указатель мыши. 

тоцзеепіег Подобно «тоизеоѵег», но не всплывает. Впервые появилось в ІЕ и было стан¬ 
дартизовано в НТМЬб, но пока поддерживается не всеми броузерами. 

тоцзеіеаѵе Подобно «тоизеоиі», но не всплывает. Впервые появилось в ІЕ и было стан¬ 
дартизовано в НТМЬб, но пока поддерживается не всеми броузерами. 

Объект, передаваемый обработчикам событий от мыши, имеет свойства сІіепІіХ 
и сНепІУ, определяющие координаты указателя относительно окна. Чтобы преоб¬ 
разовать их в координаты документа, к ним необходимо добавить позиции полос 
прокрутки окна (как показано в примере 15.8). 

Свойства аІІКеу, сШКеу, теіаКеу и зЫГііКеу определяют состояния различных кла¬ 
виш-модификаторов, которые могли удерживаться в нажатом состоянии в мо¬ 
мент события: с их помощью можно отличать простой щелчок от щелчка с нажа¬ 
той клавишей 5МП, например. 




17.5. События мыши 


501 


Свойство Ьиііііоп определяет, какая кнопка мыши удерживалась в нажатом со¬ 
стоянии в момент события. Однако разные броузеры записывают в это свойство 
разные значения, поэтому его сложно использовать переносимым способом. Под¬ 
робности смотрите в справочной статье Еѵепі: в четвертой части книги. Некоторые 
броузеры возбуждают событие «сііск» только в случае щелчка левой кнопкой. 
Поэтому, если потребуется обрабатывать щелчки другими кнопками, следует ис¬ 
пользовать события «тоивесіодѵп» и «тоивеир». Событие «сопіехітепи» обычно 
сигнализирует о том, что был выполнен щелчок правой кнопкой, но, как отмеча¬ 
лось выше, в обработчиках этого события не всегда бывает возможным предот¬ 
вратить появление контекстного меню. 

Объект события, передаваемый вместе с событием мыши, имеет еще пять харак¬ 
терных свойств, но они используются значительно реже, чем вышеперечислен¬ 
ные. Полный их перечень вы найдете в справочной статье Еѵепі; в четвертой части 
книги. 

В примере 17.2 демонстрируется функция с!гад(), которая при вызове из обработ¬ 
чика события «тоивесіодѵп» позволяет пользователю буксировать мышью абсо¬ 
лютно позиционированные элементы документа. Функция с!гад( ) работает с обеи¬ 
ми моделями событий, БОМ и ІБ. 

Функция с1гад() принимает два аргумента. Первый - буксируемый элемент. Это 
может быть элемент, в котором возникло событие «тоивесіодѵп», и содержащий его 
элемент (например, можно дать пользователю возможность ухватить мышью эле¬ 
мент, который выглядит как заголовок окна, и буксировать содержащий его эле¬ 
мент, который выглядит как окно). Однако в любом случае это должен быть эле¬ 
мент документа, абсолютно позиционированный с помощью С88-атрибута розі- 
Іііоп. Второй аргумент - объект события, полученный с событием «тоивескиѵп». 
Ниже приводится простой пример использования функции Ргад(). В нем опреде¬ 
ляется элемент <ітд>, который пользователь может двигать мышью при нажатой 
клавише БЫЛ: 

<ітд згс=”с1гаддаЫе.діГ' 

8І:у1е="розі1:іоп:аЬзо1іі1:е; Іеіі : ЮОрх; Іор:100рх;" 

оптоизес!о\ѵп="і1 : (еѵепі:. зМИКеу) сІгадЛМз, еѵепі); "> 

Функция с!гад( ) преобразует координаты события «тоивесіодѵп» в координаты до¬ 
кумента, чтобы определить расстояние от указателя мыши до верхнего левого уг¬ 
ла буксируемого элемента. При этом она использует вспомогательную функцию 
деіЗсгоПО^зеІзО из примера 15.8. Затем функция с!гад() регистрирует обработ¬ 
чики событий «тоиветоѵе» и «тоивеир», которые последуют за событием «тои- 
зесіолѵп». Обработчик события «тоиветоѵе» отвечает за перемещение элемента 
документа, а обработчик события «тоивеир» - за удаление себя и обработчика со¬ 
бытия «тоизетоѵе». 

Важно отметить, что обработчики событий «тоиветоѵе» и «тоивеир» регистри¬ 
руются как перехватывающие обработчики. Это обусловлено тем, что пользова¬ 
тель может перемещать мышь быстрее, чем сможет перемещаться элемент доку¬ 
мента, в результате чего некоторые события «тоиветоѵе» могут возникать за 
пределами буксируемого элемента. В фазе всплытия эти события просто не будут 
передаваться нужным обработчикам. В отличие от стандартной модели модель 
событий, реализованная в ІБ, не поддерживает фазу перехвата, но она поддержи¬ 
вает специализированный метод зе1:Сар1:иге( ), позволяющий перехватывать собы- 
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тия мыши в подобных случаях. Пример наглядно демонстрирует, как действует 
этот метод. 

Наконец, обратите внимание, что функции тоѵеНапР1ег() и іірНапс11ег() определены 
внутри функции с!гад(). Благодаря тому, что они определены во вложенной облас¬ 
ти видимости, эти функции могут пользоваться аргументами и локальными пе¬ 
ременными функции с!гад(), что существенно упрощает их реализацию. 

Пример 17.2. Буксировка элементов документа 
/** 

* йгад.^з: буксировка абсолютно позиционированных НТМ1_-элементов. 

* 

* Этот модуль определяет единственную функцию сІгадО, которая должна вызываться 

* из обработчика события оптоцзеРомп. Последующие события тоіізетоѵе будут вызывать 

* перемещение указанного элемента. Событие тоіізеіір будет завершать буксировку. 

* Эта реализация действует в обеих моделях событий, стандартной и ІЕ. 

* Использует функцию деі3сго110^^зеіз( ), представленную выше в книге. 

* 

* Аргументы: 

* 

* еІетепТТойгад : элемент, принявший событие тоіізеРоѵ/п или содержащий его элемент. 

* Этот элемент должен иметь абсолютное позиционирование. Значения его свойств зТуІе.ІеГ* 

* и 5*у1е.*ор будут изменяться при перемещении указателя мыши пользователем. 

* 

* еѵепі:: объект Еѵепі:, полученный обработчиком события тоіізеРомп. 

Гітс1:іоп Ргад(е1етепі:То0гад, еѵепі:) { 

// Преобразовать начальные координаты указателя мыши в координаты документа 
ѵаг зсгоП = де1:Зсго110ГГзе1:з(): // Вспомогательная функция, объявленная 

// где-то в другом месте 
ѵаг зТагТХ = еѵепі:.сІіепТХ + зсгоП. х; 
ѵаг зіагТУ = еѵепі:.сІіепТУ + зсгоП. у: 

// Первоначальные координаты (относительно начала документа) элемента, который 
// будет перемещаться. Так как еІетепіТоОгад имеет абсолютное позиционирование, 

// предполагается, что его свойство оГГзеТРагепТ ссылается на тело документа, 
ѵаг огідХ = еІетепіТоОгад. оГГзеНеГТ; 
ѵаг огідУ = еІетепІТоОгад.оГГзеІТор; 

// Найти расстояние между точкой события тоіізеРоѵ/п и верхним левым углом элемента. 

// Это расстояние будет учитываться при перемещении указателя мыши, 
ѵаг РеНаХ = зѣагІХ - огідХ; 
ѵаг РеНаУ = зіагІУ - огідУ; 

// Зарегистрировать обработчики событий тоіізетоѵе и тоіізеіір, 

// которые последуют за событием тоіізеРомп. 
іГ (РоситепІ.аРРЕѵепНізіепег) { // Стандартная модель событий 
// Зарегистрировать перехватывающие обработчики в документе 
Росцтепі.аРРЕѵепІІізІепегС’тоцзетоѵе", тоѵеНапРІег, ігііе); 

Росіітепі:.аРРЕѵеп1:Іі5І:епег("тоіізеіір", іірНапРІег, Іпіе); 

} 

еізе ІГ (Росіітепі:. аиасН Еѵепі:) { // Модель событий ІЕ для ІЕ5-8 
// В модели событий ІЕ перехват событий осуществляется вызовом 
// метода зе1:Сар1:ііге() элемента. 
еІетепНойгад. зеіСарІіі ге(); 
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еІетепНоОгад . аТТасІіЕѵепі: ( "оптоіізетоѵе”, тоѵеНапсІІег); 
еІетепНоОгад. аиасГі Еѵепі:("оптоіізецр", ирНапсІІег); 

// Интерпретировать потерю пер’ехвата событий мыши как событие тоіізеіір 
еІетепНоОгад.аПасНЕѵепіе'опІозесарІііге", ирНапсІІег); 

} 

// Это событие обработано и не должно передаваться другим обработчикам 
іТ (еѵепі:. зіорРгорадаІіоп) еѵепі:. 5ІорРгорада1:іоп(); // Стандартная модель 
еізе еѵепі:.сапсеІВііЬЫе = Ігііе; // ІЕ 

// Предотвратить выполнение действий, предусмотренных по умолчанию. 

ІТ (еѵепі:.ргеѵепЮеУаиИ) еѵепі:.ргеѵепЮеІ'аііІіО; // Стандартная модель 
еізе еѵепі:. геІіігпѴаІііе = Шзе; // ІЕ 

/* * 

* Этот обработчик перехватывает события тоіізетоѵе, возникающие 

* в процессе буксировки элемента. Он отвечает за перемещение элемента. 
**/ 

^цпсііоп тоѵеНапсІІег(е) { 

ІТ (!е) е = ѵ/іпсіоѵ/. еѵепі:; // Модель событий ІЕ 

// Переместить элемент в позицию указателя мыши с учетом позиций 
// полос прокрутки и смещений относительно начального щелчка, 
ѵаг зсгоіі = деіЗсгоПОІ^зеТзО; 

еІетепіТоОгад.зіуіе.ІеМ = (е.сІіепТХ + зсгоіі.х - беІІаХ) + "рх"; 
еІетепТТоОгад.зТуІе.Тор = (е.сііепіѵ + зсгоіі.у - беІТаѴ) + "рх"; 

// И прервать дальнейшее распространение события. 

іТ (е.зТорРгорадаііоп) е.зІорРгорадаІіопО; // Стандартная модель 

еізе е. сапсеІВііЬЫе = Ігііе; // ІЕ 

} 

/* * 

* Этот обработчик перехватывает заключительное событие тоіізеіір, 

* которое завершает операцию буксировки. 

**/ 

^цпсііоп іірНапсіІег(е) { 

ІТ (!е) е = ѵ/іпсіоѵ/. еѵепі:; // Модель событий ІЕ 

// Удалить перехватывающие обработчики событий. 

ІТ (сіосіітепі:. гетоѵеЕѵепНізіепег) { // Модель событий йОМ 

сіосіітепі:. гетоѵеЕѵеп1І_із1:епег( "тоіізеіір", ирНапсІІег , Ігііе); 
сіосцтепі:. гетоѵеЕѵепНізІепегС'тоизетоѵе", тоѵеНапсІІег, ігііе); 

} 

еізе іТ (сіосіітепі.сіеіасЬЕѵепІ:) { // Модель событий ІЕ 5+ 

еІетепіТоОгад.сІеІасЬЕѵепіСопІозесарІііге", ирНапсІІег); 
еІетепіТоОгад. ЬеІасЬЕѵепІ:("оптоцзецр", црНапсІІег); 
еІетепНойгад. сіеІасЬЕѵепі:("оптоіізетоѵе", тоѵеНапсІІег); 
еІетеЫТоОгад. ге1еазеСар1:ііге(); 

} 

// И прервать дальнейшее распространение события. 
іТ (е.зІорРгорадаІіоп) е.зІорРгорадаІіопО; // Стандартная модель 
еізе е.сапсеІВиЬЫе = Ігііе; // ІЕ 

} 

} 
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Следующий фрагмент демонстрирует порядок использования функции с!гад() 
в НТМЬ-файле (это упрощенная версия примера 16.2 с добавленной поддержкой 
буксировки): 

<зсгір* згс="де1:Зсго110Г1 : зе1:з.]5"></зсгірі:> <!-- требуется функция бгад()--> 

<зсгірт згс="0гад.із"></зсгірі:> <!-- определение бгадО --> 

<!-- Буксируемый элемент --> 

<с!іѵ 5І:у1е="ро$і1:іоп :аЬ$о1іі1:е; ІеГТіІООрх; Тор:100рх; місі1:И:250рх; 

Ьаскдгоііпсі-соіог : ѵЛііТе; Ьогсіег: зоіісі Ыаск; "> 

<!-- "Заголовок" окна. Обратите внимание на атрибут оптоіізесіомп. --> 

<с!іѵ 5Ту1е="Ьаскдгоііпс1-со1ог: дгау; ЬогсІег-ЬоТТот: боТТесІ Ыаск; 

расШпд: Зрх; ГопТ-ТатіІу: запз-зегіТ; ГопТ-ѵ/еідЫ: Ьоісі;" 
оптоцзеРомп="с1гад(Ш5. рагепіМосІе, еѵепі:); "> 

Перетащи меня <!-- Содержимое заголовка --> 

</с!іѵ> 

<!-- Содержимое буксируемого элемента --> 

<р>Это тест. Проверка, проверка, проверка. </рхр>Тест</рхр>Тест</р> 

</с!іѵ> 

Самым важным здесь является атрибут оптоіізесіомп во вложенном элементе <с!іѵ>. 
Обратите внимание, что в нем используется свойство 1:0із.рагеп1;Мос1е. Это говорит 
о том, что перемещаться будет весь контейнерный элемент. 

17.6. События колесика мыши 

Все современные броузеры поддерживают колесико мыши и возбуждают событие 
«тоизеѵѵЬееІ», когда пользователь вращает его. Броузеры часто используют коле¬ 
сико мыши для прокрутки документа или изменения масштаба отображения, но 
вы можете отменить событие «тоизелѵЬееІ», чтобы предотвратить выполнение 
этих действий по умолчанию. 

Существует множество проблем совместимости, связанных с событиями «тоизе- 
лѵііееі», тем не менее вполне возможно написать программный код, действующий 
на всех платформах. На момент написания этих строк все броузеры, кроме Гіге- 
?ох, поддерживали событие с именем «тоизеѵѵЬееІ». В Рігеіох это событие называ¬ 
ется «БОММоизеЗсгоИ». А в проекте спецификации «БОМ Ьеѵеі 3 Еѵепіз» пред¬ 
ложено имя «лѵЬееІ» вместо «тоизелѵЬееІ». Вдобавок к разным именам события 
различаются и имена свойств объектов, передаваемых с этими различными со¬ 
бытиями, которые определяют величину поворота колесика. Наконец, следует 
отметить, что существуют также важные отличия в аппаратной реализации ко¬ 
лесиков в разных мышах. Некоторые колесики могут вращаться только в одной 
плоскости, назад и вперед, а некоторые (особенно в мышах компании Арріе) мо¬ 
гут вращаться также влево и вправо (в действительности такие «колесики» явля¬ 
ются трекболами (ІгаскЪаІІ)). Стандарт «БОМ Ьеѵеі 3» даже включает поддержку 
«колесиков», которые могут вращаться в трех плоскостях - по или против часо¬ 
вой стрелки вдобавок к вращению вперед/назад и влево/вправо. 

Объект события, передаваемый обработчику события «тоизелѵЬееІ», имеет свой¬ 
ство ѵ/ІлееЮеІІа, определяющее величину прокрутки колесика. Один «щелчок» 
колесика в направлении от пользователя обычно соответствует значению 120, 
а один щелчок в направлении к пользователю - значению -120. В За^агі и СЬготе 
для поддержки мышей компании Арріе, имеющих трекбол вместо колесика, вра- 
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щающегося в одной плоскости, вдобавок к свойству ѵЛіееЮеІІіа объект события 
имеет свойства мМееЮеПгаХ и мМееЮеІІіаѴ, при этом значения свойств мІлееЮеІІіа 
и мМееЮеИаУ всегда совпадают. 

В Гігеіох вместо события «тоизеѵѵЬееІ» можно обрабатывать нестандартное собы¬ 
тие «БОММоизе8сго11» и использовать свойство сіеііаіі объекта события вместо 
мМееЮеІІіа. Однако масштаб и знак изменения свойства сіеііаіі отличается от міпееі- 
Оеіііа: чтобы получить значение, эквивалентное значению свойства мМееЮеИа, 
свойство сіеііаіі нужно умножить на -40. 

На момент написания этих строк проект стандарта «БОМ Ьеѵеі 3 Еѵепіз» опреде¬ 
лял стандартное событие с именем «дѵЬееІ» как стандартизованную версию собы¬ 
тий «тоизедѵЬееЬ и «БОММоизеЗсгоИ». Согласно спецификации, объект, переда¬ 
ваемый обработчику события «дѵЬееІ», должен иметь свойства сІеІІіаХ, сІеНіаУ 
и с!е11іа2, определяющие величину прокрутки колесика в трех плоскостях. Значе¬ 
ния этих свойств следует умножать на -120, чтобы получить значение и знак со¬ 
бытия «тоизедѵЬееІ». 

Для всех этих типов событий объект события напоминает объекты событий мы¬ 
ши: он включает координаты указателя мыши и состояние клавиш-модификато¬ 
ров на клавиатуре. 

Пример 17.3 демонстрирует, как обрабатывать события колесика мыши и как об¬ 
ходить проблемы совместимости. В нем определяется функция с именем епс1озе(), 
которая обертывает в «кадр» или «видимую область» заданного размера более 
крупный элемент (такой как изображение) и определяет обработчик события ко¬ 
лесика мыши, который позволяет пользователю прокручивать элемент в преде¬ 
лах видимой области и изменять размеры этой области. Эту функцию епс1озе() 
можно использовать, как показано ниже: 

<5сгірі: 5гс="мІіепРеас1у. ^з"х/зс гірі:> 

<зс гірі: 5гс="ЕпсІ05е. ^ з”></зсгірі:> 

<зсгірі:> 

\ѵ!іепВеас1у(^ипсіііоп ( ) { 

епс1озе(с1оситеп1:. деіЕІетепіВуІсК "сопіепі:"). 400.200, -200, -300); 

}); 

</зсгір1;> 

<5І:у1е>с1іѵ.епсіозиге { Ьогсіег: зоіісі Ыаск Юрх; тагдіп: Юрх; }</5іу1е> 

<ітд іс!="сопі:епі:" згс="1:е5І:ітаде. ^рд"/> 

Для обеспечения корректной работы во всех основных броузерах в примере 17.3 
выполняется проверка типа броузера (раздел 13.4.5). Пример опирается на поло¬ 
жения спецификации «БОМ Ьеѵеі 3 Еѵепіз» и включает программный код, кото¬ 
рый будет использовать событие «лѵЬееі», когда его поддержка будет реализована 
в броузерах. 1 Он также включает дополнительную проверку на будущее, чтобы не 
использовать событие «БОММоизеВсгоІІ», если Гігеіох начнет использовать собы¬ 
тие «дѵЬееІ» или «тоизедѵЬееІ». Обратите внимание, что пример 17.3 также являет¬ 
ся практическим примером управления геометрией элементов и использования 
приемов позиционирования средствами С88, о которых рассказывалось в разде¬ 
лах 15.8 и 16.2.1. 


1 Довольно рискованное решение: если будущие версии стандарта не будут соответство¬ 
вать проекту спецификации, имевшейся на момент написания этих строк, это может 
привести к нежелательным последствиям и сделать пример неработоспособным. 
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Пример 17.3. Обработка событий «тоизеіѵНееІ» 

// Заключает элемент содержимого в фрейм, или видимую область заданной ширины 
// и высоты (минимальные размеры 50x50). Необязательные аргументы сопТепТХ 
// и сопТепіУ определяют начальное смещение содержимого относительно кадра. 

// (Их значения должны быть <= 0.) Фрейму придается обработчик события тоцземНееІ, 

// который позволяет пользователю прокручивать элемент и изменять размеры фрейма. 
Рцпсііоп епс1озе(соп1:еп1:, ГгатемісІ1:Іі, ГгатеНеідІгІ:, соп*еп*Х, сопТепІУ) { 

// Эти аргументы являются не только начальными значениями: они хранят информацию 
// о текущем состоянии, изменяются и используются обработчиком события тоцзеѵ/ііееі. 
РгатеѵѵісІ1:Н = Маі:Н.тах(РгатемісІі:Н, 50); 

ІгатеНеідНі: = Маі:Н.тах(РгатеНеідН1:, 50); 
соп*еп*Х = Ма*Ь.тіп(сопі:епІХ, 0) || 0; 
соп*еп*У = Маі:Н.тіп(сопі:еп*У, 0) || 0; 

// Создать фрейм и определить для него стили и имя класса С38 
ѵаг Ітате = досцтепі:.сгеа1:еЕ1етеп1:("сііѵ"); 

Ргате.сІаззМате = "епсіозііге"; // Благодаря этому можно определять стили 

// в таблицах стилей 

?гате.зіуіе. ѵѵісіііН = ^гатехѵісііііт + "рх”; // Установить размеры фрейма. 

Ргате.зііуіе. ГіеідГѵЕ = РгатеНеідНІ: + "рх"; 

Ггате.зіуіе.оѵег^іоѵ/ = "Нісісіеп"; // Без полос прокрутки 

Ітате.зіуіе. ЬохЗігіпд = "ЬогРег-Ьох"; // модель Ьогсіег-Ьох упрощает 

Ргате. 5І:у1е.ѵ/еЬкі1:ВохЗШпд = "Ьогсіег-Ьох"; // вычисление новых размеров 
Ргате.зіуіе.МогВохЗШпд = "Ьогсіег-Ьох"; // фрейма. 

// Добавить фрейм в документ и поместить в него элемент еИ. 
сопі:епі:.рагепі:МосІе.іпзеггВеРоге^гате, сопіеп*); 

Ргате. аррепсіСЬі1сі(соп1:еп1: ); 

// Координаты элемента относительно фрейма 
сопіепі:. зіуіе. розШоп = "геіаііѵе"; 
сопіеп'і.зіуіе.іегі = сопіепіх + "рх"; 
соп*еп*.з*у1е.*ор = сопІепІУ + "рх"; 

// Необходимо решить некоторые проблемы совместимости броузеров 
ѵаг ізМасМеЬкіІ: = (паѵідаііог. іізегАдепІ:. іпс!ех0Г("Масіпііозіі") !== -1 && 

паѵідаіог.цзегАдепІ:.іпсІехО^С’МеЬКіІ:") !== -1); 
ѵаг ізРігеРох = (паѵідаііог.цзегАдепІ:.іпс!ехОР("Сеско") !== -1); 

// Зарегистрировать обработчики событий тоцземЬееІ. 

Ргате.опѵ/Ьееі = ѵ/ЬееІНапсіІег; // Для будущих броузеров 

Ргате . оптоіізеѵ/ЬееІ = ѵ/ЬееІНапсіІег; // Для большинства текущих броузеров 

іР (ізРігеРох) // Только РігеРох 

Ргате.асісіЕѵепШзІіепегС’ООММоіізеЗсгоІГ', ѵ/ЬееІНапсіІег, Раізе); 

рцпсТіоп ѵ/Ьее1Напсі1ег(еѵеп1:) { 

ѵаг е = еѵепТ || хѵіпсіом.еѵепі;; // Объект события, стандартный или ІЕ 

// Получить величину прокрутки из объекта события, проверив свойства объекта 
// события ѵ/ЬееІ, тоцзеѵ/ЬееІ (в обоих, 2-мерном и 1 -мерном вариантах) 

// и ООММоцзеЗсгоІІ в РігеРох. Масштабировать значение так, чтобы один «щелчок» 
// колесика соответствовал 30 пикселам. Если какой-либо из броузеров в будущем 
// будет возбуждать оба типа событий, "ѵ/ЬееІ" и "тоіізеѵ/ЬееІ", одно и то же 
// событие будет обрабатываться дважды. Но будем надеяться, что отмена 
// события мЬееІ будет предотвращать возбуждение события тоцзеѵ/ЬееІ. 
ѵаг сІеИаХ = е.Ре11:аХ*-30 || // событие ѵ/ЬееІ 




17.6. События колесика мыши 


507 


е.мГ)ееЮеНаХ/4 

м 

// 

0; 


// 

ѵаг беИаУ = е.с!е11:аУ*-30 || 


// 

е.ѵ/ЬееЮе11:аУ/4 

м 

// 

(е.ѵ/НееЮе11:аУ===ипсіеТіпесі && 


// 

е.ѵ4іееЮе11:а/4) 

м 

// 

е.с!еіаі1*-10 

м 

// 

0; 


// 


тоизеѵ/НееІ 

свойство не определено 
событие ѵ/НееІ 

событие тоизеѵ/НееІ в МеЬкП 
Если нет 2-мерного свойства, 
использовать 1-мерное свойство 
событие ООММоьзеЗсгоІІ в ЕігеТох 
свойство не определено 


// Большинство броузеров генерируют одно событие со значением 120 
// на один щелчок колесика. Однако похоже, что мыши компании Арріе 
// более чувствительные, и значения свойств сІеІТа часто оказываются 
// в несколько раз больше 120, по крайней мере, для Арріе Моіізе. 

// Использовать прием проверки типа броузера, чтобы решить эту проблему. 
іТ (ізМасІл/еЬкіІ:) { 
беИаХ /= 30; 
беИаУ /= 30; 

} 

// Если мы когда-нибудь будем получать событие тоизеѵ/НееІ или мНееІ в (будущих 
// версиях) ЕігеТох, можно отказаться от обработки события ООММоизеЗсгоІІ. 

ІТ (ізЕігеТох && е.Туре !== "ООММоизеЗсгоІІ") 

Нате. гетоѵеЕѵеп1:І_і5І:епег("ООММоизеЗсгоІІ", мНееІНапсіІег, Таізе); 

// Получить текущие размеры элемента содержимого 
ѵаг сопіепіЬох = сопІепІ.деІВоипбіпдСІіепіВесіО; 
ѵаг сопіепімігіііі = сопТепТЬох. гідПІ: - сопТепТЬох. ІеН; 
ѵаг сопіегѵЫіеідГѵС = сопТепТЬох. ЬоПот - сопТепТЬох.Тор; 


// Если удерживается нажатой клавиша АН, изменить размеры фрейма 
іТ (е.аНКеу) { 
іТ (беІТаХ) { 

НатемісНІі -= деІіаХ; // Новая ширина фрейма, но не больше, 
Натеѵ/ісіІІі = МаіН.тіп(Наптсі1:Іі, сопіепіѵ/ісііН); // чем ширина 
НатемісііН = Ма1:Іі.тах(Натеѵ/ісі1:Н, 50); // содержимого 

Нате, зіуіе.місіііі = НатемісШі + "рх"; // и не меньше 

} 

іТ (беІТаУ) { 

НатеНеідІгІ: -= сіеІіаУ; // То же для высоты фрейма 
НатеІіеідІтІ: = Ма1:Н.тіп(НатеІіеідІі1:, сопіепНеідІгІ:); 

НатеНеідНІ: = МаТН.тах(НатеІіеідН1:-сІе11:аУ, 50); 

Нате. зіуіе. НеідІгТ = НатеІіеідНІ: + "рх"; 

} 


} 

еізе { // Клавиша АН не нажата, прокрутить содержимое в фрейме 
іТ (беИаХ) { 

// Прокручивать не больше, чем 

ѵаг тіпоНзеІ = МаіН.тіп(НатемісіН-сопіепіѵ/ісі1:Н, 0); 

// Сумма сІеНаХ и сопіепіХ, но не меньше, чем тіпоТТзеі 
сопТепТХ = МаТН.тахСсопТепТХ + беИаХ, тіпоНзеі); 
сопТепіХ = Ма1:Н.тіп(соп1:еп1:Х, 0); // или больше 0 

сопіепі:. зіуіе. ІеН = сопТепТХ + "рх"; // Новое смещение 

} 


іТ (беИаУ) { 

ѵаг тіпоНзеі = МаіН.тіп(НатеІіеідІтТ - сопіепНеідНІ:, 0); 
// Сумма сІеИаУ и сопіепіУ, но не меньше, чем тіпоТТзеІ: 
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сопіепіУ = МаТН.тах(сопі:епі:У + сІеІТаУ, тіпоГ^зеТ); 
сопІепТУ = МаТН.тіп(соп1:еп1;У, 0); // или больше О 

сопіепі:.зТуІе. Тор = сопТепТУ + ”рх”; // Новое смещение. 

* 

} 

} 

// Не позволять всплывать этому событию. Предотвратить выполнение действий 

// по умолчанию. Это позволит предотвратить прокрутку содержимого документа 

// в окне броузера. Будем надеяться, что вызов ргеѵепЮеГаиЩ ) для события мНееІ 

// также предотвратит возбуждение дублирующего события тоиземііееі . 

іТ (е. ргеѵептОеГаіЛІ:) е. ргеѵепТОеГаіЛК ); 

іГ (е. зТорРгорадаТіоп) е. зТорРгорадаТіопО; 

е.сапсеІВиЬЫе = Тгііе; // модель событий ІЕ 

е.геТигпѴаІие = Гаізе; // модель событий ІЕ 

геТіігп Таізе; 

} 

} 

17.7. События механизма буксировки 
(сігад-апсі-сігор) 

В примере 17.2 было показано, как реализовать операцию буксировки элементов 
мышью. Она позволяет перетаскивать и оставлять элементы в пределах веб-стра¬ 
ницы, но истинная буксировка - это нечто иное. Буксировка (бга^-апсі-сігор, или 
БиБ)- это интерфейс взаимодействия с пользователем, позволяющий переме¬ 
щать данные между «источником» и «приемником», которые могут находиться 
в одном или в разных приложениях. Буксировка (БпБ) - это сложный механизм 
организации взаимодействий между человеком и машиной, и прикладные интер¬ 
фейсы, реализующие поддержку буксировки, всегда отличались высокой слож¬ 
ностью: 

• Они должны взаимодействовать с операционной системой, чтобы обеспечить 
возможность взаимодействий между различными приложениями. 

• Они должны поддерживать такие операции передачи данных, как «перемеще¬ 
ние», «копирование» и «создание ссылки», позволять источникам и приемни¬ 
кам ограничивать множество допустимых операций, а также давать пользо¬ 
вателям возможность выбирать (обычно с помощью клавиш-модификаторов) 
операцию из разрешенного набора. 

• Они должны предоставлять источнику способ определять ярлык или изобра¬ 
жение, которое будет отображаться в процессе буксировки. 

• Они должны предоставлять механизм событий для посылки извещений ис¬ 
точнику и приемнику в процессе буксировки. 

Корпорация Місго8о11 реализовала прикладной интерфейс механизма буксиров¬ 
ки в ранних версиях ІЕ. Он был не очень хорошо продуман и плохо документиро¬ 
ван, тем не менее другие производители броузеров попытались скопировать его, 
а спецификация НТМЬб стандартизовала некоторый АРІ, напоминающий при¬ 
кладной интерфейс в ІЕ, и добавила новые особенности, делающие этот АРІ более 
простым в использовании. На момент написания этих строк данный новый, бо¬ 
лее простой в использовании АРІ буксировки еще не был реализован, поэтому 



17.7. События механизма буксировки (сігад-апсі-сігор) 


509 


в этом разделе будет рассматриваться прикладной интерфейс в ІЕ, как взятый за 
основу стандартом НТМЬб. 

Прикладной интерфейс механизма буксировки в ІЕ довольно сложен в использо¬ 
вании, а различия между реализациями в текущих броузерах не позволяют ис¬ 
пользовать наиболее сложные части АРІ переносимым способом. Тем не менее он 
дает возможность веб-приложениям участвовать в операциях буксировки подоб¬ 
но обычным приложениям. Броузеры всегда позволяли выполнять простейшие 
операции буксировки. Если выделить текст в веб-броузере, его легко можно от¬ 
буксировать в текстовый процессор. А если выделить ІІКЬ-адрес в текстовом про¬ 
цессоре, его можно отбуксировать в броузер, чтобы открыть страницу с этим ад¬ 
ресом. В этом разделе будет показано, как создавать собственные источники, ко¬ 
торые позволят перемещать данные, не являющиеся текстом, и собственные при¬ 
емники, откликающиеся на попытки оставить в них данные некоторым способом, 
помимо простого их отображения. 

Механизм буксировки всегда опирался на события, поэтому в ЛаѵаЗсгірі АРІ 
реализовано два множества событий: события из первого множества возбужда¬ 
ются в источнике данных, а из второго - в приемнике. Все обработчики событий 
буксировки получают объект события, подобный объекту события мыши, с до¬ 
полнительным свойством с1а1;аТгапз1 = ег. Это свойство ссылается на объект ОаІіаТгапз- 
■Гег, определяющий методы и свойства прикладного интерфейса механизма бук¬ 
сировки. 

События, возбуждаемые в источнике, относительно просты, поэтому начнем 
с них. Источником для механизма буксировки является любой элемент докумен¬ 
та, имеющий НТМЬ-атрибут сІгаддаЬІе. Когда пользователь начинает перемещать 
указатель мыши с нажатой кнопкой над элементом-источником, броузер не выде¬ 
ляет содержимое элемента, а возбуждает в нем событие «йга^зіагі». Обработчик 
этого события должен вызвать метод с!а1:аТгапз1 = ег. зеЮа1:а( ), чтобы определить дан¬ 
ные (и тип этих данных), доступные в источнике. (Когда будет реализован новый 
НТМЬб АРІ, вместо этого метода нужно будет вызывать метод сІаЬаТгапз'Гег. іЬетз. 
ас!с1( ).) Обработчику также может потребоваться установить свойство сІаІіаТ гапз'Гег. 
е^есІАПомесІ, чтобы определить тип операции - «перемещение», «копирование» 
или «создание ссылки» - поддерживаемой источником, и, возможно, необходимо 
будет вызвать метод сІаІіаТгапз-Гег. зе1:0гадІтаде( ) или йаЬаТгапз'Гег. ас!с1Е1етеп1:( ) (в бро¬ 
узерах, поддерживающих эти методы), чтобы определить изображение или эле¬ 
мент документа, который будет использоваться для визуального представления 
перемещаемых данных. 

В процессе буксировки броузер возбуждает в источнике данных события «(1га&». 
Обработчик этого события можно использовать для изменения перемещаемого 
ярлыка или перемещаемых данных, но в общем случае нет никакой необходимо¬ 
сти регистрировать обработчики событий «(1га&». 

Когда выполняется сброс, возбуждается событие «<1га&еп<1». Если источник под¬ 
держивает операцию «перемещения», он должен проверить свойство сІаЬаТгапз'Гег. 
сі горЕ'Г'ГесЬ, чтобы убедиться, действительно ли была выполнена операция переме¬ 
щения. Если это так, данные, перемещенные в другое место, следует удалить из 
источника. 

Событие «(Іга&зіагі» является единственным, обработку которого необходимо 
реализовать в простейшем источнике данных. Реализация такого источника 
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представлена в примере 17.4. Он отображает текущее время в формате «Мі:тт» 
в элементе <зрап> и обновляет время раз в минуту. Если бы это было все, что реа¬ 
лизует пример, пользователь мог бы просто выделить отображаемый текст и от; 
буксировать его. Но этот пример превращает часы в источник данных для меха¬ 
низма буксировки, устанавливая свойство сІгаддаЫе элемента часов в значение 
ігііе и определяя функцию-обработчик опсігадзіагі:. Обработчик вызывает метод 
сіаіаТгапзГег.зеіОаІіаО, чтобы определить перемещаемые данные - строку с полной 
информацией о текущем времени (включая дату, секунды и информацию о часо¬ 
вом поясе). Он также вызывает сІаіаТгапзГег.зеіОгадІсопО, чтобы определить изо¬ 
бражение (ярлык с изображением часов), которое будет перемещаться в процессе 
буксировки. 

Пример 17.4. Источник данных для механизма буксировки 

<зсгірі згс='мІіепНеасіу. із"></зсгірі:> 

<зсгірі> 

мНепНеасіу^ііпсІіопС) { 

ѵаг сіоск = сіоситепі.деіЕІетепіВуІсК "сіоск'); // Элемент часов 

ѵаг ісоп = пей Ітаде(); // Буксируемое изображение 

ісоп.згс = "сіоск-ісоп.рпд"; // ІШІ_-адрес изображения 

// Отображает время раз в минуту 
іііпсііоп сІі5р1ауТіте() { 

ѵаг пом = пем Оаіе(); // Получить текущее время 

ѵаг Пгз = пом. деіНоигз(), тіпз = пом.деіМіпіПезС); 

ІГ (тіпз < 10) тіпз = "О" + тіпз; 

сіоск. іппегНТМІ. = Пгз + + тіпз; // Отобразить текущее время 

зеіТітеоіИ(сіі5р1ауТіте, 60000); // Запустить через 1 минуту 

} 

бізр1ауТіте(); 

// Сделать часы доступными для буксировки. 

// То же самое можно сделать с помощью НТМБ-атрибута: 

// <зрап с!гаддаЫе="1:гие , '>... 
сіоск. бгаддаЫе = ігііе; 

// Обработчики событий 

сіоск. опсігадзіагі: = ^ііпсііопСеѵепі:) { 

ѵаг еѵепі = еѵепі: || міпсіом. еѵепі; // Для совместимости с ІЕ 

// Свойство сІаіаТгапзІ'ег является ключом к бгад-апсі-сігор АРІ 
ѵаг 61 = еѵепі.сІаІіаТгапзГег; 

// Сообщить броузеру, какие данные будут буксироваться. 

// Если конструктор 0аіе() вызывается как функция, он возвращает 
// строку с полной информацией о текущем времени 
сП.зеіОаіаС'ТехІ:", 0аіе() + ”\п”); 

// Определить ярлык, который будет служить визуальным представлением перемещаемой 
// строки, в броузерах, поддерживающих эту возможность. Без этого для визуального 
// представления броузер мог бы использовать изображение текста в часах, 
іі (сІі.зеіОгадІтаде) сП.зеі0гад1таде(ісоп, 0, 0); 

}; 

}); 

</зсгірі> 

<5іу1е> 
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Исіоск { /* Придать часам привлекательный внешний вид */ 

?опТ: Ьоісі 24рТ запз; ЬаскдгоііпсІ: ИсІсИ 1 ; расісііпд: Юрх; 

ЬогРег: зоіісі Ыаск 2рх; Ьогсіе г- гасііиз : Юрх; 

} 

</зі:у1е> 

<И1 >йгад Тітезіатрз Ігот ТПе с1оск</М> 

<зрап ісІ="с1оск"></5рап> <!-- Здесь отображается время --> 

<Тех1:агеа со1з=60 гоѵ/з=20></1:ех1:агеа> <!-- Сюда можно сбросить строку --> 

Приемники буксируемых данных сложнее в реализации, чем источники. Прием¬ 
ником может быть любой элемент документа: чтобы создать приемник, не требу¬ 
ется устанавливать НТМЬ-атрибуты, как при создании источников, - достаточно 
просто определить соответствующие обработчики событий. (Однако с реализа¬ 
цией нового прикладного интерфейса буксировки, определяемого стандартом 
НТМЬб, вместо некоторых обработчиков событий, описываемых ниже, в элемен¬ 
те-приемнике необходимо будет установить атрибут сігоргопе.) В приемнике возбу¬ 
ждается четыре события. Когда буксируемый объект оказывается над элементом 
документа, броузер возбуждает в этом элементе событие «бга^епіег». Опреде¬ 
лить, содержит ли буксируемый объект данные в формате, понятном приемнику, 
можно с помощью свойства сІаііаТгапз'Гег. Ііурез. (При этом может также потребо¬ 
ваться проверить свойство сІаІіаТ гапз'Гег. е'Г'ГесІіАІІохл/есІ, чтобы убедиться, что источ¬ 
ник и приемник поддерживают выполняемую операцию: перемещение, копиро¬ 
вание или создание ссылки.) В случае успешного прохождения этих проверок 
элемент-приемник должен дать знать пользователю и броузеру, что он может при¬ 
нять буксируемый объект. Обратную связь с пользователем можно реализовать 
в виде изменения цвета рамки или фона. Самое интересное: приемник сообщает 
броузеру, что он готов принять буксируемый объект, отменяя это событие. 

Если элемент не отменит событие «бга^епіег», переданное ему броузером, броузер 
не будет считать этот элемент приемником для данной операции буксировки и не 
будет передавать ему дополнительные события. Но если приемник отменит собы¬ 
тие «бга^епіег», броузер будет посылать ему события «сіга&оѵег», пока пользова¬ 
тель будет буксировать объект над приемником. Интересно (снова) отметить, что 
приемник должен обрабатывать и отменять все эти события, чтобы сообщить, что 
он по-прежнему готов принять буксируемый объект. Если приемнику потребует¬ 
ся сообщить, что он поддерживает только операцию перемещение, копирования 
или создания ссылки, он должен устанавливать свойство с!аі:аТгапз1 = ег.с1горЕ1 = 1 = ес1: 
в обработчике события «(Іга^оѵег». 

Если пользователь переместит буксируемый объект за границы приемника, кото¬ 
рый сообщал о своей готовности принять объект отменой событий, в приемнике 
будет возбуждено событие «сіга&іеаѵе». Обработчик этого события должен восста¬ 
новить прежний цвет рамки или фона элемента или отменить любые другие визу¬ 
альные изменения, выполненные в ответ на событие «сігазепіег». К сожалению, 
оба события, «бга^епіег» и «(Іга^іеаѵе», всплывают; и если приемник имеет вло¬ 
женные элементы, будет сложно отличить, говорит ли событие «бга^іеаѵе» о том, 
что указатель мыши с буксируемым объектом вышел за границы элемента-при¬ 
емника или что он вышел за границы вложенного элемента внутри приемника. 

Наконец, если пользователь сбросит буксируемый объект над приемником, в при¬ 
емнике будет возбуждено событие «(Ігор». Обработчик этого события должен по¬ 
лучить перемещаемые данные с помощью с1а1:аТгапз1 = ег.де1:0а1:а( ) и выполнить над 
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ними соответствующие операции. Если пользователь сбросит над приемником 
один или более файлов, свойство гіаІіаТгапзІ'ег.-РіІез будет содержать объект, подоб¬ 
ный массиву, с объектами Рііе. (Работа с этим свойством демонстрируется в при¬ 
мере 18.11.) После реализации нового НТМЬб АРІ обработчики события «<1гор» 
должны будут выполнить обход элементов массива с1а1;аТгапз1 : ег. І1;етз[ ], чтобы об¬ 
работать данные, которые могут быть или не быть файлами. 

Пример 17.5 демонстрирует, как превратить в приемники элементы <и1> и как 
превратить вложенные в них элементы <1і> в источники. Этот пример является 
демонстрацией концепции ненавязчивого ЛѵаВсгірі. Он отыскивает элементы 
списка <и1>, атрибут сіазз которых включает класс «сіпсі», и регистрирует в них 
обработчики событий буксировки. Обработчики событий превращают список 
в приемник: любой текст, сброшенный над таким списком, будет преобразован 
в новый элемент списка и добавлен в конец. Обработчики событий также обслу¬ 
живают ситуации перемещения элементов внутри списка и делают текст каждо¬ 
го элемента списка доступным для буксировки. Обработчики событий источни¬ 
ков поддерживают операции копирования и перемещения и удаляют элементы 
списка, которые были сброшены в ходе выполнения операции перемещения. (Об¬ 
ратите внимание, что не все броузеры обеспечивают переносимую поддержку 
операции перемещения.) 

Пример 17.5. Список как приемник и источник 

/* 

* Прикладной программный интерфейс механизма буксировки весьма сложен, его реализации 

* в разных броузерах не являются полностью совместимыми. В своей основе этот пример 

* реализован правильно, но все броузеры немного отличаются друг от друга, 

* и каждый из них имеет свои уникальные особенности. В данном примере не делается 

* попыток реализовать обходные решения, характерные для отдельных броузеров. 

*/ 

\ѵйепНеас!у(Гііпс1:іоп( ) { // Вызовет эту функцию, когда документ будет загружен 

// Отыскать все элементы <іі1 с1аз5= ’ сіпсі * > и вызвать функцию йпс1() для них 
ѵаг Іізіз = йосцтеп1:.де1:Е1етеп1:5ВуТадМате(''ііГ'); 
ѵаг гедехр = /\Ьс1пс1\Ь/; 

Гог(ѵаг і = 0; і < іібіз.І епдіИ; і++) 

іГ (гедехр. *ез*(1із*8[і].СІаззМате)) с!псі( 1 іб1:б[ і]); 

// Добавляет обработчики событий буксировки в элемент списка 
Гітсііоп сіпсКіібі:) { 

ѵаг огідіпа1_с1а55 = Из*. СІаззМате; // Сохранить начальный С55-с1азз 
ѵаг епіегесі = 0; // Вход и выход за границы 

// Этот обработчик вызывается, когда буксируемый объект оказывается над списком. 

// Он проверяет, содержит ли буксируемый объект данные в поддерживаемом формате. 

// и, если это так, отменяет событие, чтобы сообщить, что список готов 
// принять объект. В этом случае он также подсвечивает элемент-приемник, 

// чтобы показать пользователю, что готов к приему данных. 

Из*. опсігадепіег = Гііпс1:іоп(е) { 

е = е || \ѵіпс!о\ѵ.еѵепі:; // Объект события, стандартный или ІЕ 

ѵаг Ггот = е. геІаіесІТагдеІ:; 

// События сігадепіег и сігадіеаѵе всплывают, из-за чего сложнее определить, 

// когда следует подсвечивать элемент, а когда снимать подсветку в случаях, 

// подобных этому, где элемент <ііі> содержит дочерние элементы <1і>. 
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// В броузерах, поддерживающих свойство геІаІгесІТагдеІ: , эту проблему можно решить. 
// В других броузерах приходится считать пары событий входа/выхода. 

// Если указатель мыши оказался над списком, переместившись из-за его пределов, 
// или он оказался над списком впервые, необходимо выполнить некоторые операции 
епіегес!++; 

іі (({тот && ! ібсШсКігогп, Из*)) || епіегесі == 1) { 

// Вся информация о буксируемом объекте находится в объекте сіаіаТгапзіег 
ѵаг Р* = е. сіаіаТгапзіег; 

// Объект сІі.іуреБ содержит список типов, или форматов, в которых доступны 
// буксируемые данные. Спецификация НТМІ.5 требует, чтобы свойство {урез имело 
// метод сопіаіп8(). В некоторых броузерах это свойство является массивом 
// с методом іпсіехОІ 1 . В ІЕ версии 8 и ниже оно просто отсутствует, 
ѵаг іурез = сІі.іуреБ; // В каких форматах доступны данные 

// Если информация о типах отсутствует или данные доступны в простом 
// текстовом формате, подсветить список, чтобы показать пользователю, что он 
// готов принять данные, и вернуть іаізе, чтобы известить о том же и броузер, 
іі (КуреБ 11 // ІЕ 

(іурез.сопіаіпз && іурез.сопіаіпз("іехі/р1аіп")) || //НТМІ.5 
(іурез. іпсІехОі && іурез. іпсІехОіС'іехі/рІаіп”)! =-1)) //МеЬкіі 

{ 

ІіБі.сІаББМате = огідіпа1_с1а55 + " йгорраЫе"; 
геііігп іаізе; 

} 

// Если тип данных не поддерживается, мы не сможем принять их 
геііігп; // без отмены 

} 

геііігп іаізе; // Если это не первое вхождение, мы по-прежнему готовы 


// Этот обработчик вызывается в ходе буксировки объекта над списком. 

// Этот обработчик должен быть определен, и он должен возвращать іаізе, 

// иначе сброс объектов будет невозможен. 
іібі. опсігадоѵег = іііпсііоп(е) { геііігп іаізе; }; 

// Этот обработчик вызывается, когда буксируемый объект выходит за границы списка 
// или за границы одного из его дочерних элементов. Если объект действительно 
// покидает границы списка (а не границы одного из его элементов), 

// то нужно снять подсветку списка. 

Іізі.опсігадіеаѵе = іітсііоп(е) { 
е = е 11 тпбоѵі. еѵепі; 
ѵаг іо = е.геІаіебТагдеі; 

// Если буксируемый объект покидает границы списка или если количество выходов 
// за границы совпадает с количеством входов, следует снять подсветку списка 
епіегесі--; 

іі ((іо && ! і5СІй1с1(іо, іібі)) || епіегесі <= 0) { 

ІіБі.сІазБМате = огідіпаі.сіазз; 
епіегесі = 0; 

} 

геііігп іаізе; 

}; 


// Этот обработчик вызывается, когда происходит сброс объекта. 
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// Он извлекает сброшенный текст и превращает его в новый элемент <1і> 
ІізТ.опРгор = Гцпс1:іоп(е) { 

е = е || міпсІом.еѵепТ; // Получить объект события 

// Получить сброшенные данные в текстовом формате. 

// "Тех*" - это псевдоним для "ТехТ/рІаіп". 

// ІЕ не поддерживает "ТехТ/рІаіп”, поэтому здесь используется "Тех*". 

ѵаг сП = е.сІаТаТгапэГег; // объект йаТаТгапзГег 

ѵаг ТехТ = сІТ. деТОаТаСТехТ”); // Получить данные в текстовом формате. 

// Если был получен некоторый текст, превратить его в новый элемент 
// списка и добавить в конец. 
іГ (ТехТ) { 

ѵаг іТеш = с1ос^тепТ.с^еаТеЕ1етепТ("1і ,, ); // Создать новый <1і> 
іТегп.сІгаддаЫе = Тгце; // Сделать буксируемым 

І1:ет. аррепсІСЫ1сІ(сІоситепі: .с геа1еТех1;МосІе(1:ех'І: )); // Добавить текст 
1ізТ.аррепс1СІіі1с1(і1:ет); // Добавить в список 

// Восстановить первоначальный стиль списка и сбросить счетчик епТегес! 
НбТ. сІаззМате = огідіпа1_с1а55; 
епТегес! = 0; 

геТцгп Шзе; 

} 

}; 


// Сделать все элементы списка буксируемыми 
ѵаг іТетБ = 1іБТ.деТЕ1етепІ8ВуТадМате("1і"); 

Тог(ѵаг і = 0; і < іТетз.ІепдТИ; і++) 
і1:ет8[і].РгаддаЫе = Тгце; 

// И зарегистрировать обработчики для поддержки буксировки элементов списка. 
// Обратите внимание, что мы поместили эти обработчики в список и ожидаем, 

// что события будут всплывать вверх от элементов списка. 

// Этот обработчик вызывается, когда буксировка начинается внутри списка. 
1і8І:.опРгад8І:агІ = ^цпсі:іоп(е) { 
ѵаг е = е || \ѵіпРо\ѵ.еѵепі:; 
ѵаг іагдеі = еЛагде* || е.згсЕІетепІ:; 

// Если всплыло событие от элемента, отличного от <1і>, игнорировать его 
іГ (іагде{.іад№те !== "И") геіцгп Гаізе; 

// Получить важный объект РаіаТгапзГег 
ѵаг сП = е.РаіаТгапзІ'ег; 

// Сохранить данные и указать информацию об их формате 
сП.БеЮаІаС'Тех*", іагдеі:.іппегТехІ: || іагдеІ.ІехіСопіепІ); 

// Сообщить, что поддерживаются операции копирования и перемещения 
(И.еГГесШІомесІ = "соруМоѵе"; 

}; 

// Этот обработчик вызывается после успешного сброса 
ІіБі.опРгадепР = Гцпсііоп(е) { 
е = е 11 \ѵіпРо\ѵ.еѵеп1:; 
ѵаг іагдеі: = е.іагдеі: || е.згсЕІетеп*; 

// Если выполнялась операция перемещения, удалить элемент списка. 

// В ІЕ8 это свойство будет иметь значение "попе", если явно 
// не установить его в значение ”тоѵе" в обработчике опРгор выше. 
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// Но принудительная установка в значение "тоѵе" для ІЕ будет 
// препятствовать другим броузерам дать пользователю возможность 
// выбирать между операцияим перемещения и копирования. 
іі 1 (е.йаТаТгапз^ег.РгорЕ^ес* === "тоѵе") 

ІагдеТ. рагепі:Мос1е. гетоѵеСНіІсКТагдеІ:); 

} 

// Вспомогательная функция, используемая в обработчиках опсігадепігег и опсігадіеаѵе. 

// Возвращает Тгііе, если элемент а является дочерним по отношению к элементу Ь. 

^цпсТіоп ізсШсІ(а.Ь) { 

^ог(; а; а = а.рагепТИосІе) і Т (а === Ь) геігіігп Тгце; 
геТцгп ^аізе; 

} 

} 

}); 

17.8. События ввода текста 

Броузеры поддерживают три старых события ввода с клавиатуры. События «кеу- 
сіолѵп» и «кеуир» являются низкоуровневыми событиями и рассматриваются 
в следующем разделе. Однако событие «кеургезз» является высокоуровневым, со¬ 
общающим, что был введен печатаемый символ. Проект спецификации «БОМ 
Ьеѵеі 3 Еѵепіз» определяет более обобщенное событие «іехііприі», генерируемое 
в ответ на ввод текста, независимо от того, каким способом он был введен (напри¬ 
мер, с клавиатуры, копированием данных из буфера обмена или с помощью опе¬ 
рации буксировки, методом ввода текста на азиатских языках или с помощью 
системы распознавания речи или распознавания рукописного текста). На момент 
написания этих строк событие «Іехііприі» еще не поддерживалось, но броузеры 
на основе ядра ДѴеЬкіі поддерживали очень похожее событие «іехііприі» (с за¬ 
главной буквой «I»). 

С предлагаемым событием «Іехііприі» и реализованным в настоящее время со¬ 
бытием «Іехііприі» передается простой объект события, имеющий свойство сіаііа, 
хранящее введенный текст. (Другое предлагаемое спецификацией свойство, іп- 
риІМеІІюсІ, должно определять источник ввода, но оно пока не реализовано.) В слу¬ 
чае ввода с клавиатуры свойство сіаііа обычно будет содержать единственный сим¬ 
вол, но при вводе из других источников в нем может содержаться множество сим¬ 
волов. 

Объект события, передаваемый с событием «кеургезз», имеет более сложную ор¬ 
ганизацию. Событие «кеургезз» представляет ввод единственного символа. Этот 
символ содержится в объекте события в виде числового значения кодового пунк¬ 
та Юникода и, чтобы преобразовать его в строку, необходимо использовать метод 
Зіігіпд.ІтотСІіагСосіеО. В большинстве броузеров кодовый пункт введенного симво¬ 
ла сохраняется в свойстве кеуСосіе объекта события. Однако по историческим при¬ 
чинам в Гіге^ох вместо него используется свойство сЬагСосіе. В большинстве бро¬ 
узеров событие «кеургезз» возбуждается только при вводе печатаемого символа. 
Однако в Гіге^ох событие «кеургезз» возбуждается также для непечатаемых сим¬ 
волов. Чтобы отличить эти два случая (и проигнорировать непечатаемые симво¬ 
лы), можно проверить, существует ли свойство сЬагСосІе объекта события и содер¬ 
жит ли оно значение 0. 
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События «іехііприі», «іехііприі» и «кеургезз» можно отменить, чтобы предотвра¬ 
тить ввод символа. То есть эти события можно использовать для фильтрации вво¬ 
да. Например, можно предотвратить ввод алфавитных символов в поле, предна¬ 
значенное для ввода числовых данных. В примере 17.6 демонстрируется модуль 
на языке ЛѵаВсгірі, реализующий такого рода фильтрацию. Он отыскивает эле¬ 
менты <іпри1: 1уре=1ех*> с дополнительным (нестандартным) атрибутом сіаіа-аііо- 
\А/есі-сИаг5. Регистрирует обработчики событий «іехііприі», «ІехІІприі» и «кеу- 
ргевв» для всех найденных элементов и ограничивает возможность ввода симво¬ 
лами, перечисленными в атрибуте гіа1:а-а11омес1-сЬаг8. Первый комментарий в на¬ 
чале примера 17.6 включает образец разметки НТМЬ, использующей этот модуль. 

Пример 17.6. Фильтрация ввода пользователя 
/ * * 

* Іпріі1:Рі11:ег. фильтрация ввода для элементов <іпріі1:> 

* 

* Этот модуль отыскивает все элементы <іпрц{ Іуре="1:ехІ"> в документе, имеющие 

* атрибут "с1а1:а-а11о\ѵес1-сИаг5". Регистрирует обработчики событий кеургеББ, {ехНпрцІ: 

* и {ехИпрііІ: для этих элементов, чтобы ограничить набор допустимых для ввода символов, 

* чтобы разрешить вводить только символы, указанные в атрибуте. Если элемент <іпріі1:> 

* также имеет атрибут "с1аі:а-те88адеісГ, значение этого атрибута интерпретируется как ісі 

* другого элемента документа. Если пользователь вводит недопустимый символ, элемент 

* с указанным іР делается видимым. Если пользователь вводит допустимый символ, элемент 

* с сообщением скрывается. Данный элемент с сообщением предназначается для вывода 

* пояснений, почему ввод пользователя был отвергнут. Его оформление необходимо 

* реализовать с помощью С85 так, чтобы изначально он был невидим. 

* 

* Ниже приводится образец разметки НТМІ_, использующей этот модуль. 

* 2ірсоРе: <іпріі1: іР=" 2 ір” *уре="*ех*" 

* Ра*а-а11о\ѵеР-сНаг5="0123456789" Раіа-те55адеіР="2ірмагп"> 

* <5рап іР=" 2 ірмагп" 8І:у1е="со1ог: геР; ѵіБіЬіШуіНіРРеп'^Только цифры</8рап> 

* 

* Этот модуль полностью реализован в ненавязчивом стиле: он не определяет 

* никаких переменных в глобальном пространстве имен. 

*/ 

\ѵНепРеаРу(Гітс1:іоп () { // Вызовет эту функцию, когда документ будет загружен 
// Отыскать все элементы <іпрц*> 

ѵаг іпрц*е1*8 = РосцтепІ.деШетепІБВуТадМатеС'іприІ:"); 

// Обойти их в цикле 

Гог(ѵаг і = 0 ; і < іпрц*е1*8. ІепдігН; і++) { 
ѵаг еіі: = іпріі*еН8[і]; 

// Пропустить элементы, не являющиеся текстовыми полями ввода 
// и не имеющие атрибута Раі:а-а11омеР-сНаг5. 

іГ (еіі.іуре != "Іехі:” || !еіг.дегА«гіЬцІе("Рага-а11о^еР-сІіаг8")) 
сопііпііе; 

// Зарегистрировать наш обработчик события в этом элементе іпрці: 

// кеургезз - старое событие и реализовано во всех броузерах. 

// Іехііпрііі: (смешанный регистр символов) поддерживается в ЭаГагі 
// и СНготе с 2010 года. 

// Іехііпрііі: (все символы строчные) - версия проекта 
// стандарта "00М І_еѵе1 3 Еѵепіз". 
іГ (еіі:.асІсІЕѵепІІлБІепег) { 

еИ.аРРЕѵеп1:Еі8І:епег("кеурге85", Гііігег, ГаІБе): 
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еІР.ас1с1ЕѵепРІ_і5Репег('’РехРІприР", РіІРег, Раізе); 
еІР. асЮЕѵепРІлзРепегС'рехРіпрцр", РіІРег, Раізе); 

} 

// РехРіпрцр не поддерживается версиями ІЕ, в которых не реализован 
// метод ас!с1ЕѵепРІ_і5Репег() 
еізе { 

еІР.аРРасНЕѵепр(”опкеурге55", РіІРег); 

} 

} 

// Обработчик событий кеурге$5 и РехРіпрцр, фильтрующий ввод пользователя 
РцпсРіоп РіІРег(еѵепР) { 

// Получить объект события и целевой элемент РагдеР 
ѵаг е = еѵепр || и/іпсіохѵ.еѵегѵі;; // Модель стандартная или ІЕ 

ѵаг РагдеР = е.РагдеР || е.згсЕІетепР; // Модель стандартная или ІЕ 
ѵаг РехР = пііП; // Введенный текст 

// Получить введенный символ или текст 

іР (е.Руре === "РехРіпріір'' || е.Руре === "РехРіпрцр") РехР = е.йаРа; 
еізе { // Это было событие кеургезз 

// Введенный печатаемый символ в РігеРох сохраняется в свойстве сНагСойе 
ѵаг сосіе = е.сНагСойе || е.кеуСойе; 

// Если была нажата какая-либо функциональная клавиша, не фильтровать ее 
ІР (сойе < 32 || // Управляющий символ А8СІІ 

е.сНагСойе == 0 || // Функциональная клавиша (в РігеРох) 

е.сРгІКеу || е.аІРКеу) // Удерживаемая клавиша-модификатор 
герцгп; // Не фильтровать это событие 

// Преобразовать код символа в строку 
ѵаг Тех! = ЭРгіпд. РготСНагСосІе(сосІе); 

} 

// Отыскать необходимую нам информацию в этом элементе іприТ: 
ѵаг аііохѵесі = РагдеР. деРАРРгіЬцРеС’сІаРа-аІІомесІ-сНагз"); // Допустимые символы 
ѵаг теззадеісі = РагдеР. деРАРРгіЬцРе("с1аРа-те55адеісГ); // Сообщение ісі 
іР (теззадеіс!) // Если указано значение ісі, получить элемент 
ѵаг теззадеЕІетепР = сіосцтепР.деРЕ1етепРВуІсі(те55адеісі); 

// Обойти в цикле символы во введенном тексте 
Рог(ѵаг і = 0; і < РехР.ІепдРН; і++) { 
ѵаг с = Тех*. сНагАР(і); 

ІР (аііомесі. іпсІехОР(с) == -1) { // Недопустимый символ? 

// Отобразить элемент с сообщением, если указан 
ІР (теззадеЕІетепР) теззадеЕІетепі.зруіе.ѵі5іЬі1іРу="ѵі5іЫе"; 

// Отменить действия по умолчанию, чтобы предотвратить вставку текста 
ІР (е.ргеѵепРОеРацІР) е.ргеѵепРОеРацІР(); 
іР (е. геРіігпѴаІііе) е. геРцгпѴаІце = Раізе; 
герцгп Раізе; 

} 

} 

// Если все символы оказались допустимыми, скрыть элемент 
// с сообщением, если он был указан. 

іР (теззадеЕІетепР) теззадеЕІетепР.зруіе.ѵізіЬШРу = "Місісіеп"; 

} 

}); 
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События «кеургевз* и «іехііприі» генерируются непосредственно перед фактиче¬ 
ской вставкой нового текста в элемент документа, обладающий фокусом ввода, 
благодаря чему обработчики этих событий могут предотвратить вставку текста, 
отменив событие. Броузеры также реализуют событие «три!*, которое возбуж¬ 
дается после вставки текста в элемент. Это событие нельзя отменить и соответст¬ 
вующий ему объект события не содержит информации о вставленном тексте - 
оно просто извещает о том, что текстовое содержимое элемента изменилось. Если, 
к примеру, потребуется обеспечить ввод только символов в верхнем регистре, 
можно определить обработчик события «іприі», как показано ниже: 

51ШАМЕ: <іпріі1: *уре="*ех*" опіпри1;="1;Гііз . ѵаіие = Шб. ѵаіііе. 1:оІ)ррегСазе( ); "> 

Событие «іприі» стандартизовано в спецификации НТМЬб и поддерживается все¬ 
ми современными броузерами, кроме ІЕ. Похожего эффекта в ІЕ можно добиться, 
обнаруживая изменение значения свойства ѵаіие текстового элемента ввода с по¬ 
мощью нестандартного события «ргорегіусЬап&е*. В примере 17.7 демонстрирует¬ 
ся, как можно реализовать преобразование всех вводимых символов в верхний 
регистр переносимым образом. 

Пример 17.7. Использование события «ргорегІусНапде» для определения 

факта ввода текста 

Гітсііоп ГогсеТоиррегСа5е(е1етеп1:) { 

ІТ (іуреоГ еіетепі: === "Бігіпд") е1етеп1:=с1осіітепі:.де1:Е1етеп1:ВуІс1(е1етеп1:); 
еіетепі:. опіпрьі: = іірсазе; 

еіетепі:. опргореПусМапде = іірсазеОпРгорегіуСИапде; 

// Простой случай: обработчик события іпрііі: 

Гипсііоп іірса5е(еѵеп1:) { ІИіб. ѵаіие = 1 :Иіб. ѵаіие. 1:оиррегСа5е(); } 

// Сложный случай: обработчик события ргорегіусйапде 
Гипсііоп ирса5е0пРгорегі:уСИапде(еѵеп1:) { 
ѵаг е = еѵепі: || \ѵіпс!о\ѵ. еѵепі; 

// Если значение свойства ѵаіие изменилось 
ІГ (е. ргореПуМате === "ѵаіие") { 

// Удалить обработчик опргорегіусйапде, чтобы избежать рекурсии 
ійіб. опргорегіусйапде = пьП; 

// Преобразовать все символы в верхний регистр 
Шб. ѵаіие = Шз. ѵаіие. ІоУррегСаБеС): 

// И восстановить обработчик события ргорегіусйапде 
Шб. опргорегіусИапде = ирсаБеОпРгорегІуСІіапде; 

} 

} 

} 

17.9. События клавиатуры 

События «кеусіолѵп* и «кеуир» возбуждаются, когда пользователь нажимает или 
отпускает клавишу на клавиатуре. Они генерируются для клавиш-модификато¬ 
ров, функциональных клавиш и алфавитно-цифровых клавиш. Если пользова¬ 
тель удерживает клавишу нажатой настолько долго, что включается режим ав¬ 
топовтора, будет сгенерировано множество событий «кеусіодѵп*, прежде чем по¬ 
явится событие «кеуир*. 
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Объект события, соответствующий этим событиям, имеет свойство кеуСосІе с чи¬ 
словым значением, которое определяет нажатую клавишу. Для клавиш, генери¬ 
рующих печатаемые символы, в общем случае свойство кеуСосІе содержит кодо¬ 
вый пункт Юникода, соответствующий основному символу, изображенному на 
клавише. Клавиши с буквами всегда генерируют значения кеуСосІе, соответствую¬ 
щие символам в верхнем регистре, независимо от состояния клавиши 5ЫЛ, по¬ 
скольку именно такие символы изображены на клавишах. Аналогично цифро¬ 
вые клавиши всегда генерируют значения кеуСосІе, соответствующие цифровым 
символам, изображенным на клавишах, даже если при этом вы удерживали на¬ 
жатой клавишу 5НІЛ, чтобы ввести знак препинания. Для клавиш, не соответст¬ 
вующих печатаемым символам, свойство кеуСосІе будет иметь некоторое другое 
значение. Эти значения свойства кеуСосІе никогда не были стандартизованы. Од¬ 
нако в разных броузерах они отличаются не настолько сильно, чтобы нельзя бы¬ 
ло обеспечить переносимость. Это демонстрирует пример 17.8, включающий реа¬ 
лизацию отображения значений кеуСосІе в имена функциональных клавиш. 

Подобно объектам событий мыши, объекты событий клавиатуры имеют свойства 
аІІіКеу, сІігІКеу, теІіаКеу и зІііІ+Кеу, которые получают значение Іігие, если в момент 
возникновения события удерживалась нажатой соответствующая клавиша-мо¬ 
дификатор. 

События «кеусіодѵп» и «кеуир», а также свойство кеуСосІе используются уже более 
десяти лет, но они так и не были стандартизованы. Проект стандарта «ПОМ Ьеѵеі 3 
Еѵепіз» стандартизует типы «кеуболѵп» и «кеуир* событий, но не стандартизует 
свойство кеуСосІе. Вместо этого он определяет новое свойство кеу, которое должно 
содержать название клавиши в виде строки. Если клавиша соответствует печа¬ 
таемому символу, свойство кеу должно содержать этот печатаемый символ. Для 
функциональных клавиш свойство кеу должно содержать такие значения, как 
«Е2», «Ноте* или «ЬеН». 

На момент написания этих строк свойство кеу, определяемое стандартом «БОМ 
Ьеѵеі 3 Еѵепіз», еще не было реализовано ни в одном из броузеров. Однако броузе¬ 
ры на базе механизма ^еЪкіі, 8а^агі и СЬготе определяют в объектах этих собы¬ 
тий свойство кеуІсІепііі'Гіег. Для функциональных клавиш, подобно свойству кеу, 
свойство кеуІсІепііШег содержит не число, а строку с именем клавиши, таким как 
«8ЫН» или «Епіег». Для клавиш, соответствующих печатаемым символам, это 
свойство содержит менее удобное в использовании строковое представление кодо¬ 
вого пункта Юникода символа. Например, клавише «А» соответствует значение 
«11+0041». 

В примере 17.8 определяется класс Кеу тар, который отображает идентификаторы 
комбинаций клавиш, такие как «Ра&еЬГр», «А1і_2» и «сігІ+аІі+зІіШ+Гб» в функ¬ 
ции на языке ^ѵаЗсгірі, вызываемые в ответ на нажатия этих комбинаций. Оп¬ 
ределения привязок клавиш передаются конструктору КеутарО в форме объекта 
Лѵабсгірі, имена свойств которого соответствуют идентификаторам комбинаций 
клавиш, а значения этих свойств содержат ссылки на функции-обработчики. До¬ 
бавление и удаление привязок осуществляется с помощью методов РіпсІ() 
и ипЬіпсК ). Устанавливается объект Кеу тар в НТМЬ-элемент (обычно в объект Иоси- 
тепі:) с помощью метода іпз1:а11(). При установке объекта Кеутар в этом элементе 
регистрируется обработчик события «кеуйодѵп». Каждый раз, когда нажимается 
клавиша, обработчик проверяет наличие функции, соответствующей этой ком¬ 
бинации. Если функция существует, она вызывается. Обработчик события «кеу- 
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сіолѵп* использует свойство кеу, определяемое стандартом «БОМ Ьеѵеі 3 Еѵепіз», 
если оно существует. В противном случае он пытается использовать АѴеЪкіі-свой- 
ство кеуІсІепШіег. И как запасной вариант, обработчик использует нестандартно^ 
свойство кеуСосіе. Пример 17.8 начинается с длинного комментария, подробно опи¬ 
сывающего работу модуля. 

Пример 17,8. Класс Кеу тар для обработки нажатий комбинаций клавиш 

Л 

* Кеутароз: связывает события клавиатуры с функциями-обработчиками. 

* 

* Этот модуль определяет класс Кеутар. Экземпляр этого класса представляет 

* собой отображение идентификаторов комбинаций клавиш (определяемых ниже) 

* в функции-обработчики. Объект Кеутар можно установить в НТМ1_-элемент 

* для обработки событий кеуромп. Когда возникает это событие, объект Кеутар 

* использует свою карту привязок для вызова соответствующего обработчика. 

* 

* При создании объекта Кеутар конструктору можно передать ЭаѵаЗсгірІ-объект, 

* представляющий начальную карту привязок. Имена свойств этого объекта должны 

* соответствовать идентификаторам клавиш, а значениями должны быть функции-обработчики. 

* После создания объекта Кеутар в него можно добавлять новые привязки, передавая 

* идентификатор клавиши и функцию-обработчик методу ЬіпсК). Имеется также возможность 

* удалить привязку, передав идентификатор клавиши методу цпЬіпсК). 

* 

* Чтобы задействовать объект Кеутар, следует вызвать его метод іпзІаІІО, передав ему 

* НТМ1_-элемент, такой как объект РосцтеШ:. Метод іпзіаіі () добавит в указанный объект 

* обработчик события опкеуРомп. Когда этот обработчик будет вызван, он определит 

* идентификатор нажатой клавиши и вызовет функцию-обработчик (если таковая имеется), 

* привязанную к этому идентификатору клавиши. Один и тот же объект Кеутар 

* можно установить сразу в несколько НТМІ_-элементов. 

* 

* Идентификаторы клавиш 

* 

* Идентификатор клавиши - это нечувствительная к регистру символов строка, 

* представляющая клавишу, плюс любое количество удерживаемых нажатыми 

* клавиш-модификаторов. Именем клавиши является основной текст, изображаемый 

* на клавише. Допустимыми именами клавиш являются: "А", ’7", ”Р2”, "РадеОр", 

* ЧеП". "Васкзрасе" и Чзс". 

* 

* Список имен находится в объекте Кеутар.кеуСоРеТоКеуМате, внутри этого модуля. 

* Они являются подмножеством имен, определяемых стандартом ЧОМ І_еѵе1 3". 

* Кроме того, этот класс будет использовать свойство кеу, когда оно будет реализовано. 

* 

* Идентификатор клавиши может также включать имена клавиш-модификаторов. 

* Это имена АН, С*г1, Меіа и 5ЫГ1:. Они нечувствительны к регистру символов и должны 

* отделяться от имени клавиши и друг от друга пробелами или подчеркиваниями, дефисами 

* или знаками +. Например: "5НІРТ+А”, "А11_Р2 И , "шеіа-ѵ" и "сігі аіі: ІеМ". 

* В компьютерах Мае клавише Меіа соответствует клавиша СоттапР, а клавише А11: - 

* клавиша Орііоп. Некоторые броузеры отображают клавишу МіпРомз в клавишу Ме1:а. 

* 

* Функции-обработчики 

* 

* Обработчики вызываются как методы объекта Росіітепі: или элемента документа, 

* в зависимости от того, куда был установлен объект Кеутар, и им передаются 
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* два аргумента: 

* 1) объект события кеусіомп 

* 2) идентификатор нажатой клавиши 

* Значение, возвращаемое функцией, становится возвращаемым значением 

* обработчика события кеусіоѵт. Если функция-обработчик вернет Шзе, 

* объект Кеутар прервет всплытие события и предотвратит выполнение любых 

* действий по умолчанию, связанных с событием кеусіомп. 

* 

* Ограничения 

* 

* Функцию-обработчик можно привязать не ко всем клавишам. Некоторые комбинации 

* используются самой операционной системой (например, АИ-Р4). А некоторые комбинации 

* могут перехватываться броузером (например, Сігі-З). Эта реализация зависит 

* от особенностей броузера, ОС и региональных настроек. Вы с успехом можете 

* использовать функциональные клавиши и функциональные клавиши с модификаторами, 

* а также алфавитно-цифровые клавиши без модификаторов. Комбинации алфавитно-цифровых 

* клавиш с модификаторами Сігі и А11: менее надежны. 

* 

* Поддерживается большинство знаков препинания, кроме дефиса, для ввода которых 

* не требуется удерживать клавишу ЭЬіРІ: ('=[];',./\) на клавиатурах 

* со стандартной раскладкой 11$. Но они плохо совместимы с другими 

* раскладками клавиатур, и их желательно не использовать. 

*/ 

// Функция-конструктор 
Рііпсііоп Кеутар(Ьіпс1іпд5) { 

Шз.тар = {}; // Определить отображение идентификатор->обработчик 

іР (Ьіпсііпдз) { // Скопировать в него начальную карту привязок 
Рог(пате іп Ьіпсііпдз) Шз. Ьіпсі(пате, Ьіпс1іпдз[ пате ]): 

} 

} 

// Связывает указанный идентификатор клавиши с указанной функцией-обработчиком 
Кеутар. ргоШуре. Ьіпсі = Рітс1:іоп(кеу. Рітс) { 

Шз. тар[ Кеутар. погта1і2е(кеу)] = Рцпс; 

>; 


// Удаляет привязку для указанного идентификатора клавиши 
Кеутар.ргоШуре. ііпЬіпсі = Рітс1:іоп(кеу) { 
сіеіеіе Шз.тар[Кеутар. погтаНге(кеу)]; 

}; 


// Устанавливает этот объект Кеутар в указанный НТМІ_-элемент 
Кеутар. ргоШуре. іпзШІ = Рітс1:іоп(е1етеп1:) { 
ѵаг кеутар = Шз; 

// Определить функции-обработчика события 

Рішсііоп Ьапс11ег(еѵепі:) { геііігп кеутар.Різра1:сЬ(еѵепі:, еіетепі); } 

// Установить ее 
іХ (еіетепі.асісіЕѵепШзіепег) 

еІетепі.асІсІЕѵепіІізіепегС’кеусІо^п", Ьапсііег, Шзе); 
еізе іР (еІетепІ.аііасЬЕѵепІ:) 

еіетепі.аііасЬЕѵепіС'опкеуЬо^п", Ьапсііег); 


// Этот метод делегирует обработку события клавиатуры, опираясь на привязки. 
Кеутар.ргоШуре. сІізраісЬ = Рцпс*іоп(еѵеп*, еіетепі) { 
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// Изначально нет ни имен клавиш-модификаторов, ни имени клавиши 
ѵаг тосІіГіегз = 
ѵаг кеупате = пціі; 

// Сконструировать строки модификаторов в каноническом виде из символов 
// в нижнем регистре, расположив их в алфавитном порядке. 
іГ (еѵепГ.аІГКеу) тосІШегз += "а1Г_"; 
іГ (еѵепГ.сГгІКеу) тосІШегз += "сГг1_"; 

ІГ (еѵепГ.теГаКеу) тосІШегз += "теГа_"; 

ІГ (еѵепГ. зМіГГКеу) тосІіГіегз += "зМіГГ_”; 

// Имя клавиши легко получить, если реализовано свойство кеу, 

// определяемое стандартом йОМ І_еѵе1 3: 
іГ (еѵепГ.кеу) кеупате = еѵепГ.кеу; 

// Для получения имен функциональных клавиш в ЗаГагі и СМготе можно 
// использовать свойство кеуІсІепГіГіег 

еізе іГ(еѵепГ. кеуІс!епГіГіег&&еѵепГ. кеуІсІепГіГіег. зыЬзГгіпдСО, 2) !== "11+") 
кеупате = еѵепГ. кеуІсІепГіГіег; 

// В противном случае можно использовать свойство кеуСосІе и отображение код->имя ниже 
еізе кеупате = Кеутар. кеуСос!еТоКеуМате[ еѵепГ. кеуСосІе]; 

// Если имя клавиши не удалось определить, просто проигнорировать событие 
// и вернуть управление. 
іГ (!кеупате) геГцгп; 

// Канонический идентификатор клавиши состоит из имен модификаторов 

// и имени клавиши в нижнем регистре 

ѵаг кеуісі = тосІіГіегз + кеупате. Го 1_омегСазе(); 

// Проверить, имеется ли привязка для данного идентификатора клавиши 
ѵаг МапсІІег = ГМіз.тар[кеуісІ]; 

іГ (МапсІІег) { // Если обработчик для данной клавиши, вызвать его 
// Вызвать функцию-обработчик 
ѵаг геГѵаІ = МапсИег.саЩеІетепТ, еѵепГ, кеуісі); 

// Если обработчик вернул Гаізе, отменить действия по умолчанию 
// и прервать всплытие события 
іГ (геГѵаІ === Гаізе) { 

іГ (еѵепГ.зГорРгорадаГіоп) еѵепГ.зГорРгорадаГіоп(); // модель йОМ 
еізе еѵепГ.сапсеІВыЬЫе = Ггііе; // модель ІЕ 

іГ (еѵепГ.ргеѵепГОеГацІГ) еѵепГ.ргеѵепТОеГаііЩ); // йОМ 

еізе еѵепГ. геГіігпѴаІііе = Гаізе; // ІЕ 

} 

// Вернуть значение, полученное от обработчика 
геГыгп геГѵаІ; 

} 

}; 

// Вспомогательная функция преобразования идентификатора клавиши в каноническую форму. 
// Нам необходимо преобразовать идентификатор "теГа” в "сГгІ", чтобы превратить 
// идентификатор МеГа-С в "СоттапР-С" на компьютерах Мае и в "СГгІ-С" на всех остальных. 
Кеутар.погтаііге = ГцпсГіоп(кеуіР) { 

кеуіР = кеуіР. ГоІ_омегСазе(); // В нижний регистр 

ѵаг могсіз = кеуіР. зрПГ(/\з+| [\-+_]/); // Вычленить модификаторы 

ѵаг кеупате = могсІз.рорО; // кеупате - последнее слово 
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кеупате = Кеутар.а1іазез[кеупате] || кеупате; // Это псевдоним? 

могсіз. зогр(); // Сортировать модификаторы 

могсіз. ризИ(кеупате); // Поместить обратно 

// нормализованное имя 

геТыгп ѵюгсіз. і оіп("_"); // Объединить все вместе 

}; 

Кеутар.аііазез = { // Отображение привычных псевдонимов клавиш в их 

"езсаре" :"езс", // "официальные" имена, используемые в йОМ І_еѵе1 3, 

"сІеІеТе" : "сіеі", // и отображение кодов клавиш в имена ниже. 

"герцгп”:"епТег", // Имя и значение должны состоять только из символов 
"сРгІ" : "сопРгоГ’, // нижнего регистра. 

"зрасе":"зрасеЬаг", 

"іпз" : "іпзегр" 


: А , 

66: "В". 

67:"С". 

68:"0", 

69:"Е", 

70:"Р". 

71:"С", 

72:''Н”, 

73:"І", 

•• * 

: ^ , 

75: "К". 

76 

77:"М", 

78: "Г, 

79:"0", 

80:"Р", 

81:"0", 

82: "В". 

:”5", 

84:"Т", 

85: "11", 

86:"V", 

87:"М", 

88:"X". 

89:"У", 

90: "Г, 



// Старое свойство кеуСоРе объекта события кеусіомп не стандартизовано 

// Но следующие значения с успехом могут использоваться в большинстве броузеров и ОС, 

Кеутар. кеуСосІеТоКеуМате = { 

// Клавиши со словами или стрелками на них 

8:"Васкзрасе", 9:"ТаЬ”, 13:"Еп1:ег”, 16:"5ЫР{", 17: "СопТгоІ", 18:"А1Т", 
19:"Рацзе”, 20:"Сарз1оск", 27:"Езс", 32:"ЗрасеЬаг", ЗЗГРадеЦр", 

34:"РадеОомп", 35: "ЕпсІ”, 36:"Ноте", 37: "І_еП", 38:"Ор". 39:"ИідМ:", 

40:"Оомп", 45: "Іпзегі:". 46:"0е1", 

// Цифровые клавиши на основной клавиатуре (не на дополнительной) 

48:"О",49:"1",50:"2",51:"3",52:"4",53:"5",54:"6",55:"7",56:"8",57:"9". 

// Буквенные клавиши. Обратите внимание, что здесь не различаются 
// символы верхнего и нижнего регистров 
65 
74 
83 

// Цифровые клавиши на дополнительной клавиатуре и клавиши со знаками препинания, 
// (Не поддерживаются в Орега.) 

96:"О", 97:"1".98:"2",99:"3",100:"4",101:"5",102:”6",103:"7",104:"8", 

105: ”9". 106: "МиІНірІу", 107:"АсІсГ, 109: "ЗиМігасІ:", 110: "Оесітаі", 

111: "йіѵісіе", 

// Функциональные клавиши 

112:"Р1", 113:"Р2", 114:"РЗ", 115:"Р4". 116:"Р5", 117:"Р6", 

"Р7", 119:"Р8", 120:"Р9", 121:"РІО", 122:"Р11", 123:"Р12“, 

Р13", 125:"Р14", 126:"Р15", 127:"Р16", 128:"Р17", 129:"Р18", 

"Р19", 131:"Р20", 132:"Р21", 133:"Р22”, 134:"Р23". 135:"Р24". 

// Клавиши со знаками препинания, для ввода которых не требуется 
// удерживать нажатой клавишу ЗЫР*. 

// Дефис не может использоваться переносимым способом: РР возвращает 
// тот же код, что и для клавиши ЗыЬіігасІ: 

59:";”, 61:"=", 186:";", 187:"=", // РігеРох и Орега возвращают 59,61 

188:",", 190:".", 191:"/", 192:., 219:"[", 220:"\\", 221:"]", 222:. 


112: 

"Р1", 

118: 

"Р7", 

124: 

"Р13", 

130: 

"Р19", 
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Работа с протоколом НТТР 


Протокол передачи гипертекста (Нурегіехі Тгапеіег Ргоіосоі, НТТР) определяет, 
как веб-броузеры должны запрашивать документы, как они должны передавать 
информацию веб-серверам и как веб-серверы должны отвечать на эти запросы 
и передачи. Очевидно, что веб-броузеры очень много работают с протоколом НТТР. 
Тем не менее, как правило, сценарии не работают с протоколом НТТР, когда поль¬ 
зователь щелкает на ссылке, отправляет форму или вводит ІЖЬ в адресной строке. 

Однако Лѵа8сгірі-код способен работать с протоколом НТТР. НТТР-запросы мо¬ 
гут инициироваться, когда сценарий устанавливает значение свойства Іосаіііоп 
объекта ілііпсіом или вызывает метод зиЬті1:( ) объекта Рогт. В обоих случаях броузер 
загружает в окно новую страницу. Такого рода взаимодействие с протоколом 
НТТР может быть вполне оправданным в веб-страницах, состоящих из несколь¬ 
ких фреймов, но в этой главе мы будем говорить совсем о другом. Здесь мы рас¬ 
смотрим такое взаимодействие ^ѵа8сгірі-кода с веб-сервером, при котором веб¬ 
броузер не перезагружает содержимое окна или фрейма. 

Термин А]ах описывает архитектуру веб-приложений, отличительной чертой ко¬ 
торых является работа с протоколом НТТР. 1 Ключевой особенностью Аіах-прило- 
жения является использование протокола НТТР для инициации обмена данными 
с веб-сервером без необходимости перезагружать страницу. Возможность избе¬ 
жать перезагрузки страницы (что было привычным на первых этапах развития 
Всемирной паутины) позволяет создавать веб-приложения, близкие по своему по¬ 
ведению к обычным приложениям. Веб-приложение может использовать техноло¬ 
гии Азах для передачи на сервер результатов взаимодействия с пользователем или 


1 Аіах - это аббревиатура от АзупсЪгопоиз ^ѵаЗсгірі агкі ХМЬ (асинхронный ^ѵа8сгір! 
и ХМЬ). Этот термин предложил Джесси Джеймс Гаррет ^еззе ^тез Саггеи) и впер¬ 
вые использовал его в своей статье «Аіах: А №\ѵ АрргоасЬ Іо \ѴеЪ Арріісаііопз» в февра¬ 
ле 2005 года /хюхюхю. а&арііѵераіУі. сот/риЪИсаИопв/евваув/ агсЫѵев/ 000385. р\ір) (От 

переводчика: перевод этой статьи на русский язык можно найти по адресу Ніір://§аІІео. 
ги/агІісІев/іѵІбО.). В течение многих лет термин «Аіах» был громким словом, которое 
употребляли к месту и не к месту, а сейчас это всего лишь удобный термин, обозначаю¬ 
щий архитектуру веб-приложения, опирающегося в своей работе на НТТР-запросы. 




для ускорения запуска приложения, отображая сначала простую страницу и под¬ 
гружая дополнительные данные и компоненты страницы по мере необходимости. 

Термин Сотеі описывает похожую архитектуру веб-приложений, также исполь¬ 
зующих протокол НТТР. 1 В некотором смысле архитектура Сотеі является обрат¬ 
ной по отношению к Азах: в архитектуре Сотеі не клиент, а сервер инициирует 
взаимодействие, асинхронно отсылая сообщения клиенту. Если веб-приложению 
потребуется отвечать на сообщения, отправляемые сервером, оно сможет исполь¬ 
зовать приемы Азах для отправки или запроса данных. В архитектуре Азах кли¬ 
ент «вытягивает» данные с сервера. В архитектуре Сотеі сервер «навязывает» 
данные клиенту. Иногда архитектуру Сотеі называют «Зегѵег РизЬ», «Азах РизЬ» 
и «НТТР Зігеапгіп#». 

Есть множество способов реализации архитектур Азах и Сотеі, и эти базовые 
реализации иногда называют транспортами . Элемент <ітд>, например, имеет 
свойство зге. Когда сценарий записывает в это свойство ІЖЬ-адрес, инициирует¬ 
ся НТТР-запрос СЕТ и выполняется загрузка содержимого с этого ІЖЬ-адреса. 
Таким образом, сценарий может отправлять информацию веб-серверу, добавляя 
ее в виде строки запроса в ІЖЬ-адрес изображения и устанавливая свойство зге 
элемента <ітд>. В ответ на этот запрос веб-сервер должен вернуть некоторое изо¬ 
бражение, которое, например, может быть невидимым: прозрачным и размером 
1x1 пиксел. 2 

Элемент <ітд> - не самый лучший транспорт Азах, потому что обмен данными ве¬ 
дется только в одном направлении: клиент может передать данные серверу, но 
ответом сервера всегда будет изображение, извлечь информацию из которого на 
стороне клиента очень непросто. Элемент <іігате> обладает большей гибкостью. 
При использовании элемента <іігате> в качестве транспорта Азах сценарий снача¬ 
ла добавляет в ІЖЬ-адрес информацию, предназначенную для веб-сервера, а за¬ 
тем записывает этот ІЖЬ-адрес в свойство зге тега <іігате>. Сервер создает НТМЬ- 
документ, содержащий ответ на запрос, и отправляет его обратно веб-броузеру, 
который выводит ответ в теге <іігате>. При этом элемент <іігате> необязательно 
должен быть видимым для пользователя - он может быть сокрыт, например, 
средствами таблиц стилей С88. Сценарий может проанализировать ответ серве¬ 
ра, выполнив обход документа в элементе <і1тате>. Обратите внимание, что взаи¬ 
модействие с документом ограничивается политикой общего происхождения, 
о которой рассказывается в разделе 13.6.2. 

Даже изменение свойства зге элемента <зсгірі:> может использоваться для иниции¬ 
рования НТТР-запроса СЕТ. Использование элементов <зсгірі:> для работы с про¬ 
токолом НТТР выглядит особенно привлекательно, потому что они не являются 
субъектами политики общего происхождения и могут использоваться для взаи¬ 
модействий с разными серверами. Обычно при использовании транспорта Азах 


1 Имя Сотеі было предложено Алексом Расселом (Аіех Киззеіі) в статье «Сотеі: Ьолѵ Ьа- 
іепсу Эаіа іог іЬе Вголѵзег» (Ніір://іп{ ! гедиепі1у.ог8/2006/03/сотеі-1оіѵ-1аіепсу-с1аіа-/ог- 
іке-Ьгоіѵзег/). Вероятно, выбирая такое имя, Алекс Рассел хотел обыграть термин Азах: 
дело в том, что в США Сотеі и Азах являются названиями чистящих средств. 

2 Такие изображения иногда называют веб-жучками (теЬ Ьидз). Они пользуются дурной 
славой из-за проблем с безопасностью, когда используются для обмена информацией 
со сторонним сервером, не тем, откуда была загружена страница. Одно из типичных 
применений веб-жучков - подсчет числа посещений и анализа трафика веб-сервера. 
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на основе элемента <зсгір1:> ответ сервера имеет вид данных в формате ^СЖ (раз¬ 
дел 6.9), которые автоматически «декодируются», когда содержимое элемента 
<зсгір1:> выполняется интерпретатором ЛѵаВсгірі. Из-за использования формата 
данных ^СЖ этот транспорт Азах получил название «^СЖР». 

Хотя архитектура Азах может быть реализована поверх транспорта <іГгаше> или 
<зсгір1:>, существует более простой путь. Уже достаточно давно все броузеры ста¬ 
ли поддерживать объект ХМЫНІііірРедиезІ:, определяющий прикладной интерфейс 
для работы с протоколом НТТР. Этот интерфейс обеспечивает возможность вы¬ 
полнять Р08Т-запросы в дополнение к обычным СЕТ-запросам и может возвра¬ 
щать ответ веб-сервера синхронно или асинхронно, в виде простого текста или 
в виде объекта Оосишепі:. Несмотря на свое название, объект ХМЫНІіІірРедиезІ: не огра¬ 
ничивается использованием ХМЬ-документов - он в состоянии принимать любые 
текстовые документы. Прикладной интерфейс объекта ХМЫНІіІірРедиезІ: рассматри¬ 
вается в разделе 18.1, который занимает значительную часть главы. Большая 
часть примеров реализации архитектуры Азах в этой главе в качестве транспорта 
использует объект ХМЫНІіІірРедиезІ:, но в разделе 18.2 также будет показано, как ис¬ 
пользовать транспорт на основе элемента <зсгір1;>, так как он способен обходить 
ограничения политики общего происхождения. 

Транспортные механизмы в архитектуре Сотеі сложнее, чем в архитектуре Азах, 
но все они требуют установления (и восстановления, в случае необходимости) со¬ 
единения с сервером со стороны клиента и обязывают сервер поддерживать соеди¬ 
нение открытым, чтобы через него можно было отправлять асинхронные сообще¬ 
ния. Транспортом в архитектуре Сотеі может служить, например, скрытый эле¬ 
мент <іГгате>, если сервер отправляет сообщения в виде элементов <зсгіріі>, выпол¬ 
няемых в элементе <іГгате>. Более надежный и переносимый подход к реализации 
архитектуры Сотеі заключается в том, чтобы клиент устанавливал соединение 
с сервером (используя Азах-транспорт), а сервер поддерживал это соединение от¬ 
крытым, пока имеется необходимость отправлять сообщения. Каждый раз, когда 
сервер отправляет сообщение, он закрывает соединение, что позволяет гарантиро¬ 
вать благополучное получение сообщения клиентом. После обработки сообщения 
клиент может сразу же установить новое соединение для будущих сообщений. 

Реализация надежного и переносимого транспорта для архитектуры Сотеі явля¬ 
ется сложной задачей, и большинство веб-разработчиков, использующих архи¬ 
тектуру Сотеі, опираются на транспорты, реализованные в веб-фреймворках, 
таких как Бозо. На момент написания этих строк производители броузеров при¬ 
ступили к реализации положений проекта спецификации «8егѵег-8епі Еѵепіз», 
связанной со стандартом НТМЬб, которая определяет простой прикладной ин¬ 
терфейс для архитектуры Сотеі в виде объекта ЕѵепііЗоигсе. Интерфейс объекта 
ЕѵепіЗоигсе будет рассматриваться в разделе 18.3 и там же будет продемонстриро¬ 
вана простая его имитация на основе объекта ХМЫНІіІірРедиезІ:. 

Имеется также возможность конструировать высокоуровневые протоколы взаи¬ 
модействий поверх Азах и Сотеі. Эти приемы организации взаимодействий типа 
клиент/сервер можно использовать, например, в качестве основы механизма НРС 
(Кетоіе Ргосесіиге Саіі - вызов удаленных процедур) или системы событий типа 
издатель/подписчик. Однако в данной главе мы не будем рассматривать подоб¬ 
ные высокоуровневые протоколы, а сконцентрируемся на прикладных интер¬ 
фейсах поддержки архитектур Азах и Сотеі. 




18 . 1 . Использование объекта ХМШНрКедиез! 
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Использование ХМІ. не является обязательным 

Символ «X» в аббревиатуре «Азах» обозначает «ХМЬ». Основной приклад¬ 
ной интерфейс для работы с протоколом НТТР на стороне клиента (ХМІ_НИр- 
Редиезі:) также содержит название «ХМЬ» в своем имени, и, как мы узнаем 
далее, одно из свойств объекта ХМЬНіііірРедиезІ: имеет имя гезропзеХМЬ. Вслед¬ 
ствие этого может сложиться впечатление, что ХМЬ является важной ча¬ 
стью работы с протоколом НТТР. Но это не так: эти имена являются исто¬ 
рическим наследием тех дней, когда ХМЬ было модным словечком. Конеч¬ 
но, реализации Азах способны работать с ХМЬ-документами, но использо¬ 
вание формата ХМЬ является необязательным, и в действительности он 
редко используется не практике. Спецификация ХМЬНМрКециезі полна 
несоответствий в именах, с которыми нам придется сталкиваться: 

Имя объекта ХМІ_Н1:1:рРедие5І: было выбрано исходя из соображений совмес¬ 
тимости с Веб, хотя каждая часть этого имени может вводить в заблужде¬ 
ние. Во-первых, объект поддерживает любые текстовые форматы, вклю¬ 
чая ХМЬ. Во-вторых, он может использоваться для отправки запросов по 
обоим протоколам, НТТР и НТТР8 (некоторые реализации могут поддер¬ 
живать дополнительные протоколы, помимо НТТР и НТТР8, но эти воз¬ 
можности не регламентируются в спецификации). Наконец, он поддер¬ 
живает «запросы» («гециезіз») в более широком смысле, - как это подра¬ 
зумевает использование протокола НТТР. А именно, все операции, свя¬ 
занные с выполнением НТТР-запросов или получением НТТР-ответов 
для определенных НТТР-методов. 


18.1. Использование объекта ХМШНрКеяиезі 

Прикладной интерфейс к протоколу НТТР в броузерах определяется в виде класса 
ХМЬНіііірПедиезІ:. Каждый экземпляр этого класса представляет единственную пару 
запрос/ответ, а свойства и методы объекта позволяют определять параметры за¬ 
проса и извлекать данные из ответа. Объект ХМЫ-ИііірРедиезІ: поддерживается веб¬ 
броузерами уже довольно давно, а его прикладной интерфейс находится на послед¬ 
них стадиях стандартизации консорциумом ЛУЗС. В то же время в консорциуме 
ЛУЗС ведутся работы над проектом стандарта «ХМЬНМрКециезі Ьеѵеі 2». В этом 
разделе мы рассмотрим базовый прикладной интерфейс объекта ХМЫ-ИііірРедиезІ:, 
а также те части проекта стандарта «ХМЬНМрКециезі Ьеѵеі 2» (я называю его 
«ХНК2»), которые в настоящее время реализованы как минимум в двух броузерах. 

Первое, что обычно необходимо сделать при использовании этого прикладного ин¬ 
терфейса к протоколу НТТР, это, разумеется, создать экземпляр объекта ХМІ_НИр- 
Редиезі:: 

ѵаг гедиезі; = пе\л/ ХМІ_НирНедие5І:( ); 

Допустимо повторно использовать уже имеющийся экземпляр объекта ХМ1_Н11р- 
Редііезі:, но следует иметь в виду, что в этом случае будет прервано выполнение 
запроса, уже отправленного объектом. 
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ХМШПрКеяие$і в ІЕ6 

Корпорация включила поддержку объекта ХМЫНІіІірРедиезІ: в свой броузер ІЕ, 
начиная с версии 5. В версиях ІЕ5 и ІЕ6 этот объект доступен только в виде 
АсііѵеХ-объекта. Поддержка современного стандартного конструктора ХМІ_- 
НИрПедиезШ появилась только в ІЕ7, но его можно имитировать, как пока¬ 
зано ниже: 

// Имитация конструктора ХМЬНПрРедыезШ в ІЕ5 и ІЕ6 
іі (ѵѵіпсіоѵѵ. ХМІН1:1:рВедиеБІ: === ипсІеГіпесІ) { 
ѵѵіпдоѵѵ.ХМІНІІрВедцезІ: = ІітсІіопО { 

Ігу { 

// Использовать последнюю версию АсііѵеХ-объекта. если доступна 
геіцгп пеѵѵ АсІіѵеХ0Ь]есіС'Мзхт12.ХМІНТТР.6.0"); 

} 

саІсГі (еі) { 
ігу { 

// Иначе вернуться к старой версии 

геіыгп пеѵѵ АсІіѵеХ0Ь]есІ("Мзхт12.ХМІНТТР.3.0"); 

} 

саІсГі(е2) { 

// Если ничего не получилось - возбудить ошибку 
ІНгом пеѵ/ Еггог("ХМІ_Н11:рВедие5І: не поддерживается' ); 

} 

} 

}; 

} 


НТТР-запрос состоит из четырех частей: 

• метод НТТР-запроса или тип «операции» 

• запрашиваемый ШІЬ-адрес 

• необязательные заголовки запроса, которые могут включать информацию 
для аутентификации 

• необязательное тело запроса 

НТТР-ответ, возвращаемый сервером, состоит из трех частей: 

• числовое и текстовое значение, определяющее код состояния, свидетельст¬ 
вующий об успехе или об ошибке 

• набор заголовков ответа 

• тело ответа 

Первые два подраздела, следующие далее, демонстрируют, как устанавливать 
каждую часть НТТР-запроса и как извлекать части из НТТР-ответа. За этими 
ключевыми разделами следуют подразделы, освещающие более узкоспециализи¬ 
рованные темы. 

Базовая архитектура запрос/ответ протокола НТТР весьма проста в использова¬ 
нии. Однако на практике возникает масса сложностей: клиенты и серверы обме¬ 
ниваются данными в виде соокіез; серверы переадресуют броузеры на другие сер- 





18.1. Использование объекта ХМШНрКедиезІ 
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веры; одни ресурсы кэшируются, а другие - нет; некоторые клиенты отправляют 
запросы через прокси-серверы и т. д. Объект ХМЫНІіІірРедиезІ: не является приклад¬ 
ным интерфейсом уровня протокола, он обеспечивает прикладной интерфейс 
уровня броузера. Броузер сам заботится о соокіев, переадресации, кэшировании 
и прокси-серверах, а вам достаточно позаботиться только о запросах и ответах. 


XМ^ННрКе^^Iе5і и локальные файлы 

Возможность использования относительных ІЖЬ-адресов в веб-страницах 
обычно означает, что НТМЬ-страницы можно разрабатывать и проверять, 
используя локальную файловую систему, а затем перемещать их на веб-сер¬ 
вер без дополнительных изменений. Однако, как правило, это невозможно 
при использовании архитектуры Азах на основе объекта ХМЫНІіІірРедиезІ:. 
Объект ХМЫНІіІірРедиезІ: предназначен для работы с протоколами НТТР 
и НТТР8. Теоретически он мог было работать с другими протоколами, та¬ 
кими как РТР, но такие части прикладного интерфейса, как метод запроса 
и код состояния ответа, являются характерными именно для протокола 
НТТР. Если загрузить веб-страницу из локального файла, сценарии в этой 
странице не смогут использовать объект ХМЫНІіІірРедиезІ: с относительными 
ШІЬ-адресами, потому что эти адреса будут относительными адресами ви¬ 
да Тііе://, а не ІтЫр://. А политика общего происхождения зачастую будет 
препятствовать использованию абсолютных адресов вида ІгЕір://. (Тем не 
менее загляните в раздел 18.1.6.) Таким образом, чтобы проверить веб¬ 
страницы, использующие объект ХМЫНІіІірРедиезІ:, их необходимо выгружать 
на веб-сервер (или использовать локальный веб-сервер). 


18.1.1. Выполнение запроса 

Следующий этап после создания объекта ХМЫНІіІірРедиезІ: - определение парамет¬ 
ров НТТР-запроса вызовом метода ореп() объекта ХМЫНІіІірРедиезІ:, которому пере¬ 
даются две обязательные части запроса: метод и ІШЬ: 

гедиезі: .ореп("СЕТ". // Запрос типа НТТР СЕТ 

"сіаііа.сзѵ"); // на получение содержимого по этому УНІ_-адресу 

Первый аргумент метода ореп() определяет НТТР-метод или операцию. Это стро¬ 
ка, не чувствительная к регистру, но обычно содержащая только символы верх¬ 
него регистра, в соответствии со спецификацией протокола НТТР. Методы «СЕТ» 
и «Р08Т» поддерживаются всеми броузерами. Метод «СЕТ» используется для 
«обычных» запросов и соответствует случаю, когда ІЖЬ-адрес полностью опреде¬ 
ляет запрашиваемый ресурс. Он используется, когда запрос не имеет побочных 
эффектов и когда ответ сервера можно поместить в кэш. Метод «Р08Т» обычно 
используется НТМЬ-формами. Он включает в тело запроса дополнительные дан¬ 
ные (данные формы), и эти данные часто сохраняются в базе данных на стороне 
сервера (побочный эффект). В ответ на повторяющиеся запросы Р08Т к одному 
и тому же ІЖЬ сервер может возвращать разные ответы, и ответы на запросы, 
отправленные этим методом, не должны помещаться в кэш. 
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Помимо запросов «СЕТ» и «Р08Т», спецификация ХМЬНМрКедиезі также по¬ 
зволяет передавать методу о реп () строки «БЕЬЕТЕ», «НЕАБ», «ОРТКЖ8» и «РИТ» 
в первом аргументе. (Методы «НТТР ССЖКЕСТ», «ТКАСЕ» и «ТКАСК» явно за; 
прещены к использованию из-за проблем с безопасностью.) Старые версии броузе¬ 
ров могут не поддерживать все эти методы, но метод «НЕАБ», по крайней мере, 
поддерживается почти всеми броузерами, и его использование демонстрируется 
в примере 18.13. 

Вторым аргументом методу ореп( ) передается ІЖЬ-адрес запрашиваемого ресурса. 
Это относительный ІЖЬ-адрес документа, содержащего сценарий, в котором вы¬ 
зывается метод ореп(). Если указать абсолютный адрес, то в общем случае прото¬ 
кол, доменное имя и порт должны совпадать с аналогичными параметрами адреса 
документа: нарушение политики общего происхождения обычно вызывает ошиб¬ 
ку. (Однако спецификация «ХМЬНМрКедиезі Ьеѵеі 2» допускает выполнение за¬ 
просов к другим серверам, если сервер явно разрешил это - смотрите раздел 18.1.6.) 

Следующий этап в выполнении запроса - установка заголовков запроса, если это 
необходимо. Запросы Р08Т, например, требуют, чтобы был определен заголовок 
«Сопіепі-Туре», определяющий МІМЕ-тип тела запроса: 

гедиезі: . зе1:Редиезі:НеасІе г( "Сопіепі-Туре" , "ІехѴрІаіп" ); 

Если вызвать метод зе1:Редиез1:НеасІег( ) несколько раз с одним и тем же заголов¬ 
ком, новое значение не заменит прежнее: вместо этого в НТТР-запрос будет встав¬ 
лено несколько копий заголовка или один заголовок с несколькими значениями. 

Нельзя определять собственные заголовки «Сопіепі-Ьеп^іЬ», «Баіе», «Не^егег» 
и «Изег-А^епі»: объект ХМЫНІііірРедиезІ: добавляет их автоматически и не позволяет 
подделывать их. Аналогично объект ХМЫН1:1:рРедиез1: автоматически обрабатывает 
соокіез и срок поддержки открытого соединения, определяет кодировку симво¬ 
лов и выполняет кодирование сообщений, поэтому вы не должны передавать ме¬ 
тоду 5е1:Редие5І:НеасІег() следующие заголовки: 


АссерІ-СМагзеІ: 

Ассері-Епсосііпд 

Соппесііоп 

СопІепіі-ІепдііГі 

Соокіе 

Соокіе2 


Сопііепіі-Тгапз^ег-Епсосііпд 

Эаііе 

Ехресі 

Нозі: 

Кеер-АІіѵе 

Ре^егег 


ТЕ 

Тгаііег 

Тгапз^ег-Епсосііпд 
ІІрд гаРе 
Узег-Адепі: 

Ѵіа 


В запросе можно определить заголовок «АиіЬогіяаііоп», но обычно в этом нет не¬ 
обходимости. При выполнении запроса к ресурсу, защищенному паролем, пере¬ 
дайте имя пользователя и пароль методу ореп() в четвертом и пятом аргументах, 
а объект ХМІ_Ні:і:рВедие5І: автоматически установит соответствующие заголовки. 
(О третьем необязательном аргументе метода ореп() рассказывается ниже, а опи¬ 
сание аргументов, в которых передаются имя пользователя и пароль, можно най¬ 
ти в справочной части книги.) 

Последний этап в процедуре выполнения НТТР-запроса с помощью объекта ХМІ_- 
НИрРедиезІ: - передача необязательного тела запроса и отправка его серверу. Де¬ 
лается это с помощью метода зепд(): 

гедиезі:. зепс!( пиіі ); 

СЕТ-запросы не имеют тела, и в этом случае можно передать методу значение пиіі 
или вообще опустить аргумент. Р08Т-запросы обычно имеют тело, и оно должно 
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соответствовать заголовку «Сопіепі-Туре*, установленному с помощью метода 

5е1:Ведие5І:НеасІег(). 

Пример 18.1 демонстрирует использование всех методов объекта ХМІ_Н1:1:рВедие5*, 
описанных выше. Он отправляет серверу текстовую строку методом Р08Т и игно¬ 
рирует ответ, возвращаемый сервером. 

Пример 18.1. Отправка простого текста на сервер методом Р08Т 

Гипсіііоп розі:Меззаде(т$д) { 

ѵаг гедиезі: = пеѵѵ ХМЬНПрРедиез^С ); // Новый запрос 

гедиезі:. ореп("Р05Т", "/Іод.рНр"); // серверному сценарию методом РОЗТ 

// Отправить простое текстовое сообщение в теле запроса 

гедиезі:.зегВедиезіНеасІегГСопіепі-Туре". // Тело запроса - простой текст 

"Іехі/ріаіп; сНагзе1:=ІЛТ-8"); 

гедиезі:.зепсЦтзд); // тзд как тело запроса 

// Запрос выполнен. Мы игнорируем возможный ответ или ошибку. 

} 

Обратите внимание, что вызов метода зепд() в примере 18.1 инициирует запрос 
и затем возвращает управление: он не блокируется в ожидании ответа от сервера. 
НТТР-ответы практически всегда обрабатываются асинхронно, как будет пока¬ 
зано в следующем разделе. 


Порядок имеет значение 

Части НТТР-запроса следуют в определенном порядке: метод запроса 
и ІШЬ-адрес должны определяться в первую очередь, затем должны уста¬ 
навливаться заголовки запроса и, наконец, тело запроса. Обычно реализа¬ 
ции ХМШІііірРедиезІ: ничего не отправляют в сеть, пока не будет вызван метод 
зепд(). Но прикладной интерфейс ХМЫНІіІірРедиезІ: спроектирован так, как ес¬ 
ли бы каждый метод немедленно отправлял данные в сеть. Это означает, 
что методы объекта ХМЫНІіІірРедиезІ: должны вызываться в порядке, соответ¬ 
ствующем структуре НТТР-запроса. Например, метод зеІіРедиезІіНеасІегО 
должен вызываться после метода ореп() и перед методом зепРО, в против¬ 
ном случае он возбудит исключение. 


18.1.2. Получение ответа 

Полный НТТР-ответ содержит код состояния, набор заголовков ответа и тело от¬ 
вета. Все это доступно в виде свойств и методов объекта ХМЫНІіІірРедиезІ:: 

• Свойства зііаііиз и зІіаІіизТехІ: возвращают код состояния НТТР в числовом 
и текстовом виде. Эти свойства хранят стандартные НТТР-значения, такие 
как 200 и «ОК» в случае успешного выполнения запроса или 404 и «N 01 ГоипсЬ 
при попытке обратиться к ресурсу, отсутствующему на сервере. 

• Заголовки ответа можно получить с помощью методов де1:РезропзеНеас1ег( ) и деі:- 
А11РезропзеНеасІегз(). Обработка соокіез выполняется объектом ХМЫНІіІірРедиезІ: 
автоматически: он исключает заголовки «Соокіе» из множества, возвращав- 
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мого методом деІАПРезропзеНеайегзО, и возвращает тЛІ, если передать аргу¬ 
мент «8еі-Соокіе» или «8еі-Соокіе2» методу деЮезропзеНеас1ег(). 

• Тело ответа в текстовом виде доступно через свойство гезропзеТехІ: или в виде 
объекта Оосішепі: через свойство гезропзеХМ1_. (Выбор такого имени свойства 
объясняется историческими причинами: фактически оно предназначено для 
работы с ХНТМЬ- и ХМЬ-доку ментами, но спецификация «ХНК2» определя¬ 
ет, что оно также должно работать с обычными НТМЬ-документами.) Более 
подробно о свойстве гезропзеХМЬ рассказывается в разделе 18.1.2.2. 

Обычно объект ХМ1_Н1:1:рРедие51: используется в асинхронном режиме (но загляните 
в раздел 18.1.2.1): метод зепсК) возвращает управление сразу же после отправки 
запроса, поэтому методы и свойства, перечисленные выше, не могут использовать¬ 
ся до фактического получения ответа. Чтобы определить момент получения отве¬ 
та, необходимо обрабатывать событие «геасІувІаІесЬап&е» (или событие «рго&гезз», 
определяемое новой спецификацией «ХНК2» и описываемое в разделе 18.1.4), 
возбуждаемое в объекте ХМЕНИрРедиезИ. Но, чтобы понять, как обрабатывать это 
событие, необходимо сначала разобраться со свойством геасІуЗііаІіе. 

Свойство геасІуЗіаІе - это целочисленное значение, определяющее код состояния 
НТТР-запроса; его возможные значения перечислены в табл. 18.1. Идентифика¬ 
торы, указанные в первой колонке, - это константы, определяемые конструкто¬ 
ром ХМІНИрРедиезІ:. Эти константы являются частью спецификации ХМЫН1:1;рРедиез1:, 
но старые версии броузеров и ІБ8 не определяют их, поэтому часто можно увидеть 
программный код, в котором вместо константы ХМЬНирРедиезИ.ООМЕ используется 
числовое значение 4. 

Теоретически событие «геасІугІаІесЬап&е» генерируется всякий раз, когда изме¬ 
няется значение свойства геасІуЗіаІе. На практике же событие может не возбуж¬ 
даться, когда свойство геасІуЗіаІе получает значение 0 или 1. Оно часто возбужда¬ 
ется при вызове метода зепд(), даже при том, что свойство геасІуЗіаІіе по-прежне¬ 
му содержит значение ОРЕМ Ей. Некоторые броузеры возбуждают событие множе¬ 
ство раз для состояния ЮАОІМС, чтобы обеспечить обратную связь. Все броузеры 
возбуждают событие «геайувІаІесЬап&е», когда завершается прием ответа серве¬ 
ра и свойство геасІуЗНаІіе получает значение 4. Так как это событие может возбуж¬ 
даться еще до завершения приемаответа, обработчики события «геасІувІаІесЬап&е» 
всегда должны проверять значение свойства геасІуЗіаІе. 

Чтобы обрабатывать события «геасІувІаІесЬап&е», нужно присвоить функцию об¬ 
работчика события свойству опгеайузИаИесОапде объекта ХМІ_НИ1:рРедие5І:. Можно 
также воспользоваться методом ас!с1Еѵепі:1_і5Иепег() (или аИ1;асГіЕѵепі;( ) в ІЕ версии 8 
и ниже), но обычно для обработки запроса бывает вполне достаточно одного обра¬ 
ботчика, поэтому проще установить свойство опгеасіузіаіесііапде. 

Таблица 18.1. Значения свойства геайуЗіаіе объекта ХМЬНіірЕедиезі 


Константа 

Значение 

Смысл 

ІШЕМТ 

0 

Метод ореп( ) еще не был вызван 

ОРЕМЕО 

1 

Метод ореп() был вызван 

НЕА0ЕР8_РЕСЕІѴЕ0 

2 

Были получены заголовки 

ЮАОІМС 

3 

Идет прием тела ответа 

ООЫЕ 

4 

Прием ответа завершен 
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Пример 18.2 определяет функцию деіТехіО, которая демонстрирует особенности 
обработки событий «геасІузІаІесЬап&е». Обработчик события сначала проверяет 
завершение запроса. После этого он проверяет код состояния ответа и убеждается 
в успешном выполнении. Затем он извлекает заголовок «Сопіепі-Туре», чтобы 
убедиться, что получен ответ ожидаемого типа. Если выполняются все три усло¬ 
вия, он передает тело ответа (в виде текста) указанной функции обратного вызова. 

Пример 18.2. Получение НТТР ответа в обработчике опгеайузіаіесНапёе 

// Выполняет запрос НТТР СЕТ содержимого указанного ІІВІ_-адреса. 

// После успешного получения ответа проверяет, содержит ли он простой текст, 

// и передает его указанной функции обратного вызова 
Тііпсііоп деІТехІ(иг1, саІІЬаск) { 

ѵаг гедьез! = пе\л/ ХМІ_НПрВедиезІ(); // Создать новый запрос 

гедиезі.ореп( "СЕТ", іігі); // Указать 0ВІ_-адрес ресурса 

гедиезі. опгеасіузіаіесііапде = ІипсІіоп() { // Определить обработчик события 

// Если запрос был выполнен успешно 
іТ ( гедиезі. геасІуВіаІе === 4 && гедиезі. зіаіііз === 200) { 
ѵаг іуре = гедиезі. деІВезропзеНеас1ег("СопІепІ-Туре"); 
іі (Іуре.таІсНС/'ЧехІ/)) // Убедиться, что это текст 

са11Ьаск(гедиезі.гезропзеТехІ); // Передать функции 

} 

}; 

гедиезі. зепсі(пиіі); // Отправить запрос 

} 

18.1.2.1. Получение синхронного ответа 

Сама природа НТТР-ответа предполагает их асинхронную обработку. Тем не ме¬ 
нее объект ХМІ_НІірРедиезІ поддерживает возможность получения ответов в син¬ 
хронном режиме. Если в третьем аргументе передать методу ореп( ) значение Таізе, 
выполнение метода зепсі() будет заблокировано до завершения запроса. В этом 
случае отпадает необходимость использовать обработчик события: после того как 
метод зепсІ() вернет управление, можно будет сразу же проверить свойства зіаіііз 
и гезропзеТехІ объекта ХМІ_НИрПедііе5І. Сравните следующую синхронную реализа¬ 
цию функции деіТехіО из примера 18.2: 

// Выполняет синхронный запрос НТТР СЕТ содержимого по указанному ІІПІ_-адресу. 

// Возвращает текст ответа. Возбуждает исключение в случае неудачи 
// или если ответ не является текстом. 

Іипсііоп деіТехіЗупс(игІ) { 

ѵаг гедиезі = пе\л/ ХМІ_НИрВедиезІ(); // Создать новый запрос 
гедиезі.ореп( "СЕТ", іігі, Таізе); // Таізе - синхронный режим 
гедиезі.зепсІ(пиіі); // Отправить запрос 

// Возбудить исключение, если код состояния не равен 200 

іТ (гедиезі.зіаіііз !== 200) ІНго\л/ пе\л/ Еггог(гедиезі.зІаІьзТехІ); 

// Возбудить исключение, если ответ имеет недопустимый тип 
ѵаг іуре = гедиезі.деІВезропзеНеасІег("СопІепІ-Туре"); 

ІТ (!Іуре.таІсН(/~ІехІ/)) 

ІН гоѵѵ пе\л/ Е г го г ("Ожидался текстовый ответ; получен: " + Іуре); 
геіьгп гедиезі.гезропзеТехІ; 

} 
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Синхронные запросы выглядят весьма заманчиво, однако использовать их неже¬ 
лательно. Интерпретатор ^ѵаЗсгірі на стороне клиента выполняется в единст¬ 
венном потоке, и когда метод зепс!() блокируется, это обычно приводит к зависа¬ 
нию пользовательского интерфейса всего броузера. Если сервер, к которому вы¬ 
полнено подключение, отвечает на вопросы с задержкой, броузер пользователя 
будет зависать. Тем не менее в разделе 22.4 вы познакомитесь с одним из случаев, 
когда синхронные запросы вполне допустимы. 

18.1.2.2. Декодирование ответа 

В примерах выше предполагалось, что сервер возвращает ответ в виде простого 
текста, с МІМЕ-типом «іехі/ріаіп», «Іехі/МтЬ или «іехі/сзз», и мы извлекаем 
его из свойства гезропзеТехИ объекта ХМІНИрРедиезІ:. 

Однако существуют и другие способы обработки ответов сервера. Если сервер по¬ 
сылает в ответе ХМЬ- или ХНТМЬ-документ, разобранное представление ХМЬ- 
документа можно получить из свойства гезропзеХМІ_. Значением этого свойства яв¬ 
ляется объект Оосіітепі:, при работе с которым можно использовать приемы, пред¬ 
ставленные в главе 15. (Проект спецификации «ХНК2» требует, чтобы броузеры 
автоматически выполняли синтаксический анализ ответов типа «іехі/МтЬ и так¬ 
же делали их доступными через свойство гезропзеХМЬ в виде объектов Ооситепі:, но 
на момент написания этих строк это требование не было реализовано в текущих 
броузерах.) 

Если в ответ на запрос серверу потребуется отправить структурированные дан¬ 
ные, такие как объект или массив, он может передать данные в виде строки в фор¬ 
мате ^(Ж (раздел 6.9). После получения такой строки содержимое свойства гез- 
ропзеТехІ: можно передать методу ^0М.рагзе(). Пример 18.3 является обобщенной 
версией примера 18.2: он выполняет запрос методом СЕТ по указанному ІІНЬ-ад- 
ресу и после получения содержимого этого адреса передает его указанной функ¬ 
ции обратного вызова. Но теперь функции не всегда будет передаваться простой 
текст - ей может быть передан объект ОосшпегЦ, объект, полученный с помощью 
^ОМ.рагзеО, или строка. 

Пример 18.3. Синтаксический анализ НТТР-ответа 

// Выполняет запрос НТТР СЕТ на получение содержимого по указанному ІІПІ_-адресу. 

// При получении ответа он передается функции обратного вызова 
// как разобранный объект ХМ І_- документа, объект 050И или строка. 

^ішсііоп де*(цг1, саІІЬаск) { 

ѵаг гецііезі: = г\еѵі ХМЕНирПециезК ); // Создать новый запрос 

герііезІ.орепС'СЕТ", игі); // Указать 0ПІ_-адрес ресурса 

гецііезІ.опгеасІузІаІесНапде = ^ііпс1:іоп() { // Определить обработчик события 
// Если запрос был выполнен и увенчался успехом 
іГ ( гецііезі: . геасІуЗіаІе === 4 && гецііезі:. зііаіііз === 200) { 

// Определить тип ответа 

ѵаг {уре = гецііезі:. де^ПезролзеНеабегССотгет-Туре"); 

// Проверить тип, чтобы избежать в будущем передачи ответа 

// в виде документа в формате НТМІ_ 

іГ (Іуре. іпсІехО^С'хтІ" ) !== -1 && гецііезі:. гезропзеХМІ.) 

са11Ьаск(гецііезі:. гезропзеХМІ.); // Объект ХМІ_ 

еізе іГ (Іуре === '‘арріісаііоп/ізоп") 

саІІЬаскЫЗОМ. рагзе(гецііезі:. гезропзеТех*)); // Объект 050Ы 

еізе 
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са11Ьаск( герііезі:. гезропзеТехІ:); // Строка 

} 

>; 

гедііезі:. зепс!( пиіі ); // Отправить запрос 

> 

Функция в примере 18.3 проверяет заголовок «Сопіепі-Туре» ответа и обрабаты¬ 
вает ответы типа « арріісаііоп /] воп» особым образом. Другими типами ответов, 
которые может потребоваться «декодировать» особо, являются « арріісаііопДГаѵа- 
8сгірі» и «іехі/^аѵа8сгірі». С помощью объекта ХМЫН1:1;рРедиез1: можно запраши¬ 
вать сценарии на языке ЛаѵаЗсгірі и затем выполнять их с помощью глобальной 
функции еѵа1() (раздел 4.12.2). Однако в этом нет никакой необходимости, пото¬ 
му что возможностей самого элемента <зсгірі> вполне достаточно, чтобы загру¬ 
зить и выполнить сценарий. Вернитесь к примеру 13.4, держа в уме, что элемент 
<зсгірі:> может выполнять НТТР-запросы к другим серверам, запрещенные в при¬ 
кладном интерфейсе ХМЫННіірРедиезІ;. 

В ответ на НТТР-запросы веб-серверы часто возвращают двоичные данные (на¬ 
пример, файлы изображений). Свойство гезропзеТехИ предназначено только для 
текстовых данных и не позволяет корректно обрабатывать ответы с двоичными 
данными, даже если использовать метод сРагСосІеАіО полученной строки. Специ¬ 
фикация «ХНК2» определяет способ обработки ответов с двоичными данными, 
но на момент написания этих строк производители броузеров еще не реализовали 
его. Дополнительные подробности приводятся в разделе 22.6.2. 

Для корректного декодирования ответа сервера необходимо, чтобы сервер отправ¬ 
лял заголовок «Сопіепі-Туре» с правильным значением МІМБ-типа ответа. Если, 
к примеру, сервер отправит ХМЬ-документ, не указав соответствующий МІМЕ- 
тип, объект ХМЫНИИрЯедиезі; не произведет синтаксический анализ ответа и не уста¬ 
новит значение свойства гезропзеХМЬ. Или, если сервер укажет неправильное зна¬ 
чение в параметре «сЪагзеі» заголовка «Сопіепі-Туре», объект ХМІ_НИИрНерие5І: де¬ 
кодирует ответ с использованием неправильной кодировки и в свойстве гезропзе- 
Техі могут оказаться ошибочные символы. 

Спецификация «ХНК2» определяет метод оѵеггіс!еМітеТуре(), предназначенный 
для решения этой проблемы, и он уже реализован в некоторых броузерах. Если 
необходимо определить МІМЕ-тип, лучше подходящий для веб-приложения, чем 
возвращаемый сервером, можно перед вызовом метода зепс!() передать методу 
оѵеггіс1еМітеТуре() свой тип - это заставит объект ХМЫНіііірЯедиезІ; проигнорировать 
заголовок «Сопіепі-Туре» и использовать указанный тип. Предположим, что не¬ 
обходимо загрузить ХМЬ-файл, который планируется интерпретировать как 
простой текст. В этом случае можно воспользоваться методом оѵеггіс!еМітеТуре(), 
чтобы сообщить объекту ХМЫНіііірРедиезІ;, что он не должен выполнять синтаксиче¬ 
ский анализ файла и преобразовывать его в объект ХМЬ-документа: 

// Не обрабатывать ответ, как ХМЬ-документ 
гедііезі:.оѵеггіРеМітеТуре("1:ехі:/р1аіп; сИагзе1:=и'М = -8") 

18.1.3. Оформление тела запроса 

Запросы НТТР Р08Т включают тело запроса, которое содержит данные, переда¬ 
ваемые клиентом серверу. В примере 18.1 тело запроса было простой текстовой 
строкой. Однако нередко бывает необходимо передать в НТТР-запросе более 
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сложные данные. В этом разделе демонстрируются некоторые способы реализа¬ 
ции отправки таких данных. 

18.1.3.1. Запросы с данными в формате НТМЬ-форм 

Рассмотрим НТМЬ-формы. Когда пользователь отправляет форму, данные в фор¬ 
ме (имена и значения всех элементов формы) помещаются в строку и отправляют¬ 
ся вместе с запросом. По умолчанию НТМЬ-формы отправляются на сервер мето¬ 
дом Р08Т, и данные формы помещаются в тело запроса. Схема преобразования 
данных формы в строку относительно проста: к имени и значению каждого эле¬ 
мента формы применяется обычное ШИ-кодирование (замена специальных сим¬ 
волов шестнадцатеричными кодами), кодированные представления имен и зна¬ 
чений отделяются знаком равенства, а пары имя/значение - амперсандом. Пред¬ 
ставление простой формы в виде строки может выглядеть, как показано ниже: 

Гіпй=рі22а&2ірсос1е=02134&гас1іііз=1кт 

Такой формат представления данных формы соответствует формальному МІМЕ- 
типу: 

арр1іса1:іоп/х-\ллл/ѵ/-1 = о гт-и гіепсосіесі 

Этот тип следует указать в заголовке «Сопіепі-Туре» запроса при отправке дан¬ 
ных такого вида в составе запроса метолом Р08Т. 

Обратите внимание, что для использования такого формата представления не 
требуется наличие НТМЬ-формы, и в действительности в этой главе мы не будем 
работать с формами непосредственно. В Аіах-приложениях чаще всего у вас будет 
иметься некоторый Лаѵа8сгірі-объект, который необходимо отправить на сервер. 
(Этот объект может быть создан из полей ввода НТМЬ-формы, но в данном случае 
это не имеет значения.) Данные, показанные выше, могут оказаться представле¬ 
нием следующего ЛѵаЗсгірі-объекта: 

{ 

Гіпсі: "рігга", 
гірсосіе: 02134, 
гасііиз: "Ікт" 

} 

Формат представления данных форм настолько широко используется во Всемир¬ 
ной паутине и настолько хорошо поддерживается всеми языками программирова¬ 
ния для создания серверных сценариев, что его применение для представления 
данных, никак не связанных с формами, часто оказывается наиболее простым 
и удобным. Пример 18.4 демонстрирует, как преобразовать свойства объекта в фор¬ 
мат представления формы. 

Пример 18.4. Преобразование объекта в формат для отправки в НТТР-запросе 

I* * 

* Представляет свойства объекта, как если бы они были парами имя/значение 

* НТМЬ-формы, с использованием формата аррІісаІіоп/х-ѵлѵѵѵ-Гогт-игІепсосІес) 

*/ 

Гітсіііоп епсос!еРогт0а1:а(с1а1:а) { 
іГ (Ісіаіа) геііігп 
ѵаг раігз = []; 

Рог(ѵаг пате іп сіаіа) { 


// Всегда возвращать строку 
// Для пар имя/значение 
// Для каждого имени 
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і? (! сіаіа.ІіазОчѵпР горегТу(пате)) сопііпііе; // Пропустить унаслед. 

ІТ (іуреоР с)аі:а[пате] === "І'ііпсііоп") сопііпііе;// Пропустить методы 
ѵаг ѵаіііе = с1аТа[пате] .ІоЗігіпдС); // Знач. в виде строки 

пате = епсос)еиПІСотропепі:(пате. гер1асе(''%20'', "+')); // Кодировать имя 

ѵаіие = епсосІеипІСотропепі: (ѵаіііе. гер1асе("%20". ”+")); // Кодировать значение 
раігз. ріізЬ(пате + "=” + ѵаіііе); // Сохранить пару имя/значение 

} 

геііігп раігз.]оіп(// Объединить пары знаком & и вернуть 

} 

С помощью этой функции епсос!еРогт0а1:а() легко можно создавать утилиты, такие 
как функция роаЮаІіаО, представленная в примере 18.5. Обратите внимание, что 
для простоты эта функция роз*0аТа() (и аналогичные ей функции в примерах ни¬ 
же) не обрабатывает ответ сервера. При получении ответа она передает объект 
ХМІЛІТрПедііезі: целиком указанной функции обратного вызова. Эта функция об¬ 
ратного вызова сама должна проверять код состояния ответа и извлекать содер¬ 
жимое ответа. 

Пример 18.5. Выполнение запроса НТТР РОЗТ с данными в формате 

представления форм 

Тішсііоп розЮа1:а(иг1, сіаіа, саІІЬаск) { 
ѵаг гедііезі = пем ХМЬНііірПедііезК); 

гедцезі.орепС'РОЗТ". игі); // Методом РОЗТ на указ, іігі 

гедііезі:.опгеасІузіаіесЬапде = іііпсііопО { // Простой обработчик 

іі (гедііезі.геасІуСіаіе === 4 && саІІЬаск) // При получении ответа 

са11Ьаск( гедііезі); // вызвать указанную функцию 

>; 

гедііезі. зе^Педиез^НеаЬегГ'Соп^еп^-Туре". // Установить "Сопіепі-Туре" 

'аррІісаііоп/х-ѵѵш-іогт-іігІепсосІесГ); 
гедііезі.5епс1(епсос1еРогт0аіа(с1аіа)); // Отправить данные 

} // в представлении форм 

Данные формы также могут быть отправлены посредством ОБТ-запроса, и когда 
цель формы состоит в том, чтобы определить параметры операции чтения, метод 
СЕТ лучше соответствует назначению формы, чем метод Р08Т. СЕТ-запросы не 
имеют тела, поэтому «полезный груз» с данными формы отправляется серверу 
в виде строки запроса в адресе ИНЬ (следующей за знаком вопроса). Утилита 
епсос!еРогтОаіа() может также пригодиться для отправки подобных СЕТ-запро- 
сов, и пример 18.6 демонстрирует такое ее применение. 

Пример 18.6. Выполнение СЕТ-запроса с данными в формате представления форм 

іітсііоп деі0аіа(ііг1, сіаіа, саІІЬаск) { 
ѵаг гедііезі = пем ХМІ_НіірВедііезі(); 

гедііезі. ореп( "СЕТ", іігі + // Методом СЕТ на указанный іігі 

"?" + епсос)еРогтОаіа(сІаіа)); // с добавлением данных 
гедііезі. опгеасІузіаіесЬапде = іітсііоп() { // Простой обработчик событий 
іі (гедііезі. геасІуЗіаіе === 4 && саІІЬаск) са11Ьаск(гедііезі:); 

}; 

гедііезі:.зепсі(піііі); // Отправить запрос 

} 

Для добавления данных в ІІНЬ-адреса НТМЬ-формы используют строки запро¬ 
сов, но использование объекта ХМІ_НіірРедііезі дает свободу представления данных. 
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При наличии соответствующей поддержки на сервере наш запрос на поиск пиц¬ 
церии можно оформить в виде более удобочитаемого ШІЬ-адреса, такого как по¬ 
казано ниже: 

ЬПр : //гезіаіі гапі: Гіпсіе г. ехатріе. сот/021 34/1 кт/рігга 

18.1.3.2. Запросы с данными в формате 

Использование формата представления данных форм в теле Р08Т-запросов явля¬ 
ется распространенным соглашением, но не является обязательным требованием 
протокола НТТР. В последние годы в роли формата обмена данными во Всемир¬ 
ной паутине все большей популярностью пользуется формат ^(Ж. Пример 18.7 
демонстрирует, как с помощью функции ^ОМ.з*гіпді^у( ) (раздел 6.9) можно сфор¬ 
мировать тело запроса. Обратите внимание, что этот пример отличается от при¬ 
мера 18.5 только последними двумя строками. 

Пример 18.7. Выполнение запроса НТТР РОЗТ с данными в формате 

Гітсііоп роз-иЗСЩіігІ, сіаіа, саІІЬаск) { 
ѵаг гедііезі: = пе\л/ ХМІ_НПрВедцез1:(); 

гедііезі:. ореп(" РОЗТ”, іігі); // Методом РОЗТ на указ, іігі 

гедііезі:. опгеасІузіаІесЬапде = Тііпсііоп() { // Простой обработчик 

іГ (гедііезі:. геасІуЗіаІіе === 4 && саІІЬаск) // При получении ответа 

са11Ьаск(гедііезі:); // вызвать указанную функцию 

>: 

гедііезі:. зеіПедііезІНеасІегС"Сопіепі-Туре", "арріісаііоп/ззоп"); 
гедііезі:. зепс)(030М. 5І:гіпдіГу(с)а1:а)); 

> 

18.1.3.3. Запросы с данными в формате ХМІ. 

Иногда для представления передаваемых данных также используется формат 
ХМЬ. Данные в запросе информации о пиццерии можно было бы передавать не 
в формате представления данных форм и не в формате Л8(Ж представления Лѵа- 
8сгірі-объектов, а в формате ХМЬ-документа. Тело такого запроса могло бы иметь 
следующий вид: 

<дііегу> 

<ГіпЬ гірсос)е="02134" гас)ііі5="1кт"> 
рігіа 
</Гіпс)> 

</дііегу> 

Во всех примерах, встречавшихся до сих пор, аргументом метода зепс!() объекта 
ХМЬНИрРедиез* была строка или значение піііі. В действительности же этому мето¬ 
ду можно также передать объект йоситепі: ХМЬ-документа. Пример 18.8 демонст¬ 
рирует, как создать объект Оосіітепі: простого ХМЬ-документа и использовать его 
в качестве тела НТТР-запроса. 

Пример 18.8. Выполнение запроса НТТР РОЗТ с ХМЬ-документом в качестве тела 

// Параметры поиска "что", "где" и "радиус" оформляются в виде ХМЬ-документа 
// и отправляются по указанному ІІПЬ-адресу. При получении ответа вызывает 
// указанную функцию 

Гітсііоп розЮііегуСіігІ, \нЬаХ, \ѵЬеге, гасііііз, саІІЬаск) { 
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ѵаг гедііезі = пе\ѵ ХМІНПрВедііезК ); 

гедііезі.орепС'РОЭТ", и гі ); // Методом РОЗТ на указанный іігі 

гедііезі.опгеасіузіаіесііапде = ^ііпсТіоп() { // Простой обработчик 
іР ( гедііезі . геасІуЭіаіе === 4 && саІІЬаск) са11Ьаск(гедііезі:); 

}; 


// Создать ХМІ_-документ с корневым элементом <дііегу> 

ѵаг Рос = Роситепі:. Ртр^тепРаиоп.сгеаРеОоситепРГ'’', "дііегу", піііі); 

ѵаг дііегу = сІос.сІосіітепііЕІетепі:; // Элемент <дііегу> 

ѵаг Ріпсі = Рос. сгеаіеЕІетепііС'РіпсГ); // Создать элемент <^іпс1> 

диегу. аррепсіСІіі1с1(^іпсі); // И добавить в <дііегу> 

РіпР.зеІАПгіЬиІеСгірсоРе", ѵѵііеге); // Атрибуты <І = іпс1> 

РіпР.зеіАПгіЬііііеГ'гаРіііз”, гасііиз); 

^іпсі. аррепсІСІіі1с1(с1ос. сгеаІеТехІЫосІеСѵѵМаІ:)); // И содержимое <РіпР> 


// Отправить данные в формате ХМІ_ серверу. 

// Обратите внимание, что заголовок Сопіепі-Туре будет установлен автоматически, 
гедііезі:. зепр( Рос); 


Обратите внимание, что пример 18.8 не устанавливает заголовок «Сопіепі-Туре» 
запроса. Когда методу зепр() передается ХМЬ-документ, то объект ХМЫНіііірРедиезІ: 
автоматически установит соответствующий заголовок «Сопіепі-Туре», если он не 
был установлен предварительно. Аналогично, если передать методу зепр() про¬ 
стую строку и не установить заголовок «Сопіепі-Туре», объект ХМЫ-ИііірПедиезі; ав¬ 
томатически добавит этот заголовок со значением «іехі/ріаіп; сЪаг8еі=ЦТГ-8». 
Программный код в примере 18.1 явно устанавливает этот заголовок, но в дейст¬ 
вительности для данных в простом текстовом виде этого не требуется. 


18.1.3.4. Выгрузка файлов 

Одна из особенностей НТМЬ-форм заключается в том, что, если пользователь вы¬ 
берет файл с помощью элемента <іпри1: 1;уре= Тііе ’ >, форма отправит содержимое 
этого файла в теле Р08Т-запроса. НТМЬ-формы всегда позволяли выгружать 
файлы, но до недавнего времени эта операция была недоступна в прикладном ин¬ 
терфейсе ХМСНІіІірРедиезІ:. Прикладной интерфейс, определяемый спецификацией 
«ХНК2», позволяет выгружать файлы за счет передачи объекта Рііе методу зепс!(). 

В данном случае нельзя создать объект с помощью конструктора Рі1е( ): сценарий 
может лишь получить объект Рііе, представляющий файл, выбранный пользова¬ 
телем. В броузерах, поддерживающих объекты Рііе, каждый элемент <іприі Ру¬ 
ре- Ті1е"> имеет свойство "Гііез, которое ссылается на объект, подобный массиву, 
хранящий объекты Рііе. Прикладной интерфейс буксировки (бга^-апб-бгор) (раз¬ 
дел 17.7) также позволяет получить доступ к файлам, «сбрасываемым» пользова¬ 
телем на элемент, через свойство РаРаТгапзРег.РіІез события «сігор». Поближе с объ¬ 
ектом Рііе мы познакомимся в разделах 22.6 и 22.7. А пока будем рассматривать 
объект Рііе как полностью непрозрачное представление выбранного пользовате¬ 
лем файла, пригодное для выгрузки методом зепс!(). В примере 18.9 представлена 
ненавязчивая ^ѵабсгірі-функция, добавляющая обработчик события «сЬап&е» 
к указанным элементам выгрузки файлов, чтобы они автоматически отправляли 
содержимое любого выбранного файла методом Р08Т на указанный адрес ІЖЬ. 
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Пример 18.9. Выгрузка файла посредством запроса НТТР Р08Т 

// Отыскивает все элементы <іпрііі: Іуре='Рі1е”> с атрибутом сіаіа-ііріоасііо 
// и регистрирует обработчик операнде, который автоматически отправляет 
// выбранный файл по указанному ОРІ_-адресу "ііріоасііо'’. Ответ сервера игнорируется. 
чѵІтепВеасіу( Гипс! іоп() { // Вызвать эту функцию после загрузки документа 

ѵаг еііз = Ьоситепр.деіЕ1етепІ5ВуТад№те("іпріі1:’'); // Все элементы іприТ 
Гог(ѵаг і = 0; і < еііз.ІепдРЬ; і++) { // Обойти в цикле 

ѵаг іпрііі: = еІТз[і]; 

іР (іприі:. Руре !== ’ТіІе") сопРіпііе; // Пропустить все, кроме 

// элементов выгрузки файлов 

ѵаг цгі = іпрііР.деРАРРгіЬііРе('с1аРа-іір1оасІРо''); // Адрес выгрузки 

іР (Ііігі) сопРіпце; // Пропустить элементы без іігі 

іприТ. ас)с1ЕѵепРІ_ізРепег("сІіапде", РііпсРіоп() { // При выборе файла 

ѵаг Рііе = РЬіз.Рі1ез[0]; // Предполагается выбор единственного файла 

іР (!Рі1е) герцгп; // Если файл не выбран, ничего не делать 

ѵаг хЬг = пе\ѵ ХМІ_НРРрВедііезР(); // Создать новый запрос 

хЬг.ореп("Р08Т", іігі); // Методом Р08Т на указанный 0ПІ_ 

хЬг.зепсІ(РіІе); // Отправить файл в теле запроса 

}, Раізе); 

} 

}); 

Как будет показано в разделе 22.6, тип Рііе является подтипом более общего типа 
ВІоЬ. Спецификация «ХНК2» позволяет передавать методу зепсІ() произвольные 
объекты ВІоЬ. Свойство Ііуре объекта ВІоЬ в этом случае будет использоваться для 
установки заголовка «Сопіепі-Туре», если он не будет определен явно. Если потре¬ 
буется выгрузить двоичные данные, сгенерированные клиентским сценарием, 
можно воспользоваться приемами преобразования данных в объект ВІоЬ, демонст¬ 
рируемыми в разделах 22.5 и 22.6.3, и передавать в виде тела запроса этот объект. 

18.1.3.5. Запросы с данными в формате пшііірагі/іогт-сіаіа 

Когда наряду с другими элементами НТМЬ-формы включают элементы выгруз¬ 
ки файлов, броузер не может использовать обычный способ представления дан¬ 
ных форм и должен отправлять формы, используя специальное значение «пшШ- 
рагІДогт-(1аІа» в заголовке «Сопіепі-Туре». Этот формат связан с использовани¬ 
ем длинных «граничных» строк, делящих тело запроса на несколько частей. Для 
текстовых данных можно вручную создать тело «тиІіірагіДогт-сІаіа» запроса, 
но это довольно сложно. 

Спецификация «ХНК2» определяет новый прикладной интерфейс РогтОаНа, упро¬ 
щающий создание тела запроса, состоящего из нескольких частей. Сначала с по¬ 
мощью конструктора РоггтШаРа() создается объект РогтОаРа, а затем вызовом метода 
аррепсК) этого объекта в него добавляются отдельные «части» (которые могут быть 
строками или объектами Рііе и ВІоЬ). В заключение объект РогтОаРа передается ме¬ 
тоду 8епс1(). Метод зепсІ( ) определит соответствующую строку, обозначающую гра¬ 
ницу, и установит заголовок «Сопіепі-Туре» запроса. Пример 18.10 демонстриру¬ 
ет использование объекта РогтОаРа, с которым мы еще встретимся в примере 18.11. 

Пример 18.10. Отправка запроса с данными в формате тиШрагіЦогт-йаіа 

РііпсРіоп розРРогт0аРа(ііг1, сіара, саІІЬаск) { 
іР (РуреоР РогтОаРа === "ітсІеРіпесГ) 
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ХЬгоѵі п еѵі Е г го г ("Объект РогтОаІа не реализован"); 

ѵаг гедііезі: = пе\ѵ ХМІ_НПрПедііе5І:(); // Новый НТТР-запрос 

гедііезі:. ореп("Р03Т", и г 1); // Методом Р08Т на указанный НПІ_ 

гедііезі:. опгеасіузіаіесііапде = РііпсііопС ) { // Простой обработчик. 

ІР (гедііезі:. геасІуЗіаІе === 4 && саІІЬаск) // При получении ответа 

са11Ьаск(гедііезі:); // вызвать указанную функц. 

}; 

ѵаг ^огтсіаіа = пеѵі РогтОаІаО; 

Рог(ѵаг пате іп сіаіа) { 

ІР (!сіаііа. РіазОхѵпРгорегі:у( пате )) сопРіпііе; // Пропустить унасл. св-ва 
ѵаг ѵаіііе = сІаТа[пате]; 

іР (РуреоР ѵаіііе === "РііпсРіоп”) сопііпііе; // Пропустить методы 
// Каждое свойство станет отдельной "частью" тела запроса. 

// Допускается использовать объекты Рііе 

РогтбаРа.аррепс1(пате, ѵаіііе); // Добавить имя/значение, 

} // как одну часть 

// Отправить пары имя/значение в теле запроса тиІРірагр/Рогт-с)аРа. Каждая пара - 
// это одна часть тела запроса. Обратите внимание, что метод зепсі автоматически 
// устанавливает заголовок Сопрепр-Туре, когда ему передается объект РогггЮаРа 
гедііезР. зепР(РогтРаРа); 

} 

18.1.4. События, возникающие в ходе 
выполнения НТТР-запроса 

В примерах выше для определения момента завершения НТТР-запроса использо¬ 
валось событие «геайузіаіесііап^е». Проект спецификации «ХНК2» определяет 
более удобный набор событий, уже реализованный в Гігеіох, СЬготе и 8а?агі. 
В этой новой модели событий объект ХМІ_НРРрПедііе5Р генерирует различные типы 
событий на разных этапах выполнения запроса, благодаря чему отпадает необхо¬ 
димость проверять значение свойства геаРуЗРаРе. 

Далее описывается, как генерируются эти новые события в броузерах, поддержи¬ 
вающих их. Когда вызывается метод зепсі (), один раз возбуждается событие «Іоасі- 
зіагі». В ходе загрузки ответа сервера объект ХМ1_НРРрНедиезР возбуждает серию со¬ 
бытий «рго^гезз», обычно каждые 50 миллисекунд или около того, которые можно 
использовать для обратной связи с пользователем, чтобы информировать его о ходе 
выполнения запроса. Если запрос завершается очень быстро, событие «рго&гезз» 
может и не возбуждаться. По завершении запроса возбуждается событие «Іоасі». 

Завершение запроса не всегда означает успешное его выполнение, поэтому обра¬ 
ботчик события «ІоасЬ должен проверять код состояния в объекте ХМЫНІіІірРедиезІ:, 
чтобы убедиться, что был принят НТТР-код «200 ОК», а не «404 Ыоі Еоиші», на¬ 
пример. 

Существуют три разные ситуации, когда НТТР-запрос оканчивается неудачей, 
которым соответствуют три события. Если предельное время ожидания ответа 
истекло, генерируется событие «іітеоиі». Если выполнение запроса было прерва¬ 
но, генерируется событие «аЪогі». (О предельном времени ожидания и о методе 
аЬогіО подробнее рассказывается в 18.1.5.) Наконец, выполнению запроса могут 
препятствовать другие ошибки в сети, такие как слишком большое количество 
переадресаций, и в этих случаях генерируется событие «еггог». 
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Для каждого запроса броузер может возбуждать только по одному событию 
«ІоасЬ, «аЪогі», «іітеоиі» и «еггог». Проект спецификации «ХНК2» требует, что¬ 
бы броузеры возбуждали событие «Іоасіепсі» после одного из этих событий. Одна; 
ко на момент написания этих строк событие «Іоасіепсі» не было реализовано ни 
в одном из броузеров. 

Для регистрации обработчиков всех этих событий, возникающих в ходе выполне¬ 
ния запроса, можно использовать метод асМЕѵепТИзТепегО объекта ХМ1_Н1:1:рРедие51:. 
Если каждое из этих событий обрабатывается единственным обработчиком, эти 
обработчики обычно проще установить, присвоив их соответствующим свойст¬ 
вам объекта, таким как опргодгезз и опіоай. Определяя наличие этих свойств, 
можно даже проверить поддержку соответствующих событий в броузере: 

іГ ("опргодгезз" іп (пе\ѵ ХМІ_НПрВедиез1:( ))) { 

// События, возникающие в ходе выполнения запроса, поддерживаются 

} 

Объект события, связанный с этими событиями, возникающими в ходе выполне¬ 
ния запроса, в дополнение к свойствам обычного объекта Еѵепі:, таким как Іуре 
и Іітез1:атр, добавляет три полезных свойства. Свойство Іоасіесі определяет количе¬ 
ство байтов, переданных к моменту возбуждения события. Свойство Іоіаі содер¬ 
жит общий объем (в байтах) загружаемых данных, определяемый из заголовка 
«Сопіепі-Ьеп^іЬ», или 0, если объем содержимого не известен. Наконец, свойство 
1епді:РСотриі:аЫе содержит значение Ігие, если общий объем содержимого извес¬ 
тен, и Раізе - в противном случае. Очевидно, что свойства Юіаі и Іоасіесі особенно 
полезны в обработчиках событий, возникающих в ходе выполнения запроса: 

гедиезі:. опргодгезз = Гипсііоп(е) { 
іГ (е. ІепдііПСотриІіаЫе) 

ргодгезз. іппегНТМІ_ = МаііП. гоипс!(100*е. 1оаРеР/е.1:о1:а1) + ”% Выполнено"; 

} 

18.1.4.1. События, возникающие в ходе выгрузки 

Кроме событий, которые удобно использовать для мониторинга загрузки НТТР- 
ответа, спецификация «ХНК2» также определяет события для мониторинга 
выгрузки НТТР-запроса. В броузерах, реализующих эту возможность, объект 
ХМЫН1;1:рРедиез1: имеет свойство иріоасі. Значением свойства иріоасі является объект, 
определяющий метод асМЕѵепНізІіепегО и полный набор свойств-событий хода 
выполнения операции выгрузки, таких как опргодгезз и опіоасі. (Однако этот объ¬ 
ект не определяет свойство опгеас!уз1:а1:есРапде: в процессе выгрузки генерируются 
только эти новые события.) 

Обработчики событий хода выполнения операции выгрузки можно использовать 
точно так же, как используются обычные обработчики событий хода выполнения 
загрузки. Для объекта х типа ХМ1_Н1:1:рРедие51: обработчик х.опргодгезз позволяет 
вести мониторинг хода выполнения загрузки ответа. А свойство х.иріоар. опргод¬ 
гезз - мониторинг хода выполнения выгрузки запроса. 

Пример 18.11 демонстрирует, как использовать событие «ргодгезз», генерируемое 
в ходе выгрузки запроса, для организации обратной связи с пользователем. Этот 
пример также демонстрирует, как получать объекты Рііе с применением меха¬ 
низма буксировки (сіга^-апсі-сігор) и как с помощью объекта РогпШаІа выгружать 
сразу несколько файлов в одном запросе ХМЕНИрРедиез!. На момент написания 
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этих строк спецификации, определяющие эти особенности, находились в состоя¬ 
нии проектирования и этот пример работал не во всех броузерах. 

Пример 18,11, Мониторинг хода выполнения операции выгрузки 

П Отыскивает все элементы с классом "ШеОгорТагдеТ" и регистрирует 
// обработчики событий механизма ОпО, чтобы они могли откликаться 
// на операции буксировки файлов. При сбросе файлов на эти элементы 
// они выгружают их на ІЖІ--адрес, указанный в атрибуте сІаіа-црІоасІТо. 

\ѵЬепВеасІу(Тцпс1:іоп( ) { 

ѵаг еІТз = сіоситепТ.деТЕ1етепТ5ВуС1а55Мате("Ше0горТагде1:"); 

Тог(ѵаг і = 0; і < еІТз.ІепдТЬ; і++) { 
ѵаг ТагдеТ = е1Тз[і]; 

ѵаг іігі = Ііагдеі;. де1:А1:1; гіЬи1:е("сіаііа-иріоасіііо”); 
іТ (!цг1) сопТіпце; 

сгеаТеРіІеІІрІоасЮгорТагдеКііагдеІ:, цгі); 

} 

ТцпсТіоп сгеаТеРіІеІІрІоасЮгорТагдеКііагдеІ:, цгі) { 

// Следит за ходом выполнения операции выгрузки и позволяет отвергнуть 
// выгрузку файла. Можно было бы обрабатывать сразу несколько параллельных 
// операций выгрузки, но это значительно усложнило бы 
// отображение хода их выполнения, 
ѵаг цріоасііпд = Таізе; 

сопзоіе. 1од(Тагде1:. цгі); 

ТагдеТ.опРгадепТег = ТцпсТіоп(е) { 
сопзоіе. 1од( "сі гадепТе г"); 

іТ (цріоасііпд) геТцгп; // Игнорировать попытку сброса, если 

// элемент уже занят выгрузкой файла 
ѵаг Турез = е.сІаТаТгапзТег.Турез; 

ІТ (Турез && 

((Турез.сопТаіпз && Турез.сопТаіпзС'РіІез")) || 

(Турез. іпсІехОТ && Турез. іпсІехОІ'С’ РіІез”) !== -1))) { 

ТагдеТ . сіаззілзт. ас!сі( "ѵу/апТсІгор"); 
геТцгп Таізе; 

} 

}; 

ТагдеТ.опсІгадоѵег = ТцпсТіоп(е) { іТ (!цріоасііпд) геТцгп Таізе; }; 
ТагдеТ.опсІгадІеаѵе = ТцпсТіоп(е) { 

іТ (! цріоасііпд) Тагдеі.сіаззілзі:. гетоѵе("\ѵап1:сІгор"); 

}; 

ТагдеТ.опсІгор = ТцпсТіоп(е) { 
іТ (цріоасііпд) геіцгп Таізе; 
ѵаг Тііез = е.сІаіаТгапзТег. Тііез; 
іТ (Тііез && Тііез.ІепдТЬ) { 
цріоасііпд = Тгце; 

ѵаг теззаде = "Выгружаются файлы:<ц1>"; 

Тог(ѵаг і = 0; і < Тііез.ІепдТЬ; і++) 

теззаде += "<1і>" + Ті1ез[і]. пате + "</1і>"; 
теззаде += "</ц1>"; 

ТагдеТ. іппегНТМІ. = теззаде; 

ТагдеТ . сІаззИзТ. гетоѵе("ѵу/апТсІгор"); 

ТагдеТ . сІаззІлзТ. ас!сІ( "цріоасііпд"); 
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ѵаг хЬг = пе\ѵ ХМЬНТТрРериезК); 
хЬг.ореп("Р08Т", и гі ); 
ѵаг Ьосіу = пе\ѵ РогггЮаІаО; 

Рог(ѵаг і=0; і < Шез.ІепдіЬ; і++) Ьосіу.аррепс!(і, Шез[і]); 
хЬг.иріоасі.опргодгезз = ГипсТіопСе) { 

ІР (е. ІепдТЬСотриІіаЫе) { 

іагдеі, іппегНТМІ_ = теззаде + 

МаіЬ. гоілісКе. ІоасІесІ/е.То1:а1*100) + 

"% Завершено”; 

} 

}; 

хЬг. ыріоасі.опіоасі = РілісТіопСе) { 
иріоасііпд = Раізе; 

Тагдеі. сІаззИзТ. гетоѵе("иріоасііпд"); 

ТагдеТ. іппегНТМЬ = "Отбуксируйте сюда файл для выгрузки"; 

}; 

хЬг. зепсІ( Ьосіу); 
геіигп Раізе; 

} 

ТагдеТ-сІаззИзІ:. гешоѵе("\ѵап1;сІ гор" ); 

} 

} 

}); 

18.1.5. Прерывание запросов и предельное 
время ожидания 

Выполнение НТТР-запроса можно прерывать вызовом метода аЬогіО объекта 
ХМІНііірРедиезІ:. Метод аЬог1:() доступен во всех версиях объекта хтнирРедиез!, и со¬ 
гласно спецификации «ХНК2» вызов метода аЬог1() генерирует событие «аЪогі». 
(На момент написания этих строк некоторые броузеры уже поддерживали собы¬ 
тие «аЬогі». Наличие этой поддержки можно определить по присутствию свойства 
опаЬоП в объекте ХМЫНІіІгрРедиезІ:.) 

Основная причина для вызова метода аЬогіО - появление необходимости отме¬ 
нить запрос, превышение предельного времени ожидания или если ответ стано¬ 
вится ненужным. Допустим, что объект хтнирРедаезІ: используется для запроса 
подсказки в механизме автодополнения для текстового поля ввода. Если пользо¬ 
ватель успеет ввести в поле новый символ еще до того, как подсказка будет полу¬ 
чена с сервера, надобность в этой подсказке отпадает и запрос можно прервать. 

Спецификация «ХНК2» определяет свойство Іітеоиі:, в котором указывается про¬ 
межуток времени в миллисекундах, после которого запрос автоматически будет 
прерван, а также определяет событие «іітеоиі», которое должно генерироваться 
(вместо события «аЪогі») по истечении установленного промежутка времени. На 
момент написания этих строк броузеры еще не поддерживали автоматическое 
прерывание запроса по истечении предельного времени ожидания (и объекты 
ХИГНИрРедиез! в них не имели свойств іітеоиі и опіітеоиі:). Однако имеется воз¬ 
можность реализовать собственную поддержку прерывания запросов по истече¬ 
нии заданного интервала времени с помощью функции зеІТітеоиіО (раздел 14.1) 
и метода аЬог1(). Как это сделать, демонстрирует пример 18.12. 
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Пример 18.12. Реализация поддержки предельного времени ожидания 


// Выполняет запрос НТТР СЕТ на получение содержимого указанного 1Ж1_. 

// В случае благополучного получения ответа передает содержимое гезропзеТехІ: функции - 
// обратного вызова. Если ответ не пришел в течение указанного времени, выполнение 
// запроса прерывается. Броузеры могут возбуждать событие "геасІузІаТесЬапде" после 
// вызова аЬогТО, а в случае получения части ответа свойство зТаТцз может даже 
// свидетельствовать об успехе, поэтому необходимо установить флаг, чтобы избежать 
// вызова функции в случае получения части ответа при прерывании запроса по превышению 
// времени ожидания. Эта проблема не наблюдается при использовании события Іоасі. 
^цпсііоп ІітесІ6еіТехІ(иг1, Итеоці, саІІЬаск) { 

ѵаг гецііезі: = пем ХМІ_НПрВедиез1:(); // Создать новый запрос, 
ѵаг Итесіоці: = ^аізе; // Истекло ли время ожидания. 

// Запустить таймер, который прервет запрос по истечении 
// времени, заданного в миллесекундах. 

ѵаг іітег = зе*Тітеои*(^ипсІіоп() { // Запустить таймер. Если сработает, 

Итесіоці = Ігце; // установить флаг 
гедцезІ.аЬогіО; // и прервать запрос. 


} 


}. 

Іітеоці); // 

геццезІі.орепС'СЕТ", игі); // 

гецііезІ.опгеасІузіаІесЬапде = ?ипсІіоп() { // 
И (геццезі:. геасіубіаіе !== 4) геіцгп; // 
И (Итесіоці) геітгп; // 

с1еагТітеоц1:(1:ітег); // 

і? (геццезі:. зШьз === 200) // 

са11Ьаск( геццезі:. гезропзеТехІ:); // 

}; 


Интервал времени ожидания 
Указать ІЖІ_ запроса 
Обработчик события. 
Игнорировать незаконч. запрос 
Игнорировать прерв. запрос 
Остановить таймер. 

В случае успеха 
передать ответ функции. 


гедцезі. зепсКпіЛІ); 


// Отправить запрос 


18.1.6. Выполнение междоменных НТТР-запросов 

Будучи субъектом политики общего происхождения (раздел 13.6.2), объект ХМІ_- 
НТТрРедиезТ может использоваться для отправки НТТР-запросов только серверу, 
откуда был получен использующий его документ. Это ограничение закрывает ды¬ 
ру безопасности, но также предотвращает возможность использования объекта 
для вполне законных междоменных запросов. Элементы <Тогт> и <іТгате> позволя¬ 
ют указывать ІЖЬ-адреса с другими доменными именами, и в этих случаях бро¬ 
узеры будут отображать документы, полученные из других доменов. Но из-за ог¬ 
раничений политики общего происхождения броузер не позволит оригинальному 
сценарию исследовать содержимое стороннего документа. При использовании 
объекта ХМ1_Н11рРедиез1: содержимое документа всегда доступно через свойство гез¬ 
ропзеТехІ:, поэтому политика общего происхождения не позволяет объекту ХМІНТТр- 
РечиезТ выполнять междоменные запросы. (Обратите внимание, что элемент 
<зсгір!> в действительности никогда не был субъектом политики общего происхо¬ 
ждения: он будет загружать и выполнять любые сценарии, независимо от их про¬ 
исхождения. Как будет показано в разделе 18.2, такая свобода выполнения меж¬ 
доменных запросов делает элемент <зсгір!> привлекательной альтернативой Діах- 
транспорту на основе объекта ХМІ_Н11рРедиез1.) 

Спецификация «ХНК2» позволяет выполнять междоменные запросы к другим 
веб-сайтам, указанным в заголовке «СОК8» (Сгозз-Огі^іп Кезоигсе 8Ьагіп§) НТТР- 



546 


Глава 18. Работа с протоколом НТТР 


ответа. На момент написания этих строк текущие версии броузеров Гігеіох, 8а?агі 
и СЬгоше поддерживали заголовок «СОК8», а версия ІЕ8 поддерживала собствен¬ 
ный объект ХОотаіпПедиезІ:, который здесь не описывается. Веб-программисту при 
этом не придется делать ничего особенного: если броузер поддерживает заголовок 
«СОК8» для объекта ХМЕНИзрПедиез! и если вы пытаетесь выполнить междоменный 
запрос к веб-сайту, доступ к которому разрешен в заголовке «СОК8», политика 
общего происхождения просто не будет препятствовать выполнению междомен¬ 
ного запроса, и все будет работать само собой. 

Хотя при наличии поддержки заголовка «СОК8» не требуется предпринимать 
какие-то дополнительные шаги для выполнения междоменных запросов, тем не 
менее имеются некоторые детали, касающиеся безопасности, которые желатель¬ 
но понимать. Во-первых, при передаче имени пользователя и пароля методу ореп() 
объекта ХМЫН1;1:рРедиез1; они не будут передаваться в междоменных запросах (в про¬ 
тивном случае это дало бы злоумышленникам возможность взламывать пароли). 
Кроме того, междоменные запросы обычно не допускают включение в них ника¬ 
кой другой информации, подтверждающей подлинность пользователя: соокіез 
и НТТР-лексемы аутентификации обычно не передаются в составе запроса, а лю¬ 
бые соокіез, полученные в результате выполнения междоменного запроса, унич¬ 
тожаются. Если для выполнения междоменного запроса требуется выполнить 
аутентификацию пользователя, перед вызовом метода зепйО следует установить 
свойство міІйСгейепІііаІз объекта ХШ-НИрПедиез! в значение Ігие. Проверка нали¬ 
чия свойства міІОСгесІепІііаІз позволит определить наличие поддержки заголовка 
«СОК8» в броузере, хотя обычно этого не требуется. 

В примере 18.13 приводится ненавязчивый Лаѵа8сгірі-код, использующий объ¬ 
ект ХМШІііірРедиезІ: для выполнения НЕАБ-запросов НТТР с целью получения ин¬ 
формации о типах, размерах и датах последнего изменения ресурсов, на которые 
ссылаются элементы <а>. НЕАБ-запросы выполняются по требованию, а полу¬ 
ченная информация отображается во всплывающих подсказках. В этом примере 
предполагается, что информация не будет доступна для междоменных ссылок, 
тем не менее в броузерах с поддержкой заголовка «СОК8» все равно будут выпол¬ 
няться попытки получить ее. 

Пример 18.13. Получение информации о ссылках с помощью НЕАБ-запросов 

при наличии поддержки заголовка «СОК8» 

/ * * 

* ІіпксІеШІз. ]5 

* 

* Этот модуль в стиле ненавязчивого ЭаѵаЗсгірі: отыскивает все элементы <а> 

* с атрибутом ЬгеГ и без атрибута 1: іііе , и добавляет в них обработчики 

* события оптоцзеоѵег. Обработчик события выполняет НЕАО-запрос с помощью 

* объекта ХМІНирВедцезІ:, чтобы получить сведения о ресурсе, на который 

* указывает ссылка, и сохраняет эту информацию в атрибуте Іі*1е ссылки, 

* благодаря чему эта информация будет отображаться во всплывающей подсказке. 

*/ 

\ѵИепРеасіу(Гипс1:іоп( ) { 

// Поддерживается ли возможность выполнения междоменных запросов? 
ѵаг зііррогІзСОВЗ = (пе\ѵ ХМІНПрВедцезШ)-ѵѵі1:ЬСгесіеп1:іаІ5 !== ипсІеГіпесІ; 

// Обойти в цикле все ссылки в документе 
ѵаг Ііпкз = сіосцтепі:. де1:Е1етеп1:5ВуТад№те( 'а'); 
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І'огСѵаг і = 0; і < Ііпкз. ІепдТІі; і++) { 
ѵаг Ііпк = 1іпкз[і]; 

(! Ііпк.ЬгеО сопИпце; // Пропустить якоря, не являющиеся ссылками 
ІТ (Ііпк.Шіе) сопііпце; // Пропустить ссылки с атрибутом ІШе 

// Если это междоменная ссылка 

ІТ (Ііпк. Поз*! ==1оса1:іоп.Іюзі || Ііпк.ргоіосоі !== Іосаііоп.ргоіосоі) 

{ 

Ііпк.ІШе = "Ссылка на другой сайт"; // Предполагается, что нельзя 

// получить дополнительную информацию 
іі 1 (! зііррогІзСОНЗ) сопііпце; // Пропустить, если заголовок 

// СОПЗ не поддерживается 

// Иначе есть надежда получить больше сведений о ссылке. Поэтому регистрируем 
// обработчик события, который предпримет попытку сделать это. 

} 

// Зарегистрировать обработчик события, который получит сведения 
// о ссылке при наведении на нее указателя мыши 
іі 1 (Ііпк. ас!сіЕѵеп1:1_і5І:епег) 

Ііпк.асІсІЕѵепіІізіепегС'тоизеоѵег", тоцзеоѵегНапсІІег, Шзе); 

еізе 

Ііпк.аиасЬЕѵепІіС'оптоіізеоѵег", тоцзеоѵегНапсІІег); 


І'ііпсііоп тоизеоѵегНапсІІег(е) { 

ѵаг Ііпк = е.іагдеі: || е. згсЕІетепІ:; // Элемент <а> 
ѵаг цгі = Ііпк.ІігеІ 1 ; // 1Ж1_-адрес ссылки 


ѵаг гед = пе\ѵ ХМІ_Н1:1:рНедие5І:(); 
гед.ореп("НЕА0", цгі); 
гед.опгеасіузіаііесііапде = ^цпсІіопО { 
ІТ (гед. геайуЗШе !== 4) геііігп; 
і Т (гед.зіаіііз === 200 ) { 


// Новый запрос 
// Запросить только заголовки 
// Обработчик события 
// Игнорировать незаверш. запросы 
// В случае успеха 


ѵаг іуре = гед. деіНезропзеНеасІегС'СопіепІі-Туре"); //Получить 
ѵаг зіге = гед.деіНе5ропзеНеас1ег("Сопі:епі:-1_епд1:Ь"); //сведения 
ѵаг сіаіе = гед.деіВезропзеНеасіеге'ІазІ-МосіШесі"); //о ссылке 
// Отобразить сведения во всплывающей подсказке. 

Ііпк.іШе = "Тип: " + іуре + " \п" + 

"Размер: " + зіге + " \п" + "Дата: " + йаіе; 

} 

еізе { 

// Если запрос не удался и подсказка для ссылки еще не содержит текст 
// "Ссылка на другой сайт", вывести сообщение об ошибке. 
іТ (! Ііпк.іШе) 

Ііпк.ііііе = "Невозможно получить сведения: \п" + 
гед. зіаіііз + " " + гед. зіаІшзТехІ:; 

} 

}; 

гед. зепсКпіЛІ); 


// Удалить обработчик: попытка получить сведения выполняется только один раз. 
іТ (Ііпк. гетоѵеЕѵеп1:1_і5І:епег) 

Ііпк. гетоѵеЕѵепНізііепегС'тоизеоѵег", тоцзеоѵегНапдіег, Таізе); 

еізе 

Ііпк.деіасЬЕѵепІіС’оптоизеоѵег", тоцзеоѵегНапдіег); 
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18.2. Выполнение НТТР-запросов 
с помощью <5сгір{>: ^СШР 

В начале этой главы упоминалось, что элемент <зсгір1:> можно использовать в ка¬ 
честве Діах-транспорта: достаточно установить атрибут зге элемента <зсгір1:> 
(и вставить его в документ, если он еще не внутри документа), и броузер сгенери¬ 
рует НТТР-запрос, чтобы загрузить содержимое ресурса по указанному ІЖЬ-ад- 
ресу. Основная причина, почему элементы <зсгір1;> являются удобным Діах-транс- 
портом, состоит в том, что они не являются субъектами политики общего проис¬ 
хождения и их можно использовать для запроса данных с других серверов. Вто¬ 
рая причина состоит в том, что элементы <зсгір1:> автоматически декодируют 
(т. е. выполняют) тело ответа, содержащего данные в формате Л8(Ж. 

Прием использования элемента <зсгірі:> в качестве Аіах-транспорта известен под 
названием Л8(ЖР: это способ организации взаимодействий, когда в теле ответа 
на НТТР-запрос возвращаются данные в формате Л8(Ж. Символ «Р» в аббревиа¬ 
туре означает «рас1с1іп&», или «ргейх» (дополнение или приставка), но об этом 
чуть ниже. 1 

Представьте, что вы пишете службу, которая обрабатывает СЕТ-запросы и воз¬ 
вращает данные в формате Л8(Ж. Документы с общим происхождением могут 
пользоваться этой службой с помощью объекта ХШНІіІрПедиезІ: и метода ^(Ж 
рагзе(), как показано в примере 18.3. Если на сервере будет настроена отправка 
заголовка «СОК8», сторонние документы при отображении в новых броузерах 
также смогут пользоваться службой с помощью объекта ХМЫНііІірРедиезІ:. Однако 
при отображении в старых броузерах, не поддерживающих заголовок «СОК8», 
сторонние документы смогут получить доступ к службе только с помощью эле¬ 
мента <зсгір1;>. Ответ в формате Л8(Ж является (по определению) допустимым 
программным кодом на языке ЛаѵаЗсгірі, и броузер выполнит его при получении. 
При выполнении данных в формате Л8(Ж происходит их декодирование, но полу¬ 
ченный результат является обычными данными, которые ничего не делают . 

Именно здесь на сцену выходит символ «Р» из аббревиатуры Л8(ЖР. Когда обра¬ 
щение к службе реализовано с помощью элемента <зсгір1:>, служба должна ♦до¬ 
полнить» ответ, окружив его круглыми скобками и добавив в начало имя Лѵа- 
8сгірі-функции. То есть вместо того чтобы отправлять данные, такие как: 

[1, 2, {"Ьііскіе": "ту зЬое”}] 

она должна отправлять дополненные данные, как показано ниже: 

Ьап<ЯеВезропзе( 

[1. 2, {"Ьискіе": "ту зИое”}] 

) 

Являясь телом элемента <зсгір1:>, этот дополненный ответ уже будет выполнять 
некоторые действия: он произведет преобразование данных из формата ^(Ж (ко¬ 
торые в конечном итоге являются одним длинным выражением на языке ^ѵа- 
8сгірі) и передаст их функции ИапсЯеРезропзеО, которая, как предполагается, оп¬ 
ределена в теле документа и выполняет некоторые операции с данными. 


1 Термин «^<ЖР» предложил Боб Ипполито (ВоЬ Ірроіііо) в 2005 году (кіір://ЪоЪ.ру- 
Ікоптас.огё/агскіѵе8/2005/12/05/гетоіе-і8оп-]8опр/). 
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Сценарии и безопасность 

Используя элемент <зсгір1:> в качестве Діах-транспорта, вы разрешаете сво¬ 
ей веб-странице выполнять любой программный код на языке ЛаѵаЗсгірі, 
который отправит удаленный сервер. Это означает, что прием, описывае¬ 
мый здесь, не должен использоваться при работе с серверами, не вызываю¬ 
щими доверия. Впрочем, даже при работе с доверенным сервером следует 
помнить, что этот сервер может быть взломан злоумышленником, и зло¬ 
умышленник сможет заставить вашу веб-страницу выполнить любой про¬ 
граммный код и отобразить любую информацию, какую он пожелает, и эта 
информация будет выглядеть, как если бы она поступила с вашего сайта. 

При этом следует отметить, что для веб-сайтов стало обычным делом ис¬ 
пользовать доверенные сценарии сторонних разработчиков, особенно сце¬ 
нарии, используемые для внедрения в страницу рекламы или «виджетов». 
Использование элемента <зсгірі:> в качестве Аіах-транспорта для взаимо¬ 
действия с доверенными веб-службами ничуть не опаснее. 


Чтобы этот прием действовал, необходимо иметь некоторый способ сообщить служ¬ 
бе, что обращение к ней выполняется с помощью элемента <зсгір1:> и она должна 
возвращать ответ не в формате Л8(Ж, а в формате Л8(ЖР. Это можно сделать, ука¬ 
зав параметр запроса в адресе ІІКЬ, например, добавив в конец ?]30пр (или &]5опр). 

На практике веб-службы, поддерживающие ^(ЖР, не диктуют имя функции, та¬ 
кое как «ЬапсИеКезропзе», которую должны реализовать все клиенты. Вместо это¬ 
го они используют значение параметра запроса, позволяя клиентам самим указы¬ 
вать имя функции, и применяют его для дополнения ответа. В примере 18.14 для 
определения имени функции обратного вызова используется параметр «ізопр». 
Многие службы, поддерживающие Л8(ЖР, распознают параметр с эти именем. 
Также достаточно часто используется параметр с именем «саІІЪаск», и вы можете 
изменить программный код примера, чтобы он смог работать со службами, предъ¬ 
являющими определенные требования. 

Пример 18.14 определяет функцию де^30МР(), которая выполняет запрос на полу¬ 
чение данных в формате Л8(ЖР. В этом примере есть несколько тонкостей, о ко¬ 
торых следует сказать особо. Во-первых, обратите внимание, что пример создает 
новый элемент <зсгірі:>, устанавливает его ШІЬ-адрес и вставляет элемент в доку¬ 
мент. Операция вставки вызывает выполнение НТТР-запроса. Во-вторых, для 
каждого запроса в этом примере создается новая внутренняя функция обратного 
вызова, которая сохраняется в свойстве самой функции де1^50МР(). Наконец, эта 
функция обратного вызова выполняет необходимые заключительные операции: 
она удаляет элемент <зсгірі:> и саму себя. 

Пример 18.14. Выполнение запросов на получение данных в формате ^ОИР 

с помощью элемента <8сгір1> 

// Выполняет запрос по указанному 1Ш1_-адресу на получение данных в формате иЗОЫР и передает 
// полученные данные указанной функции обратного вызова. Добавляет в 1)В1_ параметр запроса 
// с именем "ізопр", чтобы указать имя функции обратного вызова. 

^цпсНоп де^ЗСМРСцгІ, саІІЬаск) { 
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// Создать для данного запроса функцию с уникальным именем 

ѵаг сЬпцт = "сЬ" + деіиЗОМР.соипіег++; // Каждый раз увеличивать счетчик 

ѵаг сЬпате = "де^ЗОМР. ” + сЬпііт; // Как свойство этой функции 

// Добавить имя функции в строку запроса игі, используя формат представления данных 
// НТМІ_-форм. Здесь используется параметр с именем "ізопр". Некоторые веб-службы 
// с поддержкой ЗЗОЫР могут использовать параметр с другим именем, таким как "саІІЬаск". 
і Т (цгІ.іпсІехОГ("?”) === -1) // ІШІ_ еще не имеет строки запроса 

игі += "?]зопр=" + сЬпате; // добавить параметр как строку запроса 
еізе // В противном случае 

цгі += "&ізопр=" + сЬпате; // добавить как новый параметр. 

// Создать элемент зсгірі, который отправит запрос 
ѵаг зсгірі = сіоситепі. сгеаіеЕ1етепі( "зсгірі"); 

// Определить функцию, которая будет вызвана сценарием 
де^30ИР[сЬпцт] = іипсііоп(гезропзе) { 

Игу { 

са11Ьаск(гезропзе); // Обработать данные 

} 

Гіпаііу { // Даже если функция или ответ возбудит исключение 

сіеіеіе де^80МР[сЬпит]; // Удалить эту функцию 

зсгірі. рагепІИосІе. гетоѵеСЬіІсКзсгірІ:); // Удалить элемент зсгірі: 

} 

}; 

// Инициировать НТТР-запрос 

зсгірі. зге = игі; // Указать ьгі-адрес элемента 

сіосшпепі:.ЬосІу.аррепсІСЫІсКзсгірі); // Добавить в документ 

} 

деіЗЗОИР.соьпіег = 0; // Счетчик, используемый для создания уникальных имен 

18.3. Архитектура Сотеі на основе 
стандарта «5егѵег-5еп1 Еѵепіз» 

Проект стандарта «8егѵег-8епі Еѵепіз» определяет объект Еѵепі8оигсе, который 
делает практически тривиальным создание приложений с архитектурой Сотеі. 
При его использовании достаточно передать ШІЬ-адрес конструктору ЕѵепіЗои гсе() 
и затем обрабатывать события «те88а&е» в полученном объекте: 

ѵаг ііекег = пем ЕѵепіЗоигсеС’зіоскргісез.рЬр"); 
ііекег.оптеззаде = іипсііоп(е) { 
ѵаг іуре = е.іуре; 
ѵаг сіаіа = е.сіаіа; 

// Обработать строки іуре и сіаіа. 

} 

Объект события «шезба^е» имеет свойство сіаіа, хранящее строку, отправленную 
сервером с этим событием в качестве полезной нагрузки. Кроме того, объект собы¬ 
тия имеет свойство Іуре, как и все другие объекты событий. По умолчанию это свой¬ 
ство имеет значение «те88а&е», но источник события может указать в этом свойстве 
другую строку. Все события от данного сервера, источника событий, обрабатыва¬ 
ются единственным обработчиком оптез8аде, который при необходимости может 
передавать их другим обработчикам, опираясь на свойство іуре объекта события. 
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Протокол обмена, определяемый стандартом «8егѵег-8епі Еѵепі», достаточно 
прост. Клиент устанавливает соединение с сервером (когда создает объект Еѵепі- 
Зоигсе), а сервер сохраняет это соединение открытым. Когда происходит событие, 
сервер передает через соединение текстовую строку. Передача события через сеть 
выглядит примерно следующим образом: 

еѵепі : ЬісІ установка свойства Туре объекта события 
сіаіа : 6006 установка свойства сіаіа 

сіаіа : 999 добавляется перевод строки и дополнительные данные 

пустая строка генерирует событие теззаде 

Протокол имеет также некоторые дополнительные особенности, позволяющие 
присваивать событиям идентификаторы и дающие клиенту возможность после 
восстановления соединения с сервером передавать этот идентификатор, чтобы 
сервер мог повторно послать все события, пропущенные клиентом. Однако эти 
особенности не имеют большого значения в данном обсуждении. 

Одно из очевидных применений архитектуры Сотеі - реализация чатов: клиент 
может посылать в чат новые сообщения с помощью объекта ХМІ_НіірРедие5і и под¬ 
писываться на поток сообщений, поступающих от собеседников, с помощью объ¬ 
екта ЕѵепіЗоигсе. Пример 18.15 демонстрирует, насколько просто реализовать 
клиента на основе объекта ЕѵепіЗоигсе. 


Пример 18.15. Простой клиент чата на основе объекта ЕѵепіЗоигсе 

<зсгірі> 

хѵіпсіоѵу/.опіоасі = іипсііоп() { 

// Позаботиться о некоторых особенностях пользовательского интерфейса 
ѵаг піск = рготрі:("Введите ваше имя"); // Получить имя пользователя 

ѵаг іпрьі = сіоситепі.деіЕІетепіВуІсК "іприі"); // Отыскать поле ввода 
іприі. іосиз(); // Передать фокус ввода 


// Подписаться на получение новых сообщений 
ѵаг сЬаі = пе\ѵ Еѵепі5оигсе("/сЬаі"); 
сЬаі.оптеззаде = іипсііоп(еѵепі) { 
ѵаг тзд = еѵепі. сіаіа; 
ѵаг посіе = сіоситепі:.сгеаіеТехіМосІе(т5д); 
ѵаг сііѵ = сіоситепі. с геаіеЕ1етепі( "сііѵ"); 
сііѵ. аррепсІСШсК посіе); 
сіоситепі. Робу. іпзе ПВе^о ге(сііѵ, іприі); 
іприі. 5сго11ІпіоѴіе\л/(); 

} 


с помощью объекта ЕѵепіЗоигсе 

// Получив новое сообщение, 

// Извлечь текст 
// Преобр. в текстовый узел 
// Создать <с!іѵ> 

// Добавить текст, узел в сііѵ 
// И добавить сііѵ перед іпрьі: 
// Прокрутить до появления 
// іприі: в видимой области 


// Передавать сообщения пользователя на сервер с помощью ХМІ-НіірВедиезІ: 


іприі:. опсПапде = І^псііопО { 

ѵаг тзд = піск + ": " + іприі.ѵаіие; 
ѵаг хЬг = пе\ѵ ХМІНіірПедиезіС); 
хЬг.ореп("Р03Т", "/сЬаІ:"); 
хЬг. зеіВедиезіНеасІегС'Сопіепі-Туре", 


хНг.зепд(тзд); 
іприі.ѵаіие = 


// При нажатии клавиши Епіег 
// Имя пользователя + введ. текст 
// Создать новый ХНВ 
// РОЗТ-запрос к /сНаі. 

//Тип - простой текст ІДР-8 
"іехі/ріаіп; сЬагзеі=ІЯР-8"); 

// Отправить сообщение 
// Приготовиться к вводу 
// следующего сообщения 


}; 


</зсгірі> 

<!-- Пользовательский интерфейс чата состоит из единственного поля ввода --> 
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<!-- Новые сообщения, отправленные в чат, вставляются перед полем ввода --> 

<іпрцІ ісі="іприі:" 5Ту1е="ѵас11:Іі: 100%"/> 

На момент написания этих строк объект ЕѵепііЗоигсе поддерживался в СЬгоше 
и 8а?агі и должен был быть реализован компанией МогШа в первом же выпуске 
Гіге^ох, вышедшем после версии 4.0. В броузерах (таких как Гігеіох), где реали¬ 
зация объекта ХМЬНіііірВедиезі: возбуждает событие «геасІувІаІесЬапзе» в ходе за¬ 
грузки ответа (для значения З в свойстве геасІуЗііаІіе) многократно, поведение объ¬ 
екта ЕѵепііЗоигсе относительно легко имитировать с помощью объекта ХМІНПрРе- 
диезі:, как демонстрируется в примере 18.16. С модулем имитации пример 18.15 
будет работать в СЬгоше, 8а?агі и Гігеіох. (Пример 18.16 не будет работать в бро¬ 
узерах ІБ и Орега, поскольку реализации объекта ХМЬНіііірВедиезІ: в этих броузерах 
не генерируют события в ходе загрузки.) 

Пример 18.16. Имитация объекта ЕѵепіЗоигсе с помощью ХМЫШрЯедиезі 

// Имитация прикладного интерфейса ЕѵепіЗоцгсе в броузерах, не поддерживающих его. 

// Требует, чтобы ХМЬНТТрВедцезТ генерировал многократные события геаРузІаІіесЬапде 
// в ходе загрузки данных из долгоживущих НТТР-соединений. Учтите, что это не полноценная 
// реализация АРІ: она не поддерживает свойство геабуЗТаІіе, метод с1озе(), а также 
// события ореп и еггог. Кроме того, регистрация обработчика события шеззаде выполняется 
// только через свойство опшеззаде -- эта версия не определяет метод ас1с1Еѵеп1:І_і5І:епег 
ІГ (міпсіоѵу/. ЕѵепііЗоигсе === ііпсІеГіпесІ) { // Если ЕѵепіЗоигсе не поддерживается, 

ѵііпдоѵі. ЕѵепІЗоцгсе = Гипсііоп(цгі) { // использовать эту его имитацию, 

ѵаг хЬг; // НТТР-соединение... 

ѵаг еѵізгс = ІЬіз; // Используется в обработчиках, 

ѵаг сПагзВесеіѵеб = 0; // Так определяется появление нового текста 

ѵаг іуре = пцЦ; // Для проверки свойства Іуре ответа, 

ѵаг сіаіа = // Хранит данные сообщения 

ѵаг еѵепІМаше = "шеззаде"; // Значение поля Іуре объектов событий 

ѵаг ІазіЕѵепІІР = ""; // Для синхронизации с сервером 

ѵаг геігубеіау = 1000; // Задержка между попытками соединения 

ѵаг аЬогІеР = Іаізе; // Установите в Ігце, чтобы разорвать соединение 

// Создать объект ХНВ 
хііг = п еѵі ХМЕНИрВедцезК); 

// Определить обработчик события для него 
хііг.опгеарузііаііесііапде = ГцпсІіопО { 

5мі1:сП(хПг. геаРуЗіаІе) { 

сазе 3: ргосезз0а1:а(); Ьгеак; // При получении фрагмента данных 

сазе 4: гесоппесІ(); Ьгеак; // По завершении запроса 

} 

}; 

// И установить долгоживущее соединение 
соппесК); 

// Если соединение было закрыто обычным образом, ждать секунду 
// и попробовать восстановить соединение 
Гцпсііоп гесоппесК) { 

іГ (аЬогІеР) геіцгп; // Не восстанавливать после 

// принудительного прерывания 

іГ (хЬг.зІаіцз >= 300) геіцгп; // Не восстанавливать после ошибки 
зеіТітеоцКсоппесІ, геігуреіау); // Ждать и повторить попытку 

}; 
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// Устанавливает соединение 
ТцпсТіоп соппесТО { 
сЬагзВесеіѵед = 0; 

Туре = пиіі; 

хЬг.орепС’бЕТ", игі); 

хЬг. 5еТВедцезТНеадег( 'ТасЬе-СопТгоГ' , "по-сасЬе"); 
іТ (ІазТЕѵепТід) 

хЬг. зеТВедцезТНеадег("І_азТ-ЕѵепТ-ІО", ІазТЕѵепТід); 
хЬг.зепсК); 

} 

// При получении данных обрабатывает их и вызывает обработчик оптеззаде. 
// Эта функция реализует работу с протоколом $егѵег-$епТ ЕѵепТз 
ТцпсТіоп ргосеззОаТа() { 

іТ (!Туре) { // Проверить тип ответа, если это еще не сделано 
Туре = хПг.деТВезропзеНеас1ег(’СопТепТ-Туре’); 
іТ (Туре !== "ТехТ/еѵепТ-зТгеат") { 
аЬогТеб = Тгііе; 
хЬг. аЬогТ(); 
геТцгп; 

} 

} 

// Запомнить полученный объем данных и извлечь только ту часть ответа, 
// которая еще не была обработана, 
ѵаг сЬцпк = хЬг. гезропзеТехТ. зцЬзТгіпд(сЬагзВесеіѵед); 
сЬагзВесеіѵед = хЬг. гезропзеТехТ. ІепдТЬ; 

// Разбить текст на строки и обойти их в цикле. 

ѵаг Нпез = сіиіпк. гер1асе(/(\г\п|\г|\п)$/, зрНТ(/\г\п|\г|\п/); 

Тог(ѵаг і = 0; і < Ппез. ІепдТЬ; і++) { 

ѵаг Ппе = 1іпез[і], роз = Нпе. іпРехОТС паше, ѵа1це=""; 
іТ (роз == 0) сопТіпііе; // Игнорировать комментарии 

іТ (роз > 0) { // поле пате: ѵаіце 

паше = Ппе. зцЬзТгіпд(0, роз); 
ѵаіііе = Ипе. зцЬзТгіпд(роз+1); 

іТ (ѵаіііе.сЬагАТ(О) == " ") ѵаіце = ѵаіце.зцЬзТгіпд(І); 

} 

еізе паше = Нпе; // только поле паше 

зѵаТсЬ(пате) { 

сазе "еѵепТ": еѵепТМаше = ѵаіце; Ьгеак; 

сазе "сЗаТга”: дата += ѵаіце + "\п"; Ьгеак; 

сазе "ісГ: ІазТЕѵепТід = ѵаіце; Ьгеак; 

сазе "геТгу": геТгуРеІау = рагзеіпт(ѵаіце) || 1000; Ьгеак; 

ЬеТацІТ: Ьгеак; // Игнорировать любые другие строки 

} 

іТ (Ппе === “") { // Пустая строка означает отправку события 
іТ (еѵТзгс. оптеззаде && сІаТа !== "") { 

// Отсечь завершающий символ перевода строки 
іТ (даТа.сЬагАТ(даТа.1епдТЬ-1) == "\п") 

ЬаТа = даТа.зцЬзТгіпд(0, дата.1епдТЬ-1); 
еѵТзгс.оптеззаде({ // Имитация объекта ЕѵепТ 

Туре: еѵепТМаше, // тип события 

дата: дата, // данные 

огідіп: цгі // происхождение данных 
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Глава 18. Работа с протоколом НТТР 


}); 

} 

сіаііа = 
сопТіпію; 


Завертим описание архитектуры Сотеі примером серверного сценария. В при¬ 
мере 18.17 приводится реализация НТТР-сервера на серверном ЛѵаЗсгірі, кото¬ 
рый выполняется под управлением интерпретатора Коде (раздел 12.2). Когда кли¬ 
ент обращается к корневому ШІЬ «/», сервер отправляет ему реализацию клиента 
чата, представленную в примере 18.15, и реализацию имитации, представлен¬ 
ную в примере 18.16. Когда клиент выполняет ОЕТ-запрос по ШІЬ-адресу «/сЪаі*, 
сервер сохраняет поток ответа в массиве и поддерживает соединение открытым. 
А когда клиент выполняет Р08Т-запрос к адресу «/сЬаі», сервер интерпретирует 
тело запроса как текст сообщения и добавляет префикс «даіа:», как того требует 
протокол 8егѵег-8епі Еѵепіз, во все открытые потоки сообщений. Если вы уста¬ 
новите интерпретатор Коде, вы сможете запустить этот пример сервера локально. 
Он прослушивает порт 8000, поэтому после запуска сервера в броузере необходи¬ 
мо будет указать адрес НіІр://ІосаІНозІ:8000 , чтобы соединиться с сервером и на¬ 
чать общение с самим собой. 

Пример 18.17. Сервер чата, поддерживающий протокол 8егѵег-8епІ Еѵепіз 

// Этот программный код на серверном ЭаѵаЗсгір* предназначен для выполнения 

// под управлением ИосІеЭЗ. Он реализует очень простую, полностью анонимную комнату чата. 

// Для отправки новых сообщений в чат следует использовать РОЗТ-запросы к ІШІ_ /сітаі: , 

// а для получения текста/потока-событий сообщений следует использовать СЕТ-запросы 
// к тому же 0В1_. При выполнении СЕТ-запроса к / возвращается простой НТМІ_-файл, 

// содержащий пользовательский интерфейс чата для клиента. 

ѵаг НПр = гедіііге( 'ЬПр'); // Реализация АРІ НТТР-сервера в ИосІеЭЗ 

// НТМІ_-файл для клиента чата. Используется ниже. 

ѵаг сііепіііі = гециі ге(' 1=3'). геас!Рі1еЗупс("сМаІісІіепі:. М:т1"); 

ѵаг етіііаііоп = гедіііге( ’^з'). геас!Рі1еЗупс("Еѵепі:ЗоигсеЕти1а1:іоп.]з"); 

// Массив объектов ЗегѵегПезропзе, который будет использоваться для отправки событий 
ѵаг сііепііз = []; 

// Отправлять комментарий клиентам каждые 20 секунд, чтобы предотвратить 
// закрытие соединения с последующими попытками восстановить его 
зе1:Іп1:егѵа1(Гипс1:іоп() { 

сііепіз. І'огЕасН^ипсІіопСсІіепІ:) { 
сііепі:. ѵѵгі1:е('': ріпд\п"); 

}); 

}, 20000 ); 

// Создать новый сервер 

ѵаг зегѵег = пеѵѵ ЬПр. 5егѵег(); 

// Когда сервер получит новый запрос, он вызовет эту функцию 
зегѵег. оп("гедцез1:", Гііпсііоп (гедиезі:, гезропзе) { 

// Проанализировать запрошенный ІШІ_ 

ѵаг игі = гедиіге( 'игГ ).рагзе( гедиезі:. и гі); 
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// Если запрошен ІЖІ_ "/", отправить пользовательский интерфейс чата. 
іТ (игі.раіНпате === "/") { // Запрошен пользовательский интерфейс чата 
гезропзе.ѵѵгіі:еНеасЗ(200, С'СопііепТ-Туре": ''ТехТ/ЫтІ"}); 
гезропзе. мгііеСЧзсгірІУ + етіііаііоп + ”</зс гір1:>”); 
гезропзе.мгіТе(сІіепТиі); 
гезропзе. епс1(); 
геііігп; 

> 

// Если запрошен любой другой ДОІ., кроме “/сІіаТ", отправить код 404 
еізе іТ (іігі. раІРпате !== "/сЬаТ") { 
гезропзе. ѵ\/гіі:еНеасІ(404); 
гезропзе. епс!(); 
геіигп; 

} 

// Если был выполнен Р0$Т-запрос - клиент отправил новое сообщение 
іТ (гедііезІмпеІПосІ === "Р05Т") { 
гедііезі:. зет Епсосіі пд (" ыт ^8"); 
ѵаг Робу = 

// При получении фрагмента данных добавить его в переменную Робу 
гедиезІ.опС'РаІа", ^ипсТіоп(сІіипк) { Робу += сНііпк; }); 

// По завершении запроса отправить пустой ответ 
// и широковещательное сообщение всем клиентам, 
гедііезі:. оп("епсГ, ^ьпсТіопО { 

гезропзе. мгііеНеасК 200); // Ответ на запрос 
гезропзе. епсі( ); 

// Преобразовать сообщение в формат текст/поток-событий. 

// Убедиться, что все строки начинаются с префикса "Раіа:" 

// и само сообщение завершается двумя символами перевода строки, 
теззаде = ’сіаіа: ' + Робу. гер1асе( Дп', 'Уісіаіа: ') + *'\г\п\г\п"; 

// Отправить сообщение всем клиентам 

сііепіз.^огЕасН^ітсІіопСсІіепІ:) { с1іеп*.мгі*е( теззаде); }); 

>); 

} 

// Если иначе, клиент запросил поток сообщений 
еізе { 

// Установить тип содержимого и отправить начальное событие теззаде 
гезропзе. мгііеНеасК 200, { 'Сопіепі-Туре' : "Іехі/еѵепі-зігеат" }); 
гезропзе. ѵігіхе( “сіаіа: Соппес1:ес1\п\п"); 

// Если клиент закрыл соединение, удалить соответствующий 
// объект гезропзе из массива активных клиентов 
гедііезі:. соппесІіоп.опС'епсГ, ^ііпсііопО { 

сііепіз. 5р1ісе(с1іеп1:5. іпРехОІЧ гезропзе), 1); 
гезропзе.епр(); 

>); 

// Запомнить объект гезропзе, чтобы в дальнейшем посылать сообщения с его помощью 
сііепіз.рьзР(гезропзе); 

} 

}); 

// Запустить сервер на порту 8000. Чтобы подключиться к нему, используйте 
// адрес РПр://1оса1Роз1::8000/ 
зегѵег. 1із1:еп(8000); 
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Библиотека і()иегу 


В языке ^ѵаЗсгірІ чрезвычайно простой базовый и весьма сложный клиентский 
АРІ, который к тому же отягощен многочисленными несовместимостями между 
броузерами. С выходом ІБ9 исчезли самые неприятные несовместимости, но мно¬ 
гие программисты считают, что веб-приложения удобнее писать с использовани¬ 
ем фреймворков или вспомогательных библиотек на языке ЛѵаЗсгірі, упрощаю¬ 
щих решение типичных задач и скрывающих различия между броузерами. На 
момент написания этих строк одной из наиболее популярных и широко исполь¬ 
зуемых была библиотека іС^иегу. 1 

Библиотека зСіиегу получила весьма широкое распространение, и поэтому веб¬ 
разработчики должны быть знакомы с ней: даже если вы не собираетесь ее ис¬ 
пользовать, вы наверняка встретитесь с ней в сценариях, написанных другими. 
К счастью, библиотека іС^иегу весьма стабильна и достаточно мала, чтобы ее мож¬ 
но было описать в этой книге. В этой главе дается обстоятельное введение, а в чет¬ 
вертой части вы найдете краткий справочник по библиотеке іС^иегу. В справочни¬ 
ке отсутствуют отдельные статьи для методов из библиотеки іСіиегу, однако в ста¬ 
тье ]0иегу даются краткие описания всех методов. 

Библиотека іСіиегу упрощает поиск элементов документа и облегчает манипулиро¬ 
вание ими: добавление содержимого, изменение НТМЬ-атрибутов и С88-свойств, 
определение обработчиков событий и воспроизведение анимационных эффектов. 
Она также имеет вспомогательные функции поддержки архитектуры Азах, по¬ 
зволяющие выполнять динамические НТТР-запросы, и функции общего назна¬ 
чения для работы с объектами и массивами. 

Как следует из ее имени, основу библиотеки іС^иегу составляет реализация меха¬ 
низма запросов. Типичный запрос использует С88-селектор, идентифицирую¬ 
щий множество элементов документа, и возвращает объект, представляющий 
эти элементы. Данный возвращаемый объект имеет множество удобных методов 


і 


В число широко используемых входят также не описываемые в этой книге библиотеки 
Ргоіоіуре, ѴШ и (іоіо. Еще большее количество библиотек можно отыскать в Интерне¬ 
те, выполнив поиск по фразе « ^ѵаВсгірі ИЬгагіез». 
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для выполнения операций над всей группой выбранных элементов. Всякий раз, 
когда это возможно, эти методы возвращают объект, относительно которого они 
вызывались, что позволяет использовать прием составления цепочек из вызовов 
методов. Ниже перечислены особенности, которые обеспечивают широту воз¬ 
можностей и удобство использования библиотеки іС^иегу: 

• Выразительный синтаксис (С88-селекторов) для ссылок на элементы в доку¬ 
менте 

• Эффективная реализация механизма запросов, выполняющего поиск множе¬ 
ства элементов документа, соответствующих указанному С88-селектору 

• Множество удобных методов для манипулирования множествами выбранных 
элементов 

• Мощные приемы функционального программирования для выполнения опе¬ 
раций сразу над всей группой элементов 

• Выразительная идиома представления последовательностей операций (со¬ 
ставление цепочек из вызовов методов) 

Эта глава начинается с введения в библиотеку іС^иегу, где будет показано, как вы¬ 
полнять простейшие запросы и как обрабатывать результаты. В последующих 
разделах описывается: 

• Как изменять НТМЬ-атрибуты, стили и классы С88, значения и содержимое 
элементов НТМЬ-форм, управлять геометрией и данными 

• Как изменять структуру документа, вставляя, замещая, обертывая и удаляя 
элементы 

• Как использовать модель событий библиотеки іС^иегу, совместимую со всеми 
броузерами 

• Как с помощью іС^иегу воспроизводить анимационные визуальные эффекты 

• Как выполнять НТТР-запросы с помощью механизма поддержки архитекту¬ 
ры Азах, реализованном в библиотеке іС^иегу 

• Вспомогательные функции іС^иегу 

• Полный синтаксис селекторов іС^иегу, и как использовать расширенные мето¬ 
ды поиска из библиотеки іС^иегу 

• Как расширять библиотеку іС^иегу, создавая и используя расширения 

• Библиотека іС^иегу ІЛ 

19.1. Основы іОиегу 

Библиотека і(}иегу определяет единственную глобальную функцию с именем 
]0иегу(). Эта функция используется настолько часто, что библиотека определяет 
также глобальное имя $, как сокращенный псевдоним этой функции. Эти два 
имени - все, что библиотека іС^иегу добавляет в глобальное пространство имен. 1 


1 Если вы определяете собственное имя $ в своих сценариях или используете другую 
библиотеку, такую как Ргоіоіуре, тоже использующую имя $, вы можете вызвать ме¬ 
тод іОііегу.поСопИісІіО, чтобы восстановить оригинальное значение имени $. 
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Глава 19. Библиотека іОиегу 


Эта глобальная функция с двумя именами является центральной функцией ме¬ 
ханизма запросов в библиотеке іС^иегу. Например, ниже показано, как можно за¬ 
просить множество всех элементов <йіѵ> в документе: 

ѵаг (Ііѵз = $("с!іѵ"); 

Эта функция возвращает множество из нуля или более элементов БОМ, которое 
называется объектом ]0иегу. Обратите внимание, что ]0иегу() является фабрич¬ 
ной функцией, а не конструктором: она возвращает вновь созданный объект, но 
она используется без ключевого слова пем. Объект ]0иегу определяет множество 
методов для выполнения операций над множеством элементов, которое он пред¬ 
ставляет, и большая часть главы будет посвящена описанию этих методов. Ниже 
приводится пример инструкции, которая отыскивает, выделяет цветом и быстро 
отображает все скрытые элементы <р>, имеющие класс «сіеіаііз»: 

$("р. сіеііаііз" ).С5з( 'Ьаскдгоітсі-соіог'' , "уеііом" ). зЬсм( "Газі:" ); 

Метод сзз() оперирует объектом ]0иегу, возвращаемым функцией $(), и возвращает 
этот же объект, благодаря чему метод зИо\л/() может быть вызван в этой же компакт¬ 
ной «цепочке вызовов методов». Этот прием составления цепочек является весьма 
характерным при использовании библиотеки іС^иегу. В качестве другого примера 
ниже демонстрируется инструкция, выполняющая поиск всех элементов, имею¬ 
щих С88-класс «сІіскіоЬісІе», и регистрирующая обработчик события в каждом из 
них. Этот обработчик вызывается, когда пользователь щелкает на элементе и за¬ 
ставляет элемент медленно «выезжать» за границы окна вверх и скрываться: 

$(". сІіскІіоИісІе" ). с1іск(Гипс1:іоп( ) { $(1:Ьіз).з1іс1еир("5ІоѵО; }); 

19.1.1. Функция іОиегу() 

Функция ]0иегу( ) (она же $()) является наиболее важной в библиотеке і(}иегу. Од¬ 
нако она существенно перегружена и может быть вызвана четырьмя разными 
способами. 

Первый и наиболее типичный способ вызова $() предусматривает передачу ей 
С88-селектора (строки). При вызове таким способом она возвращает множество 
элементов из текущего документа, соответствующих селектору. Библиотека 
в значительной степени поддерживает синтаксис селекторов С883 плюс некото¬ 
рые собственные расширения. Более подробное описание синтаксиса селекторов 
ІСІиегу приводится в разделе 19.8.1. Если во втором аргументе передать функции 
$() элемент или объект ]0иегу, она вернет только элементы-потомки указанного 
элемента или элементов, соответствующие селектору. Этот необязательный вто¬ 
рой аргумент определяет начальную точку (или точки) выполнения запроса 
и часто называется контекстом . 

При втором способе вызова функции $() передается объект Еіетепі:, Ооситепі: или 
іл/іпсіом. Подобный вызов просто обертывает элемент, документ или окно объектом 
]0иегу и возвращает его. Это дает возможность манипулировать элементом с по¬ 
мощью методов объекта ]0иегу вместо низкоуровневых методов модели БОМ. На¬ 
пример, в программах, использующих библиотеку іС^иегу, часто можно встре¬ 
тить вызов $(с!оситеп1:) или $(1:1іі5). Объекты ]0иегу могут представлять множество 
элементов документа, а кроме того, функции $() можно передавать массив эле¬ 
ментов. В этом случае возвращаемый объект ]0иегу будет представлять множест¬ 
во элементов, имевшихся в массиве. 
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Получение библиотеки іОиегу 

Библиотека іС^иегу является свободно распространяемым программным 
обеспечением. Ее можно загрузить с сайта кіір://ідиегу.сот. Получив биб¬ 
лиотеку, вы сможете подключать ее к своим веб-страницам с помощью эле¬ 
мента <$сгірі:>, как показано ниже: 

<зсгірі: 5гс=' ^иегу-1 .4.2. тіп. "></зсгір1:> 

Слово «тіп» в имени файла выше указывает, что используется минимизиро¬ 
ванная версия библиотеки, из которой были удалены комментарии и лиш¬ 
ние пробелы, а внутренние идентификаторы были заменены более коротки¬ 
ми именами. 

Другой способ задействовать библиотеку іСіиегу в своих веб-приложениях 
заключается в использовании сети распространения библиотеки, для чего 
достаточно указать любой из следующих ШІЬ-адресов: 

Ш*р://сосІе. ідііегу. сот/ідііегу-1.4.2. тіп. із 

Іі«р://аіах. тісгозо^. сот/аіах/ідиегу/ідиегу-1.4.2. тіп. і 8 

Шр://аіах.доод1еарі8.сот/аіах/1іЬ8/ідііегу/1.4.2/ідиегу.тіп. ]8 

В этой главе описывается библиотека іС^иегу версии 1.4. Если вы пользуе¬ 
тесь другой версией, замените номер версии «1.4.2» в ІІКЬ-адресах выше 
на требуемый вам. 1 Если вы пользуетесь сетью распространения Ооо&іе 
СБК, вы можете указать номер версии «1.4», чтобы получить самую све¬ 
жую версию в ветке 1.4.x, или просто «1», чтобы получить самую свежую 
версию ниже 2.0. Основное преимущество использования подобных широ¬ 
ко известных адресов состоит в том, что благодаря огромной популярности 
ІСІиегу посетители вашего веб-сайта наверняка будут иметь копию библио¬ 
теки в кэше своих броузеров, и веб-приложению не придется тратить до¬ 
полнительное время на ее загрузку. 


При третьем способе вызова функции $() передается строка с разметкой НТМЬ. 
В этом случае библиотека іС^иегу создаст НТМЬ-элемент или элементы, опреде¬ 
ляемые этой разметкой, и вернет представляющий их объект ]0иегу. Библиотека 
ІСІиегу не вставляет вновь созданные элементы в документ, но методы объекта 
]0иегу, описываемые в разделе 19.3, позволяют легко вставить их в любое место. 
Обратите внимание, что таким образом функции $() нельзя передать простой 
текст, так как в этом случае і(}иегу решит, что вы передали С88-селектор. При 
таком способе вызова строка, передаваемая функции $(), должна включать хотя 
бы один НТМЬ-тег в угловых скобках. 

При вызове третьим способом функция $() может принимать необязательный 
второй аргумент. В нем можно передать объект Ооситепі:, чтобы указать документ, 


1 На момент написания этой главы текущей версией библиотеки зСІиегу была 1.4.2. Когда 
книга готовилась к печати, была выпущена версия зСІиегу 1.5. Изменения в іС}иегу 1.5 
в основном касаются механизма поддержки архитектуры Діах и будут упоминаться 
в разделе 19.6. 
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с которым должны быть связаны элементы. (Если, к примеру, предполагается, 
что создаваемые элементы будут вставлены в элемент <іГгате>, необходимо явно 
указать объект документа этого фрейма.) Или передать объект во втором аргу¬ 
менте. В этом случае предполагается, что свойства объекта определяют имена 
и значения НТМЬ-атрибутов, которые должны быть установлены во вновь соз¬ 
данном элементе. Но если объект будет содержать свойства с такими именами, 
как «сев», «Мті», «Іехі», «\ѵі(Ші*, «Ьеі&М», «оіізеі*, «ѵаі* или «сіаіа», или свойст¬ 
ва с именами, совпадающими с именами методов регистрации обработчиков со¬ 
бытий в библиотеке іС^иегу, она будет вызывать методы с этими именами для 
вновь созданного элемента и передавать им значения соответствующих свойств. 
(Методы, такие как сзз(), Н1:т1() и 1ехІ() рассматриваются в разделе 19.2, а мето¬ 
ды регистрации обработчиков событий - в разделе 19.4). Например: 

ѵаг ішд = $("<ітд/>", // Создать новый элемент <ітд> 

{ 5гс:иг1, //с этим НТМІ_-атрибутом, 

С55: { Ьогс1егѴу/ісЛ:Ь : 5}, // этим С35-стилем 

сііск: ЬапсІІеСІіск // и этим обработчиком события. 

}); 

Наконец, при четвертом способе вызова функции $() передается функция. В этом 
случае указанная вами функция будет вызвана, когда документ будет полностью 
загружен и дерево БОМ документа будет готово к выполнению операций. Это вер¬ 
сия функции опІ_оасК ), представленной в примере 13.5, реализованная в библиоте¬ 
ке і(}иегу. Очень часто можно встретить іС^иегу-программы, реализованные в ви¬ 
де анонимных функций, объявляемых в вызове функции ]0иегу( ): 

ІОііегу^ітсІііог^ ) { // Будет вызвана по окончании загрузки документа 
// Здесь находится весь программный код, использующий ^Оііегу 

}); 

Иногда можно увидеть вызов $(Г), оформленный в старом и более явном стиле: 

$(с!оситеп 1 :). геасІуСО- 

Функция, передаваемая ]0иегу(), будет вызвана со ссылкой іііііз, указывающей 
на объект йоситепі:, и функцией ]0иегу в качестве единственного аргумента. Это 
означает, что вы можете удалить глобальное определение функции $ и по-преж¬ 
нему использовать этот удобный псевдоним локально, как показано ниже: 

ІОііегу. поСопГіісііО; // Восстановить оригинальное значение $ 

3 Оиегу( ^ипсіііоп ($) { // Использовать $ как локальный псевдоним функции іОиегу 
// Здесь находится весь программный код, использующий ^Оиегу 

}): 

Функции, зарегистрированные с помощью $(), будут вызваны библиотекой 
ІСІиегу, когда будет возбуждено событие «БОМСопіепіЬоа<1е<1» (раздел 13.3.4) или, 
если это событие не поддерживается, когда будет возбуждено событие «Іоасі». То 
есть когда документ будет загружен и полностью разобран, но внешние ресурсы, 
такие как изображения, еще могут быть не загружены. Если функцию передать 
в вызов $() после того, как дерево БОМ будет готово, она будет вызвана немедлен¬ 
но, перед тем как $() вернет управление. 

Кроме того, библиотека іС^иегу использует функцию ]0иегу() как собственное про¬ 
странство имен и определяет в нем множество вспомогательных функций и свойств. 
Одной из таких вспомогательных функций является функция ]0иегу. поСоітГ1іс1( ), 
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упоминавшаяся выше. В числе других функций общего назначения можно на¬ 
звать функцию ]Оиегу.еасМ(), предназначенную для выполнения итераций, ]0ие- 
гу.рагзе^ОМО - для синтаксического анализа данных в формате ^СЖ. Перечень 
вспомогательных функций общего назначения приводится в разделе 19.7, а дру¬ 
гие вспомогательные функции из библиотеки іС^иегу описываются на протяже¬ 
нии всей главы. 


Терминология іОиегу 

Давайте остановимся, чтобы определить некоторые важные термины, ко¬ 
торые будут встречаться на протяжении этой главы: 

«функция іОиегу » 

Функция і(}иегу - это значение ]0иегу или $. Эта функция создает объ¬ 
екты ]0иегу, регистрирует обработчики, которые вызываются, когда де¬ 
рево БОМ будет готово к выполнению операций, а также служит про¬ 
странством имен библиотеки іС^иегу. Я обычно использую имя $(). По¬ 
скольку она служит пространством имен, функция іС^иегу может также 
называться «глобальным объектом і(}иегу», но очень важно не путать ее 
с «объектом ]0иегу». 

«объект ]($иегу» 

Объект ]0иегу- это объект, возвращаемый функцией іС^иегу. Объект 
]0иегу представляет множество элементов документа и может также на¬ 
зываться «результатом функции іС^иегу», «множеством іС^иегу» или 
«обернутым набором». 

«выбранные элементы» 

Когда функции і(}иегу передается С88-селектор, она возвращает объект 
]0иегу, представляющий множество элементов документа, соответст¬ 
вующих этому селектору. При описании методов объекта ]0иегу я часто 
буду употреблять фразу «выбранные элементы», ссылаясь на элементы 
множества. Например, при описании метода а11г() я мог бы сказать: 
«метод а11г() устанавливает НТМЬ-атрибуты выбранных элементов». 
Вместо более точной, но трудно читаемой фразы: «метод а11г() устанав¬ 
ливает НТМЬ-атрибуты элементов в объекте ]0иегу, относительно кото¬ 
рого он был вызван». Обратите внимание, что слово «выбранных» отно¬ 
сится к С88-селектору и не имеет никакого отношения к элементам, 
выбираемым пользователем. 

«функция библиотеки ](іиегу» 

Функция библиотеки і(}иегу - это функция, такая как ]0иегу. поСопИіс1:( ), 
которая определена в пространстве имен функции іС^иегу. Функции биб¬ 
лиотеки іС^иегу могут также упоминаться как «статические методы». 

«метод іСіиегу» 

Метод іС^иегу- это метод объекта ]0иегу, возвращаемого функцией 
ІСІиегу. Наиболее важной частью библиотеки іС^иегу являются мощные 
методы, которые она определяет. 
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Иногда сложно уловить различия между методами объекта ]0иегу и функ¬ 
циями библиотеки }(}иегу, потому что многие методы и функции имеют - 
одинаковые имена. Обратите внимание, что следующие две строки про¬ 
граммного кода выполняют разные операции: 

// Вызвать функцию еасІі() библиотеки ^Оііегу, чтобы вызвать функцию Г 
// для каждого элемента массива а 
$.еасМ(а,Г); 

// Вызвать функцию ^ОііегуО, чтобы получить объект ^Оііегу, представляющий 
// все элементы <а> в документе. Затем вызвать метод еасІі() этого объекта ^Оііегу, 

// чтобы вызвать функцию Г для каждого выбранного элемента. 

$( "а' ).еасІі(Г); 

В официальной документации по библиотеке }(}иегу, которую можно найти 
на сайте Ыір:Щдиегу.сот у такие имена, как $.еасП, используются для ссыл¬ 
ки на функции библиотеки і(^иегу, а такие имена, как . еасИ (с точкой, но без 
знака доллара), - для ссылки на методы объекта ]0иегу. Вместо них в этой 
книге я буду использовать термины «функция» и «метод». Что именно под¬ 
разумевается, обычно будет достаточно очевидно из контекста обсуждения. 


19.1.2. Запросы и результаты запросов 

Когда функции $() передается С88-селектор, она возвращает объект ]0ііегу, пред¬ 
ставляющий множество («выбранных») элементов, соответствующих селектору. 
С С88-селекторами мы познакомились в разделе 15.2.5, куда вы можете вернуть¬ 
ся, чтобы освежить память, - все примеры селекторов, представленные там, мо¬ 
гут передаваться функции $(). Конкретный синтаксис селекторов, поддерживае¬ 
мый библиотекой і(^иегу, подробно будет рассматриваться в разделе 19.8.1. Одна¬ 
ко, прежде чем углубиться в особенности синтаксиса селекторов, мы сначала раз¬ 
беремся с тем, что можно делать с результатами запроса. 

Возвращаемым значением функции $() является объект ]0иегу. Объекты ]0иегу - 
это объекты, подобные массивам: они имеют свойство ІепдІіМ и свойства с число¬ 
выми именами, начиная с О до Іепдііѵі. (Подробнее об объектах, подобных масси¬ 
вам, рассказывается в разделе 7.11.) Это означает, что к содержимому объекта 
]0иегу можно обращаться, используя стандартный синтаксис обращения к эле¬ 
ментам массива с квадратными скобками: 

$( "Ьосіу" ). 1епд1:1п // => 1: документ имеет единственный элемент Ьойу 
$(" Ьосіу” )[0] // То же самое, что гіосіітепі: . Ьойу 

Если при работе с объектом ]0ііегу вы предпочитаете не использовать синтаксис 
массивов, вместо свойства ІепдІіМ можно использовать метод 5ііе(), а вместо ин¬ 
дексов в квадратных скобках - метод де1(). Если потребуется преобразовать объ¬ 
ект ]0иегу в настоящий массив, можно вызвать метод 1оАггау(). 

В дополнение к свойству ІепдІіМ объекты ]0иегу имеют еще три свойства, представ¬ 
ляющие определенный интерес. Свойство зеіесііог хранит строку селектора (если 
таковая имеется), которая использовалась при создании объекта ]0иегу. Свойство 
сопіехі: ссылается на объект контекста, который был передан функции $() во вто- 
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ром аргументе, в противном случае оно будет ссылаться на объект Оосытепі:. Нако¬ 
нец, все объекты ]0иегу имеют свойство ідиегу, проверка наличия которого явля¬ 
ется самым простым способом отличить объект ]0ііегу от любого другого объекта, 
подобного массиву. Значением свойства ]дыегу является строка с номером версии 
библиотеки }(}иегу: 

// Отыскать все элементы <зсгір1:> в теле документа 
ѵаг ЬоРузсгірііз = $("зсгірі;", Росіітепі: . Ьосіу); 

ЬоРузсгірІз.зеіесіюг // => "зсгірі;" 

ЬоРузсгірііз.сопііехІ: // => Росіітепі:. ЬоРу 
ЬоРузсгірІіз. ідііегу // => "1.4.2" 


Если потребуется обойти в цикле все элементы в объекте ]0иегу, вместо цикла 1"ог 
можно использовать метод еасО( ). Метод еасО( ) напоминает метод ’ГогЕасПС ) масси¬ 
вов, определяемый стандартом ЕСМАЗсгірі 5 (Е85). В единственном аргументе 
он принимает функцию обратного вызова, которая будет вызвана для каждого 
элемента в объекте ]0иегу (в порядке следования в документе). Эта функция вы¬ 
зывается как метод элемента, т.е. внутри функции ключевое слово Шз ссылает¬ 
ся на объект Еіетепі:. Кроме того, метод еас!і( ) передает функции обратного вызова 
индекс и элемент в первом и втором аргументах. Обратите внимание, что ссылка 
іііііз и второй аргумент ссылаются на обычные элементы документа, а не на объ¬ 
екты ]0иегу. Если для работы с элементом внутри функции потребуется использо¬ 
вать методы объекта ]0иегу, передайте этот элемент функции $(). 

Метод еас!і() объекта ]0иегу имеет одну особенность, которая существенно отли¬ 
чает его от метода *ГогЕасП( ): если функция обратного вызова вернет ^аізе для ка¬ 
кого-либо элемента, итерации будут остановлены после этого элемента (это напо¬ 
минает использование ключевого слова Ьгеак в обычном цикле). Метод еас!і() воз¬ 
вращает объект ]0ііегу, относительно которого он был вызван, благодаря чему он 
может использоваться в цепочках вызовов методов. Например (здесь использует¬ 
ся метод ргерепсК ), который будет описан в разделе 19.3): 


// Пронумеровать элементы Ріѵ документа вплоть до элемента Ріѵйіазі: (включительно) 
$( "Ріѵ" ). еасі^ітсіііог^ісіх) { // отыскать все элементы <Ріѵ> и обойти их 

$( іііііз ). ргерепР(іРх // Вставить индекс в начало каждого 

і? (1:Ііі5.іР === "Іазі:") ге^ьгп Шзе; // Остановиться по достижении 
}); // элемента йіазі: 


Несмотря на широту возможностей, метод еасО( ) не слишком часто используется 
на практике, поскольку методы объекта ]0иегу обычно неявно выполняют итера¬ 
ции по всем выбранным элементам и выполняют операции над ними всеми. На¬ 
добность в методе еас!і( ) обычно возникает только в случае, когда необходимо об¬ 
работать выбранные элементы каким-то другим способом. Но даже в этом случае 
необходимость в методе еас!і() может отсутствовать, поскольку многие методы 
объекта ]0иегу позволяют передавать функцию обратного вызова. 

Библиотека ](}иегу поддерживает методы массивов, определяемые стандартом 
Е85, и содержит пару методов, по своей функциональности похожих на методы 
в стандарте Е85. Метод тар() объекта ]0иегу действует практически так же, как 
метод Аггау.тар(). Он принимает функцию обратного вызова в виде аргумента 
и вызывает ее для каждого элемента в объекте ]0иегу, собирая значения, возвра¬ 
щаемые этой функцией, и возвращая новый объект ]0иегу, хранящий эти значе¬ 
ния. Метод тар( ) вызывает функцию точно так же, как это делает метод еас!і( ): он 



564 


Глава 19. Библиотека іОиегу 


передает ей элемент в виде ссылки Шз и во втором аргументе, а в первом аргумен¬ 
те - индекс элемента. Если функция обратного вызова вернет пиіі или ипсІеГіпесІ, 
это значение будет проигнорировано и не будет добавлено в новый объект ]0иегу. 
Если функция обратного вызова вернет массив или объект, подобный массиву 
(такой как объект ]0ыегу), этот объект будет «развернут» и содержащиеся в нем 
элементы по отдельности будут добавлены в новый объект ]0ііегу. Обратите вни¬ 
мание, что объект ]0иегу, возвращаемый методом тар(), может хранить объекты, 
не являющиеся элементами документа, но он по-прежнему будет действовать как 
объект, подобный массиву. Например: 

// Отыскать все заголовки, отобразить их в значения их атрибутов ІР, 

// преобразовать результат в настоящий массив и отсортировать его. 

$(*' :ІіеаРег").тар(Гипс1:іоп( ) { геіюгп Шз. ІР; } )ЛоАггау(). 5огі:( ); 


$() в сравнении с яиегу$еІесІогАІІ() 

Функция $() похожа на метод диегу8е1ес1:огА11() объекта Ооситепі:, с кото¬ 
рым мы познакомились в разделе 15.2.5: оба принимают С88-селектор 
в виде аргумента и возвращают объект, подобный массиву, хранящий эле¬ 
менты, соответствующие селектору. Библиотека і(}иегу использует метод 
диегу8е1ес1:огА11() в броузерах, поддерживающих его, однако существуют 
веские причины, почему в своих программах следует использовать функ¬ 
цию $(), а не метод диегу8е1ес1:огА11(): 

• Метод диегу8е1ес1:огА11( ) был реализован производителям броузеров от¬ 
носительно недавно. Функция $() работает не только в новых, но и в ста¬ 
рых броузерах. 

• Благодаря тому что библиотека }(}иегу может производить выборку эле¬ 
ментов «вручную», селекторы С883, поддерживаемые функцией $(), мо¬ 
гут использоваться во всех броузерах, а не только в тех, что поддержи¬ 
вают С883. 

• Объект, подобный массиву, возвращаемый функцией $() (объект ]0иегу), 
намного удобнее в работе, чем объект (МогіеНзІ), возвращаемый методом 

диегу8е1ес1:огА11(). 


Наряду с методами еасП() и тар() объект ]0иегу имеет еще один фундаментальный 
метод - іпсіех( ). Этот метод принимает элемент в виде аргумента и возвращает его 
индекс в объекте ]0ііегу или -1, если указанный элемент не будет найден. Однако, 
что типично для ]0ыегу, метод іпсіех( ) имеет перегруженные версии. Если в качестве 
аргумента передать методу іпйехО объект ]0иегу, он попытается отыскать первый 
элемент из этого объекта. Если передать строку, метод іпс!ех( ) будет использовать ее 
как С88-селектор и вернет индекс первого элемента в объекте ]0иегу, соответствую¬ 
щего селектору. А если вызвать метод іпс!ех() без аргументов, он вернет индекс пер¬ 
вого элемента в объекте ]0ыегу среди элементов одного с ним уровня вложенности. 

Последним методом общего назначения объекта ]0иегу, с которым мы познако¬ 
мимся здесь, является метод із( ). Он принимает селектор в виде аргумента и воз¬ 
вращает Іігие, если хотя бы один из выбранных элементов соответствует указан- 
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ному селектору. Его можно использовать в функции обратного вызова, передавае¬ 
мой методу еасІп(), например: 

$( "с!іѵ'‘). еасІп( ^ипс1:іоп() { // Для каждого элемента <гііѵ> 

Н ($(ТІіі5). із(’‘:Іпісісіеп")) геТіігп; // Пропустить скрытые элементы 
// Выполнить операции с видимыми элементами 

}): 

19.2. Методы чтения и записи объекта іОиегу 

Простейшими и часто используемыми операциями, которые выполняются над 
объектами ]0иегу, являются операции чтения и изменения значений НТМЬ-атри- 
бутов, стилей С88, содержимого элементов и их геометрии. В данном разделе опи¬ 
сываются методы, используемые для выполнения этих операций. Однако перед 
этим необходимо сделать некоторые обобщения, касающиеся методов чтения и за¬ 
писи объекта іС^иегу: 

• Вместо того чтобы определять парные методы, библиотека іС^иегу использует 
одни и те же методы как для чтения, так и для записи. Если передать методу 
новое значение, он запишет это значение. Если новое значение не указано, ме¬ 
тод вернет текущее значение. 

• При использовании методов для записи они записывают новое значение во все 
элементы, находящиеся в объекте ]0иегу, и возвращают объект ]0иегу, что по¬ 
зволяет использовать их в цепочках вызовов методов. 

• При использовании методов для чтения они читают значение только из перво¬ 
го элемента в наборе и возвращают единственное значение. (Если необходимо 
получить значения из всех элементов, используйте метод тар().) Поскольку 
методы чтения не возвращают объект ]0иегу, они могут использоваться только 
в конце цепочек вызовов методов. 

• При использовании методов для записи они часто могут принимать объекты 
в виде аргументов. В этом случае каждое свойство указанного объекта будет 
определять имя и устанавливаемое значение. 

• При использовании методов для записи они часто могут принимать вместо 
значений функции. В этом случае функция будет использоваться для вычис¬ 
ления устанавливаемого значения. Элемент, для которого должно быть вы¬ 
числено значение, будет передан функции в ссылке ІіРіз, в первом аргументе 
будет передан индекс элемента, а во втором аргументе - текущее значение. 

Продолжая чтение раздела, помните об этих общих чертах методов чтения и за¬ 
писи. Каждый из следующих подразделов описывает отдельную категорию мето¬ 
дов чтения/записи объекта ]0иегу. 

19.2.1. Чтение и запись значений НТМІ_-атрибутов 

Метод аИг() объекта ]0иегу- это метод чтения/записи значений НТМЬ-атрибу- 
тов, и к нему относятся все обобщения, описанные выше. Метод аИг() предусмат¬ 
ривает решение проблемы несовместимости броузеров и обработку специальных 
случаев и позволяет использовать имена НТМЬ-атрибутов или имена эквивалент¬ 
ных им свойств в языке Лѵа8сгірІ (где они отличаются). Например, можно ис¬ 
пользовать имя «іог» или «МтІЕог», «сіазз» или «сІаззКате». гетоѵеА1:1:г() - это 
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родственная функция, которая полностью удаляет атрибут из всех выбранных 
элементов. Ниже приводятся несколько примеров использования этих методов:, 

$('ѣогт").а1:1:г("ас1:іоп"); // Получить атрибут асѣіоп 1-й формы 

$("#ісоп" ).а11:г("5гс" 1 "ісоп.діГ'); // Установить атрибут зге 
$("#Ьаппег").а1:1:г({5гс:"Ьаппег.діГ\ аіі: : 'Асіѵегіізетегѵ*;' , // Установить сразу 4 атрибута 

тбХЬ:720, ИеідІтІ: :64}); 

$("а").а1:1:г("і:агде1:" , "_Ыапк"); // Все ссылки загружать в новых окнах 

$("а").аТТг("ТагдеТ", Гііпс1:іоп( ) { // Локальные ссылки загружать локально 

іГ (ТПіз. ПозТ == Іосаѣіоп.Иозі: ) геѣіігп "_зе1Г" 

еізе геѣіігп ”_Ыапк"; // Внешние ссылки загружать в новых окнах 

}); 

$("а").аѣѣг({ѣагдеѣ: ГііпсѣіопО {...}}); // Можно также передать функцию 
$("а").гетоѵеАТТг("ТагдеТ"); // Все ссылки загружать в этом окне 

19.2.2. Чтение и запись значений С55-атрибутов 

Метод С55() напоминает метод аѣ1:г( ), но работает не с НТМЬ-атрибутами, а со сти¬ 
лями С88 элемента. При чтении значений стилей метод сзз() возвращает текущий 
(или «вычисленный»; раздел 16.4) стиль элемента: возвращаемое значение может 
быть определено в атрибуте зііуіе или в таблице стилей. Обратите внимание, что 
нельзя получить значения составных стилей, таких как «Іопі» или «таг&іп». 
Вместо этого следует запрашивать отдельные стили, такие как «Іопі-ѵѵеі&М», 
«&>пІ-?аті1у», «таг&іп-іор» или «таг&іп-іеіі». При записи значений стилей метод 
сзз() просто добавляет их в атрибут зііуіе элемента. Метод сзз() позволяет указы¬ 
вать имена стилей С88 с дефисами («Ъаск&гоипсі-соіог») или имена свойств в язы¬ 
ке ЛаѵаЗсгірі с переменным регистром символов («Ъаск&гоипсІСоІог»). При чтении 
значений стилей метод сзз() возвращает числовые значения в виде строк с добав¬ 
лением единиц измерения в конце. Однако при записи он преобразует числа 
в строки и добавляет суффикс «рх» (ріхеіз - пикселы), если это необходимо: 

$("М").сзз(" Гопѣ-меідЫ"); // Насыщенность шрифта первого элемента <М> 

$("М").сзз(" ГопѣІл/еідЫ”); // Допускается использовать имена свойств 
$С'М").с55('Топі:"); // Ошибка: нельзя запрашивать составные стили 

$( ”Г»1"). С55(" ^опіі-ѵагіапі: ”, "зтаіісарз”); // Установить стиль всех элементов <М> 

$("сЛѵ.поѣе") .сззС’ЬогРег", "зоПб Ыаск 2рх"); // Составные стили можно устанавливать 
$( М ).сзз({ ЬаскдгоішРСоІог: "Ыаск", // Записать сразу несколько стилей 

ѣехѣСоІог: "ѵЛпѣе", // имена с переменным регистром 

ѣопѣѴагіапІ: : "зтаіі-сарз", // лучше подходят на роль имен 
райсЛпд: "Юрх 2рх 4рх 20рх", // свойств объекта 
ЬогРег: "Роѣѣесі Ыаск 4рх" }); 

// Увеличить размер шрифта во всех элементах <М> на 25% 

$("М").сзз("'ГогЦ-5і2е , ’ 1 ГцпсѣіопЦ,сигѵаі) { 
геѣцгп МаѣИ.гоітР(1.25*рагзеІп1:(сіігѵа1)); 

}): 

19.2.3. Чтение и запись СЗЗ-классов 

Напомню, что значение атрибута сіазз (в языке ЛаѵаЗсгірі доступного в виде свой¬ 
ства сІаззМате) интерпретируется как список имен классов С88, разделенных про¬ 
белами. Обычно бывает необходимо добавить, удалить или проверить присутст¬ 
вие какого-то одного имени в списке, тогда как потребность замещать один список 
классов другим возникает крайне редко. По этой причине в объекте ]0иегу опреде- 
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лены удобные методы для работы с атрибутом сіазз. Методы ас!с1С1азз() и гетоѵе- 
С1азз() добавляют и удаляют классы в выбранных элементах. Метод 1:одд1еС1азз() 
добавляет классы в элемент, если они отсутствуют в нем, и удаляет их, если они 
присутствуют. Метод ИазСІаззО проверяет присутствие указанного класса. Ниже 
приводятся несколько примеров использования этих методов: 

// Добавление 088-классов 
$( "М"). асМС1азз( "ІйШе" ); 

$("М+р").а(МС1азз( "НіШе ?ігзТ" ); 

ЗС'зесТіоп"). асМСІазз^ііпсТіопСп) { 
геТіігп "зесТіоп" + п; 

}); 

// Удаление 088-классов 
$("р"). гетоѵеС1азз("НіШ:е"); // Удалить класс из всех элементов <р> 

$( 'р'). гетоѵеСІаззС’ІйІіТе гзі:” ): // Допустимо удалять несколько классов 

$("зесІіоп").гетоѵеСІазз^ітсТіоп^) { // Удалить вычисляемый класс из элем, 
геішгп "зесТіоп" + п; 

}); 

$("біѵ").гетоѵеСІаззО; // Удалить все классы из всех <біѵ> 

// Переключение 088-классов 

$(Чг:одсГ).1:одд1еС1а55С , о(МгоѵГ); // Добавить класс, если отсутствует, 

// или удалить в противном случае 

$("М").1:одд1еС1а55("Ыд ЬоІсГ); // Переключить сразу два класса 

$("М").1:одд1еС1а55(і : ипс1:іоп(п) { // Переключить вычисляемый класс 

геіьгп "Ыд Ьоій М-" + п; // или классы 

}); 

$(''М'').{одд1еС1а55("Ші1:е", 1:гие); // Действует как асМСІазз 

$('П1").1:одд1еС1а55(''Ііі1і1:е", і'аізе); // Действует как гетоѵеСІазз 

// Проверка 088-классов 

$("р”)-Ііа5С1а55("'Гіг5І") // Имеет ли какой-нибудь <р> этот класс? 

$("#1еасГ). ізС'. ^ігзі") // То же самое 

$С'#1еасГ). із(". гзі: . Ітіііііе'*) // із() - более гибкий, чем ПазСІаззО 

Обратите внимание, что метод ПазСІаззО не такой гибкий, как методы асЮСІаззО, 
гетоѵеС1азз( ) и 1:одд1еС1а5з(). Метод ПазС1а5з() может работать только с одним име¬ 
нем класса и не поддерживает возможность передачи ему функции. Он возвраща¬ 
ет 1:гие, если хотя бы один из выбранных элементов содержит указанный класс, 
и Таізе- в противном случае. Метод із() (описываемый в разделе 19.1.2) более 
гибкий и может использоваться для той же цели. 

Эти методы объекта ]0иегу подобны методам свойства сІаззИзІ, о котором расска¬ 
зывалось в разделе 16.5, но методы объекта ]0иегу работают во всех броузерах, 
а не только в тех, которые поддерживают свойство сІаззИзІ, определяемое стан¬ 
дартом НТМЬб. И, конечно же, методы объекта ]0иегу работают с множеством 
элементов и могут добавляться в цепочки вызовов методов. 

19.2.4. Чтение и запись значений элементов НТМЬ-форм 

Метод ѵа1() служит для чтения и записи значений атрибутов ѵаіие элементов 
НТМЬ-форм, а также для чтения и записи состояния выбора флажков, радиокно¬ 
пок и элементов <зе1ес1:>: 


// Добавить класс во все элементы <М> 
// Добавить 2 класса в <р> после <М> 
// Передать функцию, чтобы добавить 
// вычисляемый класс во все 
// выбранные элементы 
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$("#5іігпате").ѵа1() // Получить значение текстового поля зіігпате 

$("#изз1:а1:е"). ѵа1( ) // Получить единственное значение из элемента <зе1ес1:> 

ЗС'зеІесійехІгаз”). ѵа1( ) // Получить массив значений из <зе1ес1: пш11ір1е> 


$(” іприі: : габіо[пате=зІйр] хИескесГ). ѵа1( ) 

$("#етаі1" ). ѵаІС'ІпѵаІід етаіі асМгезз') 
$("іприі:: сИескЬох" ). ѵаі([ "оріі", "ор12" ]) 

$("іприі:ТехТ”).ѵа1(ГипсТіоп() { 
геТьт ІІііз.сіе'РаиІ'ІѴаІие; 

}) 


// Получить значение атрибута 

// сНескеб радиокнопки 

// Установить значение текст, поля 

// Установить флажки с указанными именами 

// или значениями 

// Сбросить все текстовые поля 

// в значения по умолчанию 


19.2.5. Чтение и запись содержимого элемента 

Методы 1ех1( ) и ІП:т1( ) читают и записывают содержимое элемента или элементов 
в виде простого текста или разметки НТМЬ. При вызове без аргументов метод 
ІехіО возвращает содержимое всех вложенных текстовых узлов из всех выбран* 
ных элементов в виде простого текста. Этот метод работает даже в броузерах, не 
поддерживающих свойства ІехіСопіепі: и іппегТехІ: (раздел 15.5.2). 

Если вызвать метод ІтІт1( ) без аргументов, он вернет в виде разметки НТМЬ содер¬ 
жимое только первого выбранного элемента. Для этой цели библиотека і(}иегу ис¬ 
пользует свойство іппегНТМІ.: х.ІгІтІО - фактически то же самое, что и х[0].іппегНТМІ.. 

Если методу ІехІ( ) или Ітіт1( ) передать строку, она будет использована как содер¬ 
жимое элемента в виде простого текста или разметки НТМЬ и заместит текущее 
его содержимое. Подобно другим методам записи, с которыми мы уже познако¬ 
мились, этим методам можно также передать функцию, которая будет использо¬ 
вана для получения строки с новым содержимым: 


ѵаг іШе = $( "ІпеасІ ІШе").ІехІ() 
ѵаг ПеасЛіпе = $("М").Іііт1() 

$("М").Іехі(Гипсііоп(п, си ггепі) { 

геіигп "§" + (п+1) + ": " + сиггепі: 

}); 


// Получить заголовок документа 
// Получить разметку Ыті первого <М> 
// Добавить в каждый заголовок 
// порядковый номер раздела 


19.2.6. Чтение и запись параметров геометрии элемента 

В разделе 15.8 мы узнали, насколько сложно бывает определить размер и коорди¬ 
наты элемента, особенно в броузерах, не поддерживающих метод деІВоипсІіпдСІіепІ:- 
ПесіО (раздел 15.8.2). Библиотека ^(}иегу упрощает эти вычисления, предостав¬ 
ляя методы, работающие в любых броузерах. Обратите внимание, что все мето¬ 
ды, описываемые здесь, являются методами чтения, и лишь некоторые из них 
могут использоваться для записи. 

Метод оГГзеіО позволяет получить или изменить координаты элемента. Этот ме¬ 
тод определяет координаты относительно начала документа и возвращает их 
в виде объекта со свойствами ІеП и Іор, в которых хранятся координаты X и У. 
Если передать методу объект с этими свойствами, он изменит координаты эле¬ 
мента в соответствии с указанными значениями. При необходимости он также 
установит С88-атрибут розШоп, чтобы сделать элемент позиционируемым: 

ѵаг еИ = $("#зргіІе"); // Элемент, который требуется переместить 

ѵаг розіііоп = еіі. оГГзе1:( ): // Получить текущие координаты 
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розШопЛор += 100; // Изменить координату У 

еІТ.о^зеКрозіТіоп); // Переместить элемент в новую позицию 

// Переместить все элементы <М> вправо на расстояние, зависящее от их 

// положения в документе 

$("М"). о^^зеТ(^цпсТіоп(іп(1ех 1 сіігроз) { 

геТіігп {ІеМ:: сцгроз.ІеМ: + 25*іпРех, 1:ор:сь гроз. Тор} ; 

}): 

Метод розШопО похож на метод оТТзеТО, за исключением того, что он позволяет 
только читать координаты и возвращает координаты элемента не относительно на¬ 
чала документа, а относительно его родителя. В разделе 15.8.5 мы узнали, что ка¬ 
ждый элемент имеет свойство оІ^зеТРагепІ:, ссылающееся на родительский элемент, 
относительно которого определяются координаты. Позиционируемые элементы 
всегда играют роль начала координат для своих потомков, но некоторые броузеры 
дают эту роль и некоторым другим элементам, таким как ячейки таблицы. Роль 
начала координат в библиотеке }(}иегу могут играть только позиционируемые эле¬ 
менты, и метод о^зе*Рагеп*() объекта ]0иегу отображает каждый элемент на бли¬ 
жайший позиционируемый вмещающий элемент или на элемент <Ьос1у>. Следует 
отметить не совсем удачный выбор имен этих методов: о^зеШ возвращает абсо¬ 
лютные координаты элемента относительно начала документа, а метод розШопО 
возвращает смещение элемента относительно его ближайшего предка оТ "ГзеІіРа гепі: (). 

Существует также три метода чтения, позволяющие получить ширину, и три ме¬ 
тода чтения, позволяющие получить высоту элемента. Методы ѵ\/іс11:Ь() и ЬеідЫО 
возвращают базовые значения ширины и высоты, не включающие отступы, рам¬ 
ки и поля. Методы іппегМісІІіІ’іО и іппегНеідМ:() возвращают ширину и высоту эле¬ 
мента с отступами (слово «іппег» (внутренний) указывает на тот факт, что эти ме¬ 
тоды возвращают ширину и высоту внутри рамки). Методы ои1:егѴ\/іс11:Ь() и оиііег- 
НеідМ:() по умолчанию возвращают размеры элемента с отступами и рамкой. Ес¬ 
ли этим методам передать значение Ігііе, они добавят размеры полей элемента. 
Следующий фрагмент демонстрирует, что для элемента можно получить четыре 
разные ширины: 

ѵаг ЬоЬу = $( "Ьосіу" ); 

ѵаг соп*еп*Мі(ЦІі = ЬоЬу.міЫ:Ь(); 

ѵаг расШпдІл/іЫіЬ = ЬоЬу. іппегМісЛ:Ь(); 

ѵаг ЬогРегМісЛіЬ = Ьосіу.оц1:егІл/ісЛ:П(); 

ѵаг тагдіпМісЛЬ = Ьос1у.ои1:егІл/ісЛ:Ь(1:гие); 

ѵаг расШпд = раЬЫпдІл/ісЛ:Ь-соп1;еп1:Іл/ісЛ:Ь; // сумма левого и правого отступов 
ѵаг ЬогРегз = ЬогРегМіРііЬ-раЬЬіпдІл/ісІіЬ; // сумма толщины левой и правой рамки 
ѵаг тагдіпз = тагдіпіл/ісЛ:Ь-ЬогсіегѴ\/ісЛ:Ь; // сумма левого и правого полей 

Методы ѵѵіс11:Ь() и ЬеідМ:() обладают свойствами, отсутствующими у других четы¬ 
рех методов (методов іппег и оиііег). Во-первых, если первый элемент в объекте 
]0иегу является объектом Міпсіоѵѵ или Ооситепі:, эти методы вернут размер видимой 
области окна или полный размер документа. Другие методы работают только 
с элементами, не являющимися окнами или документами. 

Другая особенность методов \л/іс!1:Ь( ) и ЬеідЫ:( ) заключается в том, что они являют¬ 
ся также методами записи. Если передать значение этим методам, они установят 
ширину или высоту всех элементов в объекте ]0иегу. (Обратите, однако, внима¬ 
ние, что они не могут изменять ширину или высоту объектов Міпсісм и Ооситепі:.) 
Если аргумент имеет числовое значение, он будет интерпретироваться как число 
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пикселов. Если передать строку, она будет использоваться как значение С88-ат- 
рибута иісіііР или ИеідІгЬ, благодаря чему в ней можно указывать любые единицы 
измерения, предусматриваемые стандартом С88. Наконец, как и другие методы 
записи, они могут принимать функцию, которая будет вызываться для вычисле¬ 
ния значения ширины или высоты. 

Между ролями чтения и записи методов \ѵіс!1:Гі() и МеідП1:() существует маленькое 
несоответствие. При использовании в качестве методов чтения они возвращают 
размеры элемента по содержимому, исключая отступы, рамки и поля. Однако 
при использовании в качестве методов записи они просто устанавливают С88-ат- 
рибуты \л/ісЛ:іі и МеідИІ:. По умолчанию эти атрибуты также определяют размеры по 
содержимому. Но если элемент имеет С88-атрибут Ьох-зіііпд (раздел 16.2.3.1), ус¬ 
тановленный в значение ЬогРег-Ьох, методы ѵ\/іс11:Р( ) и ІіеідІгЬО будут устанавливать 
размеры, включающие ширину отступов и рамок. Для элемента е, использующе¬ 
го блочную модель «сопіепі-Ьох*, вызов $(е). ѵ\/іс!1:М(х).\ѵіс!1;М( ) вернет значение х. Од¬ 
нако для элемента, использующего блочную модель «Ъопіег-Ъох», этот же вызов 
в общем случае вернет другое значение. 

Последняя пара методов объекта ]0ыегу, имеющих отношение к геометрии эле¬ 
ментов, - это методы зсгоПТорО и зсго1ИеГ1;(), позволяющие получить позиции 
полос прокрутки для элемента или множество позиций полос прокрутки для всех 
элементов. Эти методы могут применяться и к элементам документа, и к объекту 
ілііпсіом, а при вызове для объекта Ооситепі: они возвращают или устанавливают по¬ 
зиции полос прокрутки объекта Міпсісм, хранящего документ. В отличие от других 
методов записи, методам зсгоПТорО и зсгоІПеГШ нельзя передавать функции. 

Метод зсгоПТорО как метод чтения и записи можно использовать в паре с мето¬ 
дом МеідГі1:( ), чтобы на их основе определить метод, прокручивающий окно на ука¬ 
занное число страниц: 

// Прокручивает окно на п страниц, п может быть дробным и отрицательным числом 
Гцпсііоп раде(п) { 

ѵаг \н = $(ѵапбоѵ0; // Обернуть окно объектом іОцегу 

ѵаг радезіге = N. ИеідГИ: (); // Получить размер страницы 

ѵаг сцггепі: = N. зсго11Тор(); // Текущие позиции полос прокрутки 

N. 5Сго11Тор(сііггепі: + п*радезі 2 е); // Установить новые позиции 
} // полос прокрутки 

19.2.7. Чтение и запись данных в элементе 

Библиотека }(}иегу определяет метод чтения/записи с именем Раі:а(), который 
возвращает или устанавливает данные, связанные с любым элементом докумен¬ 
та или с объектами Ооситепі: и Міпсіом. Возможность связывать данные с любыми 
элементами является одной из наиболее важных и мощных особенностей: она ле¬ 
жит в основе механизма регистрации обработчиков событий и последовательно¬ 
стей визуальных эффектов в библиотеке зСЗиегу, и в определенных случаях метод 
сІаІаО может оказаться полезным в ваших сценариях. 

Чтобы связать данные с элементами в объекте ]0иегу, нужно вызвать йа*а() как 
метод записи, передав ему в виде двух аргументов имя и значение. Методу сІаІаО 
как методу записи можно также передать единственный объект, каждое свойство 
которого будет использоваться как пара имя/значение, связываемая с элементом 
или элементами в объекте ]0иегу. Однако обратите внимание, что, когда методу 
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сІаІаО передается объект, свойства этого объекта будут замещать все данные, ра¬ 
нее связанные с элементом или элементами. В отличие от многих других методов 
записи, с которыми мы уже познакомились, метод гіаіаО не вызывает функцию, 
переданную ему. Если во втором аргументе передать методу с!а1:а() функцию, она 
будет сохранена, как любое другое значение. 

Конечно, метод с!а1:а() может также использоваться в роли метода чтения. При 
вызове без аргументов он возвращает объект, содержащий все пары имя/значе¬ 
ние, связанные с первым элементом в объекте ]0иегу. При вызове метода сІаІаО 
с единственным строковым аргументом он возвращает значение, связанное с этой 
строкой в первом элементе. 

Для удаления данных из элемента или элементов можно использовать метод гегтю- 
ѵе0а1:а(). (Вызов метода сІаІаО с именованным значением пиіі или ипсІе'ГіпесІ факти¬ 
чески не удаляет данные.) Если методу геглоѵе0а1:а() передать строку, он удалит 
значение, связанное с этой строкой в элементе или элементах. Если вызвать ме¬ 
тод гетоѵе0а1:а( ) без аргументов, он удалит все данные: 

$("йіѵ").(1аІа("х ,, 1 1); // Записать некоторые данные 

ЗС'сЛѵ.поРаІа”). гетоѵе0а1:а("х" ); // Удалить некоторые данные 
ѵаг х = $( '#туРіѵ' ). сІа1:а( "х '); // Получить некоторые данные 

Кроме того, библиотека іС^иегу определяет вспомогательные функции, действую¬ 
щие аналогично методам сІаІаО и гетоѵе0а1:а(). Таким образом, связать данные 
с отдельным элементом е можно с помощью метода или функции йаі:а( ): 

$(е). йа1а( ...) // Метод 
$.с1а1:а(е, ...) // Функция 

Механизм хранения данных в библиотеке іС^иегу не использует для этой цели 
свойства самих элементов, но добавляет одно специальное свойство ко всем эле¬ 
ментам, имеющим связанные с ними данные. Некоторые броузеры не позволяют 
добавлять свойства к элементам <арр1е1:>, <оЬ]ес1:> и <етЬес1>, поэтому библиотека 
ІС^иегу просто не дает возможности связать данные с элементами этих типов. 

19.3. Изменение структуры документа 

В разделе 19.2.5 мы познакомились с методами ІтЬп1() и *ех*(), позволяющими из¬ 
менять содержимое элемента. В этом разделе будут рассматриваться методы, по¬ 
зволяющие производить более сложные изменения в документе. В броузере НТМЬ- 
документы представлены в виде дерева узлов, а не в виде линейной последова¬ 
тельности символов, поэтому вставку, удаление и замену фрагмента документа 
выполнить не так просто, как фрагмента строки или массива. В следующих под¬ 
разделах описываются различные методы объекта ]0иегу, предназначенные для 
внесения изменений в документ. 

19.3.1. Вставка и замена элементов 

Начнем с самых основных методов вставки и замены. Все методы, демонстрирую¬ 
щиеся ниже, принимают аргумент, определяющий содержимое, которое должно 
быть вставлено в документ. Это может быть строка с простым текстом или с раз¬ 
меткой НТМЬ, определяющая содержимое, объект ]0иегу, элемент Еіетепі: или 
текстовый узел Мойе. Вставка может быть выполнена внутрь, перед, после или 
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вместо (в зависимости от метода) каждого выбранного элемента. Если в качестве 
вставляемого содержимого используется элемент, уже присутствующий в доку¬ 
менте, он перемещается из текущего местоположения. Если выполняется встав¬ 
ка сразу в несколько мест, элемент будет скопирован необходимое число раз. Все 
эти методы возвращают объект ]0иегу, относительно которого они вызываются. 
Обратите, однако, внимание, что после вызова метода гер1асе1/\Іі1:ІК) элементы, на¬ 
ходящиеся в объекте ]0иегу, исключаются из документа: 


$("#1од" ).аррепсІ(''<Ьг/>”+теззаде); // Добавить содержимое в конец элем. #1од 
$("М").ргерепсК// Добавить символ параграфа в начало каждого элемента <М> 


$(”М”). ЬеГоге("<Ііг/>"); 

$('М"). а^ег("<Ііг/>"); 

$("Пг"). гер1асеІл/і1:ІК "<Ьг/>”); 
$("П2").еасІі(Гііпс1:іоп() { 

ѵаг П2 = $({ПІ5); 


// Вставить линию перед каждым элем. <М> 
// И после 

// Заменить элементы <Пг/> на <Ьг/> 

// Заменить <П2> на <М>, 

// сохранив содержимое 


М2. гер1асе^і1:Г»(’<Гі1>" + М2. М1:т1 () + "</М1 >"); 


}); 

// Методы аП:ег() и ЬеГогеО могут также применяться к текстовым узлам 
// Ниже демонстрируется другой способ добавления символа параграфа во все <М> 
$( 'М").тар(Гцпс1:іоп() { геііцгп {Міз. ГігзШііісі; }).ЬеГоге("§"); 


Каждый из этих пяти методов, изменяющих структуру документа, может также 
принимать функцию, которая должна вызываться для вычисления вставляемого 
значения. Как обычно, в этом случае функция будет вызываться по одному разу 
для каждого выбранного элемента. Ссылка Шз в ней будет указывать на текущий 
элемент, а в первом аргументе ей будет передаваться индекс элемента в объекте 
]0иегу. Методы аррепр(), ргерепсК) и гер1асеѴ\І11:М( ) будут передавать функции во вто¬ 
ром аргументе текущее содержимое элемента в виде строки с разметкой НТМЬ. 
А методы ЬеІ'огеС ) и а^*ег( ) будут вызывать функцию без второго аргумента. 

Все пять методов, представленные выше, применяются к целевым элементам 
и принимают вставляемое содержимое в виде аргумента. Для каждого из этих 
пяти методов имеется парный метод, действующий в обратном порядке: он вызы¬ 
вается относительно содержимого и принимает целевые элементы в виде аргу¬ 
ментов. Пары методов перечислены в следующей таблице: 


Операция 

$(элементы).мегод(содержимое) 

$(содержимое).мегод(элементы) 

вставка содержимого в конец 

целевого элемента 

аррепсК) 

аррепРТоО 

вставка содержимого в начало 

целевого элемента 

ргерепсК) 

ргерепсІТо() 

вставка содержимого после це¬ 
левого элемента 

а?*ег() 

іпзег*А^ег() 

вставка содержимого перед це¬ 
левым элементом 

Ье^огеО 

іпзег*Ве?оге() 

замена целевого элемента со¬ 
держимым 

гер1асе\л!іі:ІК) 

герІасеАПО 


Методы, продемонстрированные в примере выше, перечислены во втором столб¬ 
це. Методы, перечисленные в третьем столбце, будут демонстрироваться ниже. 
Есть несколько важных замечаний, касающихся этих пар методов: 
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• Если любому методу из второго столбца передать строку, он будет интерпрети¬ 
ровать ее как разметку НТМЬ. Если передать строку любому методу из третье¬ 
го столбца, он будет интерпретировать ее как селектор, идентифицирующий 
целевые элементы. (Целевые элементы можно также указывать явно, переда¬ 
вая объект ]0иегу, Еіетепі: или Мойе.) 

• Методы из третьего столбца не принимают функции в аргументах, в отличие 
от методов из второго столбца. 

• Методы из второго столбца возвращают объект ]0иегу, относительно которого 
они вызываются. Элементы в этом объекте ]0иегу могут иметь новое содержи¬ 
мое или новые братские элементы, но сами они не изменяются. Методы из 
третьего столбца вызываются относительно содержимого, которое должно 
быть вставлено, и возвращают новый объект ]0иегу, представляющий новое со¬ 
держимое после вставки. В частности, обратите внимание, что если содержи¬ 
мое вставляется сразу в несколько мест, возвращаемый объект ]0иегу будет 
включать по одному элементу для каждой позиции вставки. 

После перечисления различий реализуем те же операции, что и в примере выше, 
с помощью методов из третьего столбца. Обратите внимание, что во второй строке 
методу $() нельзя передать простой текст (без угловых скобок, которые позволи¬ 
ли бы идентифицировать его как разметку НТМЬ), потому что он будет интерпре¬ 
тироваться как селектор. По этой причине требуется явно создать текстовый 
узел, который должен быть вставлен: 

$('’ < Ьг/>+те88аде').аррепйТо(''#1од"); // Добавить разметку Шт1 в #1од 
$(йоситепі:.сгеа1:еТех1:Мойе(''§")).ргерепйТо( "М”); // Добавить текстовый узел во все <М> 
$( " <Іі г/>"). іпзегііВе^о ге("П1"); // Вставить линию перед каждым <М> 

$("<Ііг/>").іпзег*А^ег("Іі1"); // Вставить линию после каждого <М> 

$("<Ьг/> ").гер1асеА11("Пг"); // Заменить элементы <Пг/> на <Ьг/> 

19.3.2. Копирование элементов 

Как отмечалось выше, при вставке элементов, уже являющихся частью докумен¬ 
та, эти элементы не копируются, а просто перемещаются в новое местоположе¬ 
ние. Если элемент вставляется в несколько мест, библиотека іСіиегу скопирует 
элемент столько раз, сколько потребуется, но копирование не выполняется при 
вставке только в одно местоположение. Если потребуется не переместить, а ско¬ 
пировать элемент, необходимо сначала создать копию с помощью метода с1опе(). 
Метод с1опе() создает и возвращает копии всех выбранных элементов (и всех по¬ 
томков этих элементов). Копии элементов, находящиеся в возвращаемом объекте 
]0иегу, не являются частью документа, но их можно вставить в документ с помо¬ 
щью любого из методов, представленных выше: 

// Добавить новый йіѵ с атрибутом ісІ="1іпк1іві: " в конец документа 
$(йосцтепі:. Ьойу). аррепй("<йіѵ ісІ= * Ііпкіізі: ><П1>Из1: о^ 1_іпк5</М></йіѵ> "); 

// Скопировать все ссылки в документе и вставить их в этот новый йіѵ 
$( "а"). с1опе(). аррепйТо( "«Ііпкіізі:" ); 

// Вставить элементы <Ьг/> после каждой ссылки, чтобы они отображались в отдельных строках 
$("#1іпк1із1: > а ").а^1:ег("<Ьг/> "); 

По умолчанию метод с1опе() не копирует обработчики событий (раздел 19.4) и дру¬ 
гие данные (раздел 19.2.7), связанные с элементами. Если необходимо будет ско¬ 
пировать эти дополнительные данные, передайте методу с1опе() значение Ігие. 
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19.3.3. Обертывание элементов 

Другой способ вставки элементов в НТМЬ-документ связан с обертыванием новым 
элементом (или элементами) одного или более элементов. Объект ]0иегу определя¬ 
ет три метода обертывания. Метод \л/ гар() обертывает каждый выбранный элемент. 
Метод \л/гарІппег() обертывает содержимое каждого выбранного элемента. А метод 
\л/гарА11() обертывает все выбранные элементы как единое целое. По умолчанию 
этим методам передается вновь созданный обертывающий элемент или строка 
с разметкой НТМЬ, которая будет использована для создания обертки. Строка 
с разметкой НТМЬ может включать вложенные элементы, если это необходимо, 
но на самом верхнем уровне она должна содержать единственный элемент. Если 
любому из этих методов передать функцию, она будет вызываться по одному разу 
в контексте каждого элемента (с индексом элемента в виде единственного аргу¬ 
мента) и должна возвращать строку, элемент Еіетепі: или объект ]0иегу. Например: 

// Обернуть каждый элемент <М> элементом <і> 

$( "Іті "). \ѵгар(с!оситеп1: . с геаІіеЕІетепІ; ( "і ")); // Результат: <і><М>. .. </М></і> 

// Обернуть содержимое каждого элемента <М>. Строковый аргумент проще в использовании. 

$("М ").мгарІппег("<і/>"); //Результат: <М><і>... </іх/М> 

// Обернуть первый абзац якорем и элементом сііѵ 

$("ЬосІу>р: Гі гві:").мгар("<а пате=' ІеаР' ><Ріѵ с1а$в=' Гі гзГ ' ></Ріѵ></а>"): 

// Обернуть все остальные абзацы другим элементом Ріѵ 

$( ' ЬоРу>р:по1:(: гві:)").\ѵгарА11 ("<с!іѵ с1азз=' гезі'х/РіѵУ); 

19.3.4. Удаление элементов 

Помимо методов вставки и замены в объекте ]0иегу имеются также методы удале¬ 
ния элементов. Метод етр1:у() удаляет все дочерние элементы (включая текстовые 
узлы) из каждого выбранного элемента без изменения самого элемента. Метод 
гетоѵеО, напротив, удаляет из документа все выбранные элементы (и все их со¬ 
держимое). Обычно метод гетоѵеО вызывается без аргументов и удаляет все эле¬ 
менты, находящиеся в объекте ]0иегу. Однако если передать методу аргумент, 
этот аргумент будет интерпретироваться как селектор, и удалены будут только 
элементы из объекта ]0иегу, соответствующие селектору. (Если необходимо уда¬ 
лить элементы из множества выбранных элементов, не удаляя их из документа, 
используйте метод ГШег(), о котором рассказывается в разделе 19.8.2.) Обратите 
внимание, что не требуется удалять элементы перед повторной их вставкой в до¬ 
кумент: достаточно просто вставить их в новое местоположение, а библиотека ав¬ 
томатически переместит их. 

Метод гетоѵеО удаляет также все обработчики событий (раздел 19.4) и другие 
данные (раздел 19.2.7), которые могли быть связаны с удаляемыми элементами. 
Метод РеІасГіО действует подобно методу гетоѵеО, но не удаляет обработчики со¬ 
бытий и данные. Метод РеГасГіО может оказаться удобнее, когда элементы требу¬ 
ется удалить из документа на время и позднее вставить их обратно. 

Наконец, метод игмгарО выполняет удаление элементов способом, противополож¬ 
ным тому, каким действует метод \л/гар() или \л/гарА11(): он удаляет родительский эле¬ 
мент каждого выбранного элемента, не оказывая влияния на выбранные элементы 
и их братские элементы. То есть для каждого выбранного элемента он замещает ро¬ 
дителя этого элемента его дочерними элементами. В отличие от методов гетоѵеО 
и Ре1:асИ(), метод игмгарО не принимает необязательный аргумент с селектором. 
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19.4. Обработка событий с помощью 
библиотеки ІОиегу 

Как мы узнали в главе 17, одна из сложностей, связанных с обработкой событий, 
состоит в том, что в ІЕ (до версии ІЕ9) реализована модель событий, отличающая¬ 
ся от модели событий в других броузерах. Чтобы решить эту проблему, в библио¬ 
теке іСіиегу определяется собственная унифицированная модель событий, кото¬ 
рая одинаково работает во всех броузерах. В простейших случаях модель з(}иегу 
АРІ оказывается проще в использовании, чем стандартная модель или модель ІЕ. 
В более сложных случаях модель з(}иегу предоставляет более широкие возмож¬ 
ности, чем стандартная модель. Все дополнительные подробности описываются 
в следующих подразделах. 

19.4.1. Простые методы регистрации 
обработчиков событий 

Библиотека з(}иегу определяет простые методы регистрации обработчиков для 
всех наиболее часто используемых событий, поддерживаемых всеми броузерами. 
Например, чтобы зарегистрировать обработчик события «сііск», достаточно про¬ 
сто вызвать метод с1іск( ): 

// Щелчок на любом элементе <р> окрашивает его фон в серый цвет 
$("р").с1іск(?ітс*іоп() { $(Шз).сзз( "Ьаскдгоішсі-соіог ", "дгау"); }); 

Вызов метода объекта зОиегу регистрации обработчика событий зарегистрирует 
указанный обработчик во всех выбранных элементах. Обычно это проще, чем ре¬ 
гистрировать один и тот же обработчик во всех элементах по отдельности с помо¬ 
щью метода асЮЕѵепНізііепегО или а«ас1іЕѵепі:(). 

Библиотека з(}иегу определяет следующие простые методы регистрации обработ¬ 
чиков событий: 


Ы иг() 

^ОСІІЗІП ( ) 

тоцзейомп() 

тоцзеіір() 

сПапде() 

^осіі5оіі1:( ) 

тоіізеепііегС) 

гезі 2 е() 

с1іск( ) 

кеуйомп() 

тоіізеІеаѵеС) 

5СГ0І1( ) 

йЫс1іск( ) 

кеургезз() 

тоіізетоѵе() 

зеіесі: () 

еггог() 

кеуцрО 

тсшзеоіі1:() 

зііЬтіК) 

І'осіізС ) 

1оасІ() 

тоіі5еоѵег() 

іт1оас!() 


Большая часть этих методов регистрации обработчиков наиболее часто используе¬ 
мых типов событий уже знакомы вам по главе 17. Тем не менее необходимо сделать 
несколько замечаний. События «іосиз» и «Ыиг» не всплывают, в отличие от всплы¬ 
вающих событий «іосизіп» и «іосизоиі», и библиотека ІСіиегу гарантирует, что эти 
события будут работать во всех броузерах. События «тоизеоѵег» и «тоизеоиі», на¬ 
оборот, всплывают, и это часто доставляет неудобства, так как сложно определить - 
указатель мыши покинул интересующий нас элемент или событие было доставлено 
от одного из потомков. События «тоизеепіег» и «тоизеіеаѵе» не всплывают, что ре¬ 
шает данную проблему. Эти типы событий впервые появились в ІЕ, но библиотека 
з(}иегу гарантирует, что они корректно будут работать во всех броузерах. 

События «гезіге» и «ипіоасі» возбуждаются только в объекте Міпсісм, поэтому, ес¬ 
ли потребуется зарегистрировать обработчики этих типов событий, методы гезі- 
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іе() и ііпІоасК) следует вызывать относительно $(\л/іпйо\л/). Метод 5сго11() часто вы¬ 
зывается относительно $(\л/іпс1о\л/), но его также можно вызывать относительно лю¬ 
бых элементов, имеющих полосы прокрутки (например, относительно элементов, 
в которых С88-атрибут оѵегГІсм имеет значение «зсгоИ» или «аиіо»). Метод ІоасК) 
может вызываться относительно $(\л/іпсіо\л/), для регистрации обработчика события 
«Іоасі» окна, но обычно проще бывает передать свою функцию инициализации не¬ 
посредственно функции $(), как показано в разделе 19.1.1. При этом метод ІоасК) 
с успехом можно использовать в элементах <іГгате> и <ітд>. Обратите внимание, 
что при вызове метода Іоасі () с различными аргументами он также может исполь¬ 
зоваться для загрузки нового содержимого (по протоколу НТТР) в элемент (раз¬ 
дел 19.6.1). Метод еггог() можно использовать с элементами <ітд> для регистра¬ 
ции обработчиков неудачи загрузки изображения. Он не должен использоваться 
для установки свойства опеггог объекта Міпсісм, описанного в разделе 14.6. 

В дополнение к этим простым методам регистрации обработчиков событий суще¬ 
ствует две специальные формы методов, которые могут иногда пригодиться. Ме¬ 
тод Ьоѵег() регистрирует обработчики событий «тоизеепіег» и «тоизеіеаѵе». Вы¬ 
зов Іюѵег(Г.д) по своему действию аналогичен двум последовательным вызовам 
методов тоизееп1:ег(Г) и тоизеіеаѵе(д). Если методу Ноѵег() передать единственный 
аргумент, он будет использоваться как обработчик обоих событий. 

Другим специальным методом регистрации обработчиков событий является метод 
1одд1е(). Этот метод регистрирует функцию обработчика события «сііск». Вы може¬ 
те указать две или более функции обработчиков, и библиотека іС^иегу будет вызы¬ 
вать их всякий раз, когда будет возникать событие «сііск». Если, например, вызвать 
этот метод как 1:одд1е(Г,д,1п), функция Г() будет вызываться для обработки первого 
события «сііск», д() - второго, Н() - третьего и снова Г() - для обработки четвертого 
события «сііск». Будьте внимательны при использовании метода 1:одд1е(): как будет 
показано в разделе 19.5.1, этот метод может также использоваться для отображе¬ 
ния и скрытия (т. е. для переключения видимости) выбранных элементов. 

В разделе 19.4.4 мы познакомимся с другими, более обобщенными способами ре¬ 
гистрации обработчиков событий и завершим этот раздел описанием еще одного 
простого и удобного способа регистрации обработчиков. 

Напомню, что создавать новые элементы можно с помощью функции $(), переда¬ 
вая ей строку с разметкой НТМЬ и объект (во втором аргументе) с атрибутами, 
которые должны быть установлены во вновь созданном элементе. Второй аргу¬ 
мент может быть любым объектом, который допускается передавать методу 
а*1г(). Но кроме того, если имя какого-либо из свойств совпадает с именем метода 
регистрации обработчиков событий, перечисленных выше, значение этого свой¬ 
ства будет интерпретироваться как функция-обработчик и зарегистрировано как 
обработчик данного типа события. Например: 

$("<ітд/>", { 

зге: ітаде_ііг1, 

аІХ: ітаде_гіезсгірііоп, 

сІазвМате: "Iгапз1исеп*_ітаде", 

сііск: ?ітс!:іоп() { $(1:Пів).свв("орасіііу". '50%'): } 

>): 
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19.4.2. Обработчики событий в библиотеке іОиегу 

Функции обработчиков событий в примерах выше не имеют ни аргументов, ни воз¬ 
вращаемых значений. В целом это нормально для подобных обработчиков собы¬ 
тий, но библиотека зСіиегу передает каждому обработчику событий один или более 
аргументов и анализирует значения, возвращаемые ими. Самое главное, что сле¬ 
дует знать, - каждому обработчику событий библиотека іС^иегу передает в первом 
аргументе объект события. Поля этого объекта содержат дополнительную инфор¬ 
мацию о событии (такую как координаты указателя мыши). Свойства стандартно¬ 
го объекта Еѵеп* были описаны в главе 17. Библиотека зСіиегу имитирует стандарт¬ 
ный объект Еѵепі: даже в броузерах (таких как ІЕ версии 8 и ниже), не поддержи¬ 
вающих его, и объекты событий в библиотеке зСіиегу имеют одинаковые наборы 
полей во всех броузерах. Подробнее об этом рассказывается в разделе 19.4.3. 

Обычно обработчикам событий передается единственный аргумент с объектом 
события. Но если событие генерируется явно с помощью метода *гіддег() (раз¬ 
дел 19.4.6), обработчикам можно передавать массив дополнительных аргумен¬ 
тов. В этом случае дополнительные аргументы передаются обработчикам после 
первого аргумента с объектом события. 

Независимо от способа регистрации значение, возвращаемое функцией обработ¬ 
чика событий, всегда имеет большое значение для библиотеки зСіиегу. Если обра¬ 
ботчик вернет Гаізе, будут отменены и действия, предусмотренные по умолчанию 
для этого типа события, и дальнейшее распространение события. То есть возврат 
значения Гаізе равносилен вызову методов ргеѵепГОеГаиІГО и зГорРгорадаГіопО 
объекта Еѵепі:. Кроме того, когда обработчик события возвращает значение (от¬ 
личное от ипсІе'ГіпесІ), библиотека зСіиегу сохраняет это значение в свойстве гезіііі: 
объекта Еѵепі:, к которому можно обратиться в обработчиках событий, вызывае¬ 
мых вслед за этим обработчиком. 

19.4.3. Объект Еѵепі в библиотеке д'Оиегу 

Библиотека зСіиегу скрывает различия в реализациях броузеров, определяя соб¬ 
ственный объект Еѵепі:. Когда библиотека зСіиегу вызывает обработчик события, 
она всегда передает ему в первом аргументе собственный объект Еѵепі:. Объект 
Еѵепі: в библиотеке зСіиегу основан на положениях стандартов консорциума ^ЗС, 
но в нем также реализованы некоторые особенности, ставшие стандартными де- 
факто. зСіиегу копирует все следующие поля стандартного объекта Еѵепі: во все 
свои объекты Еѵепі: (хотя некоторые из них могут иметь значение ипсІе’ГіпесІ для 
определенных типов событий): 


аІГКеу 

сІігІКеу 

пеѵЛ/аІііе 

зсгеепХ 

аПгСПапде 

сііггепІіТагдеІ: 

оГГзеІіХ 

зсгеепУ 

аигМате 

сіеііаіі 

оГГзеІіУ 

зІііГіКеу 

ЬііЬЫез 

еѵепІіРПазе 

огідіпаІТагдеІ: 

згсЕІетепІ: 

ЬііГііоп 

ГготЕІетепІ: 

радеХ 

{а где* 

сапсеІаЫе 

кеуСоРе 

радеѴ 

ГоЕІетепі: 

сИагСоРе 

ІауегХ 

ргеѵѴаІие 

ѵіем 

с1іепі:Х 

ІауегУ 

геІаГеРМоРе 

мПееЮеИа 

сІіепІУ 

теІіаКеу 

геІаіесІТагдеІ: 

ѵЛіісП 


В дополнение к этим свойствам объект Еѵепі: определяет также следующие методы: 
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ргеѵепЮеГаііІК) із0е^аіі1*Ргеѵеп*есІ() 

8І:орРгорада1:іоп() івРгорадаІііопЗіорресК) 

8ІорІттес1іа1:еРгорада1:іоп() ізІттесІіаТеРгорадаиоп$1:орресІ() 

Большинство из этих свойств и методов было представлено в главе 17 и описыва¬ 
ется в четвертой части книги, в справочной статье Еѵепі:. О некоторых из этих по¬ 
лей, обрабатываемых библиотекой з(}иегу особым образом, чтобы обеспечить им 
одинаковое поведение во всех броузерах, стоит упомянуть отдельно: 

теІіаКеу 

Если стандартный объект события не имеет свойства теІіаКеу, зСіиегу присваи¬ 
вает ему значение свойства сШКеу. Значение свойства теІіаКеу определяется 
в Мас08 клавишей Соттапсі. 

радеХ, радеѴ 

Если стандартный объект события не имеет этих свойств, но имеет свойства, 
определяющие координаты указателя мыши в видимой области в виде свойств 
сІіепІіХ и сІіепІіУ, зСіиегу вычислит координаты указателя мыши относительно 
начала документа и сохранит их в свойствах радеХ и радеУ. 

Ііагдеі:, сиггепІіТагдеі:, геІаііесІТагдеІ: 

Свойство ТагдеТ ссылается на элемент документа, в котором возникло событие. 
Если это свойство в стандартном объекте события ссылается на текстовый узел, 
зСіиегу подставит ссылку на вмещающий объект Еіетепіі. Свойство сиггепІіТагдеі: 
ссылается на элемент, в котором был зарегистрирован текущий обработчик со¬ 
бытия. Значение этого свойства всегда должно совпадать со значением Шз. 

Если значения свойств сиггепТТагдеТ и ТагдеТ не совпадают, следовательно, об¬ 
рабатывается всплывшее событие и может оказаться полезным проверить эле¬ 
мент ТагдеТ с помощью метода із() (раздел 19.1.2): 

іГ ($(еѵеп1і. Ііагдеі:). І5("а")) геіііігп; // Игнорировать события. 

// сгенерированные в ссылках 

Свойство геІаііесІТагдеІ: - ссылка на другой элемент, вовлеченный в события пе¬ 
рехода, такие как «тоизеоѵег» и «тоизеоиі». Например, для событий «тоизе- 
оѵег* свойство геІаііесІТагдеІ: будет ссылаться на элемент, который покинул 
указатель мыши при перемещении на элемент Ііагдеі:. Если стандартный объ¬ 
ект события не имеет свойства геІаііесІТагдеІ:, но имеет свойства ІіоЕІетепІ: и Ггот- 
Еіетепіі, свойство геІаііесІТагдеІ; получает значение одного из этих свойств в за¬ 
висимости от типа события. 

ТітеЗііатр 

Время возникновения события в миллисекундах, возвращаемое методом йаііе. 
деШте(). Библиотека зСіиегу сама устанавливает это свойство, чтобы обойти 
давнишнюю ошибку в Гігеіох. 

\л/І1ІСІ1 

Библиотека зСіиегу нормализует это нестандартное свойство события так, что 
оно определяет кнопку мыши или клавишу на клавиатуре, нажатие которой 
вызвало это событие. Для событий клавиатуры, если стандартный объект со¬ 
бытия не имеет свойства мНісН, но имеет свойство сЬагСосІе или кеуСосіе, в свой¬ 
ство \л/ГіісГ» будет записано значение свойства, которое определено. Для событий 
мыши, если свойство \л/Иісіі отсутствует, но имеется свойство ЬііИоп, в свойство 
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ѵМсЬ будет записано значение, основанное на значении свойства ЬиНоп. О озна¬ 
чает, что никакая кнопка не была нажата. 1 - была нажата левая кнопка, 2 - 
средняя кнопка и 3 - правая кнопка. (Обратите внимание, что в некоторых 
броузерах нажатие правой кнопки мыши не генерирует события.) 

Кроме того, библиотека іСіиегу определяет следующие собственные поля в объек¬ 
те Еѵепі:, которые иногда могут оказаться полезными: 

сіаіа 

Если при регистрации обработчика события были указаны дополнительные 
данные (раздел 19.4.4), обработчик сможет получить к ним доступ с помощью 
этого поля. 

ЬапЫег 

Ссылка на текущую функцию обработчика события. 

гееиіі: 

Возвращаемое значение предыдущего обработчика этого события. Обработчи¬ 
ки, не возвращающие ничего, не учитываются. 

огідіпаІЕѵепі: 

Ссылка на стандартный объект Еѵепі:, созданный броузером. 

19.4.4. Дополнительные способы регистрации 
обработчиков событий 

Мы уже знаем, что в библиотеке з(}иегу имеется множество простых методов ре¬ 
гистрации обработчиков событий. Внутри каждого из них вызывает один и тот 
же, более сложный метод ЬіпсІО, который связывает обработчик с указанным ти¬ 
пом события во всех элементах в объекте ]0иегу. Прямое использование метода 
ЫпсІ() позволяет использовать дополнительные возможности механизма регист¬ 
рации, недоступные в простых методах. 1 

В простейшем случае методу ЬіпсІО передаются строка с типом события в первом 
аргументе и функция обработчика события во втором. Простые методы регистра¬ 
ции обработчиков событий используют именно эту форму вызова метода ЬіпсІО. 
Вызов $('р').с1іск(0» например, эквивалентен вызову: 

$( ’р’). Ыпй( ’сііск' . О; 

Метод ЬіпЬ() может также вызываться с тремя аргументами. В этой форме вызова 
тип события передается в первом аргументе, а функция обработчика - в третьем. 
Во втором аргументе можно передать любое значение, и библиотека іСіиегу будет 
присваивать это значение свойству сіаіа объекта Еѵепі: перед вызовом обработчи¬ 
ка. Иногда это может пригодиться для передачи обработчику дополнительных 
данных без использования замыкания. 


1 В библиотеке і(}иегу термин «связывание» используется для обозначения регистрации 
обработчиков событий. Стандарт ЕСМАЗсгірі 5 и многие фреймворки на языке ^ѵа- 
8сгірі определяют в объектах функций метод ЫпЬ() (раздел 8.7.4) и используют этот 
термин для обозначения связи функций с объектами, относительно которых они вы¬ 
зываются. Версия метода Рііпсіііоп.ЫпсК) в библиотеке і(}иегу является вспомогатель¬ 
ной функцией с именем іОііегу. ргоху( ), которая описывается в разделе 19.7. 
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Кроме того, метод Ыпс!() обладает еще одной дополнительной особенностью. Если 
в первом аргументе передать список типов событий, разделенных пробелами, то 
функция обработчика будет зарегистрирована для всех указанных типов собы¬ 
тий. Вызов {(’а'Э.Ьоѵег^) (раздел 19.4.1), например, эквивалентен вызову: 

$( а'). ЬіпсК'тоіізеепііег тоіізеіеаѵе' , Г); 

Еще одной важной особенностью метода ЫпЬ() является возможность указать 
при регистрации пространство (или пространства) имен для обработчиков собы¬ 
тий. Это дает возможность определить группу обработчиков событий, что может 
пригодиться, когда позднее потребуется переключать или удалять обработчики 
из определенного пространства имен. Поддержка пространств имен для обработ¬ 
чиков особенно удобна для тех, кто пишет библиотеки или модули, использую¬ 
щие библиотеку зСіиегу. Пространства имен событий подобны селекторам С55- 
классов. Чтобы связать обработчик события с определенным пространством имен, 
добавьте точку и имя пространства имен после типа события: 

// Связать Г, как обработчик события тоьзеоѵег в пространстве имен "туМосГ 
// ко всем элементам <а> 

$( а'). Ыпб( тоизеоѵег. туМосГ , Г); 

Имеется даже возможность связать обработчик с несколькими пространствами 
имен, например: 

// Связать Г, как обработчик события тоіізеоііі: в пространствах имен "туМосГ и "уоіігМосГ 
$( 'а' ).ЫпР( 'тоіізесші:.туМосІ. уоіігМоб' , Г); 

Последней особенностью метода ЫпЬ() является возможность передать ему в пер¬ 
вом аргументе объект, отображающий имена событий в функции обработчиков. 
Возьмем еще раз в качестве примера метод Ьоѵег(). Вызов $( , а’).І’юѵег(^ 1 д) эквива¬ 
лентен вызову: 

$( 'а'). ЬіпЬ({тоіізееп1:ег:Г, тоіізеіеаѵе :д}); 

При использовании этой формы метода Ыпсі() именами свойств передаваемого 
ему объекта могут быть строки со списками типов событий, разделенных запяты¬ 
ми, включающими пространства имен. Если в этом случае передать второй аргу¬ 
мент, его значение будет использоваться как дополнительные данные для всех 
связанных обработчиков. 

Библиотека з(}иегу имеет еще один метод регистрации обработчиков. Метод опе() 
вызывается и действует подобно методу ЬіпсІО, за исключением того, что зареги¬ 
стрированный с его помощью обработчик события автоматически удаляется по¬ 
сле первого вызова. То есть, как следует из имени метода, обработчики событий, 
зарегистрированные с помощью опе(), никогда не вызываются более одного раза. 

Единственное, чем не обладают методы ЬіпсІО и опе(), - это возможность регист¬ 
рации перехватывающих обработчиков событий, которая поддерживается мето¬ 
дом аЬЬЕѵепі:1_із1:епег( ) (раздел 17.2.3). ІЕ (до версии ІЕ9) не поддерживает перехва¬ 
тывающие обработчики, и библиотека з(}иегу не пытается имитировать эту осо¬ 
бенность. 

19.4.5. Удаление обработчиков событий 

После регистрации обработчика событий с помощью метода ЬіпсІО (или с помо¬ 
щью простых методов регистрации обработчиков) его можно удалить с помощью 
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метода ипЬіпсК), чтобы предотвратить его вызов при появлении событий в буду¬ 
щем. (Обратите внимание, что метод ипЬіпсК) удаляет только обработчики, заре¬ 
гистрированные методом ЬіпсК ) и родственными ему методами объекта ]0иегу. Он 
не удаляет обработчики, зарегистрированные с помощью метода аЬсіЕѵеп1:І_із1:епег( ) 
или аНасЬЕѵепіК ), а также не удаляет обработчики, объявленные в атрибутах эле¬ 
ментов, таких как опсііск и оптоизеоѵег.) При вызове без аргументов метод ііпЬіпсК ) 
удалит все обработчики событий (для всех типов событий) из всех выбранных 
элементов в объекте ]0иегу: 

$('*'). іліЫпсК ); // Удалит все обработчики событий из всех элементов! 

При вызове с единственным строковым аргументом он удалит все обработчики 
указанного типа события (или типов, если строка содержит несколько имен) из 
всех выбранных элементов в объекте ]0иегу: 

// Удалить все обработчики событий тоіізеоѵег и тоіізеоііі: во всех элементах <а> 

$( 'а'). ипЬіпЬС'тоизеоѵег тоіізеоиі:" ); 

Это не самый лучший подход, и его не следует использовать при разработке моду¬ 
лей, потому что пользователь модуля может использовать другие модули, регист¬ 
рирующие свои собственные обработчики этих же типов событий в тех же эле¬ 
ментах. Однако если модуль будет регистрировать обработчики событий с ис¬ 
пользованием пространств имен, можно будет использовать эту версию вызова 
метода ітЬіпсі() с одним аргументом для удаления только обработчиков события 
из вашего пространства или пространств имен: 

// Удалить все обработчики событий тоіівеоѵег и тоіізеоііі: в пространстве имен "туМосГ 
$( 'а'). ііпЬіпсК "тоіізеоѵег. туМоб тоьзеоиі:. туМосГ); 

// Удалить только обработчики событий из пространства имен туМос! 

$( а' ). ипЬіпсК”. туМосГ); 

// Удалить обработчик события сііск из пространств имен "пзі" и "пз2" 

$( 'а'). ііпЬіпсК"сііск. пбі . пз2"); 

Если потребуется удалить только те обработчики событий, которые были зареги¬ 
стрированы вами, и вы не использовали пространства имен, вы должны полу¬ 
чить ссылки на функции обработчиков событий и использовать версию вызова 
метода ііпЬіпсК ) с двумя аргументами. В этом случае в первом аргументе передает¬ 
ся строка с типом события (без указания пространств имен), а во втором - функ¬ 
ция-обработчик: 

$(' йтуЬііиоп ' ).ьпЫпР( сііск' , туСІіскНапЫег); 

При вызове метода ипЬіпсК ) таким способом он удалит указанный обработчик ука¬ 
занного типа (или типов) события из всех выбранных элементов в объекте ]0иегу. 
Обратите внимание, что обработчики событий могут удаляться версией метода 
ііпЬіпсК ) с двумя аргументами, даже когда они были зарегистрированы с дополни¬ 
тельными данными, с помощью версии метода ЫпсІ(), принимающей три аргу¬ 
мента. 

Методу ііпЬіпсК ) можно также передавать объект в единственном аргументе. В этом 
случае метод ііпЬіпсК) будет вызываться рекурсивно для каждого свойства объек¬ 
та. Имена свойств этого объекта должны определять типы событий, а значения - 
функции обработчиков: 

$( 'а'). ііпЬіпсК { // Удалить конкретные обработчики событий тоіівеоѵег и тоіізеоііі: 
тоіівеоѵег: пкшзеоѵегНапЫег. 




582 


Глава 19. Библиотека іОиегу 


тоіізеоііі:: тоіізеоііІНапсЯег 

}); 

Наконец, существует еще один способ вызова метода ыпЫпсК). Если передать ему 
объект Еѵепі:, созданный библиотекой і(}иегу, он удалит обработчики событий, ко¬ 
торым будет передано это событие. Вызов ыпЫпсКеѵ) эквивалентен вызову ыпЫпсКеѵ. 
Ііуре, еѵ.РапРІег). 

19.4.6. Возбуждение событий 

Зарегистрированные обработчики событий будут вызываться автоматически, ко¬ 
гда пользователь начнет использовать мышь или клавиатуру или когда будут 
возникать события других типов. Однако иногда бывает полезно генерировать со¬ 
бытия вручную. Проще всего сделать это, вызвав один из простых методов реги¬ 
страции обработчиков (такой как с1іск( ) или тоизеоѵег( )) без аргументов. Подобно 
многим методам объекта ]0ыегу, которые могут играть роль методов чтения и за¬ 
писи, эти методы регистрируют обработчики событий, когда вызываются с аргу¬ 
ментами, и запускают их, когда вызываются без аргументов. Например: 

$( ”Лту_І : о гт"). зиЬтіі: (); // Будет действовать, как если бы пользователь щелкнул 

// на кнопке отправки формы 

Метод зыЬтііО в инструкции выше синтезирует объект Еѵепі: и запустит все обра¬ 
ботчики событий, которые были зарегистрированы для события «зиЪтіІ». Если ни 
один из этих обработчиков не вернет Гаізе или не вызовет метод ргеѵепі:0еГаіі11:() 
объекта Еѵепі:, форма действительно будет отправлена. Обратите внимание, что со¬ 
бытия будут всплывать, даже если сгенерировать их вручную, как в данном при¬ 
мере. Это означает, что возбуждение события в множестве выбранных элементов 
может также привести к вызову обработчиков событий в предках этих элементов. 

Важно отметить, что методы объекта ]0ыегу, генерирующие события, будут запус¬ 
кать любые обработчики событий, зарегистрированные методами объекта ]0ііегу, 
а также обработчики, объявленные в НТМЬ-атрибутах или свойствах объектов 
Еіетепі:, таких как опзііЬтіІ:. Но с их помощью невозможно вручную запустить об¬ 
работчики событий, зарегистрированные методом асМЕѵепНізІепегО или аНасІѵ 
Еѵеп1:( ) (однако эти обработчики по-прежнему будут вызываться при возникнове¬ 
нии настоящих событий). 

Отметьте также, что механизм возбуждения событий в библиотеке і(}иегу явля¬ 
ется синхронным - в нем не используется очередь событий. Когда событие гене¬ 
рируется вручную, обработчики событий будут вызваны немедленно, до того как 
метод, возбудивший событие, вернет управление. Если вы генерируете событие 
♦сііск» и один из запущенных обработчиков сгенерирует событие «зиЪтіи, все 
обработчики события «зиЬтіі» будут вызваны до того, как будет вызван следую¬ 
щий обработчик события «сііск». 

Методы, такие как зиЬті1:(), удобно использовать для связывания и возбуждения 
событий; но как библиотека і(}иегу определяет более обобщенный метод Ыпсі( ), так 
же она определяет и более обобщенный метод 1:гіддег(). Обычно при вызове в пер¬ 
вом аргументе методу 1гіддег( ) передается строка с типом события, и он запускает 
обработчики, зарегистрированные для этого типа во всех выбранных элементах 
в объекте ]0ыегу. То есть вызов зиЬтгС() в примере выше эквивалентен вызову: 

$( "йту^огт"). 1: гідде г( "зиЬтіі:" ); 
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В отличие от методов Ыпй() и ыпЬіпсК), в вызове метода *гіддег() нельзя указать 
более одного типа события в первом аргументе. Однако, подобно методам Ыпй() 
и ыпЬіпсК), он позволяет указывать пространства имен возбуждаемых событий» 
чтобы запустить только обработчики, зарегистрированные для этого пространст¬ 
ва имен. Если потребуется запустить только обработчики событий, не привязан¬ 
ные ни к какому пространству имен, следует добавить в строку с типом события 
восклицательный знак. Обработчики, зарегистрированные посредством свойств, 
таких как опсііск, считаются обработчиками, не привязанными к какому-либо 
пространству имен: 

$("ЬиІІоп").Ігіддег("с1іск.пзѴ); // Запустит обработчики в пространстве имен 
$(" Ьиііііоп" ). 1: гіддег('сііск! "); // Запустит обработчики, не привязанные 

// к какому-либо пространству имен 

Вместо строки с типом события в первом аргументе методу 1:гіддег() можно пере¬ 
дать объект Еѵепі: (или любой другой объект, имеющий свойство Ііуре). Свойство 
Ііуре будет определять, какие обработчики должны запускаться. Если передать 
объект Еѵепі: библиотеки і(}иегу, этот объект будет передан обработчикам. Если 
передать простой объект, автоматически будет создан новый объект Еѵепі: библио¬ 
теки ](}иегу и в него будут добавлены свойства объекта, переданного методу. Это 
самый простой способ передать обработчикам событий дополнительные данные: 

// Обработчик опсііск элемента Ьііііопі генерирует то же событие для Ьи1:1:оп2 
$( 'йЬіііііопі ' ).с1іск(Гііпс1:іоп(е) { $( '#Ьіі*1оп2').*гіддег(е); }): 

// Добавит дополнительные свойства в объект события при возбуждении события 
$( ’ЯЬііПопІ '). і:гіддег({Ііуре: сііск', зупіНеіісіігие}); 

// Этот обработчик проверяет дополнительные свойства, чтобы отличить 
// настоящее событие от искусственного 

$(' ЛЬиІіІіопІ'). с1іск( І'ипсіііоп (е) { іГ (е.зупіііеііс) {...}; }): 

Передать дополнительные данные обработчикам при возбуждении событий вруч¬ 
ную можно также с помощью второго аргумента метода 1:гіддег(). Значение, пере¬ 
данное методу 1:гіддег() во втором аргументе, будет передаваться во втором аргу¬ 
менте всем запущенным обработчикам событий. Если во втором аргументе пере¬ 
дать массив, каждый его элемент будет передан обработчикам в виде отдельного 
аргумента: 

$( 'йЬііиопІ ' ).і:гіддег("сііск ", ігііе); // Передать единственный дополнительный аргумент 
$( йЬііПопі '). 1:гіддег("сііск", [х,у, г]); // Передать три дополнительных аргумента 

Иногда может потребоваться запустить все обработчики события данного типа, 
независимо от того, к какому элементу документа они привязаны. Для этого мож¬ 
но выбрать все элементы вызовом $('*') и вызвать метод 1:гіддег() относительно 
результата, но это решение весьма неэффективно. Вместо того чтобы возбуждать 
событие в глобальном масштабе, можно вызвать вспомогательную функцию ]0ііе- 
гу. еѵепі:.і:гіддег(). Эта функция принимает те же аргументы, что и метод 1:гіддег(), 
и эффективно запускает обработчики событий указанного типа, имеющиеся во 
всем документе. Обратите внимание, что «глобальные события», возбуждаемые 
таким способом, не всплывают, и при этом запускаются только обработчики со¬ 
бытий, зарегистрированные с использованием методов объекта ]0ыегу (обработчи¬ 
ки, зарегистрированные с помощью свойств модели БОМ, не запускаются). 
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После вызова обработчиков событий метод 1:гіддег() (и вспомогательные методы, 
вызывающие его) выполняет действия, предусмотренные по умолчанию для сге¬ 
нерированного типа события (предполагается, что ни один обработчик не вернул 
значение Га1$е или не вызвал метод ргеѵеп1:0еГаи11:() объекта события). Например, 
если возбудить событие «виЪтіІ» в элементе <Гоггл>, метод 1:гіддег() вызовет метод 
зиЬті1:( ) этой формы, а если возбудить в элементе событие «Іосію», метод 1гіддег( ) 
вызовет метод ГосизО этого элемента. 

Если необходимо вызвать обработчики событий без выполнения действий по 
умолчанию, вместо метода ІгіддегО следует использовать метод ІгіддегНапР1ег(). 
Этот метод действует точно так же, как и метод 1гіддег(), за исключением того, 
что он сначала вызывает методы ргеѵеп1:0еГаи11:() и сапсе1ВиЬЫе() объекта Еѵепі:. 
Это означает, что искусственное событие не будет всплывать, и для него не будут 
выполняться действия, предусмотренные по умолчанию. 

19.4.7. Реализация собственных событий 

Система управления событиями в библиотеке і(}иегу создана на основе стандарт¬ 
ных событий, таких как щелчки мышью или нажатия клавиш, генерируемых 
веб-броузерами. Но она не ограничивается только этими событиями и позволяет 
использовать любую строку в качестве имени типа события. Метод ЫпР() позво¬ 
ляет регистрировать обработчики таких «нестандартных событий», а метод Хгід- 
дег() - вызывать эти обработчики. 

Такая разновидность косвенного вызова обработчиков нестандартных событий 
может оказаться весьма полезной при разработке модулей и реализации модели 
издатель/подписчик или шаблона ОЬзегѵег (наблюдатель). Зачастую при исполь¬ 
зовании собственных событий может оказаться полезной возможность возбуждать 
их глобально, с помощью функции ]0ыегу.еѵепі:.1:гіддег() вместо метода 1:гіддег(): 

// Когда пользователь щелкнет на кнопке "ІодоІТ', отправить собственное событие 
// всем подписанным на него наблюдателям, которые должны сохранить информацию 
// о своем состоянии, и затем перейти на страницу выхода. 

$("#1одоГГ'). сНскС^цпсИопС) { 

$. еѵепі:.і:гіддег("1одо1Т'); // Отправить широковещательное событие 
\ѵіпс!о\ѵ. Іосаііоп = " Іодо'ГІ 1 . рПр”; // Перейти на другую страницу 

}): 

В разделе 19.6.4 вы узнаете, что методы поддержки архитектуры А^ах в библиоте¬ 
ке іС^иегу аналогичным образом рассылают широковещательные события заин¬ 
тересованным приемникам. 

19.4.8. Динамические события 

Метод ЬіпР() связывает обработчики событий с конкретными элементами доку¬ 
мента, подобно методам асМЕѵепі:І_і$і:епег( ) и а1:1:асМЕѵеп1:( ) (глава 17). Но веб-прило- 
жения, использующие библиотеку і(}иегу, часто создают новые элементы дина¬ 
мически. Если мы воспользуемся методом ЬіпсК ) для привязки обработчика собы¬ 
тий ко всем элементам <а>, имеющимся в документе, и затем создадим новые эле¬ 
менты <а>, эти новые элементы не будут иметь обработчиков событий, которые 
были в старых элементах, и будут вести себя иначе. 
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В библиотеке і(}иегу эта проблема решается с помощью «динамических собы¬ 
тий». Чтобы задействовать динамические события, вместо методов Ьіпсі( ) и ыпЬіпсІ () 
следует использовать методы йе1еда1:е() и ипде1едаі:е( ). 

Обычно метод йеІедаІеО вызывается относительно $(доситеп1:), и ему передаются 
строка селектора, строка с типом события и функция обработчика, а он регистри¬ 
рует внутренний обработчик в объекте документа или окна (или в любом другом 
элементе, находящемся в объекте ]0иегу). Когда событие указанного типа всплы¬ 
вет до этого внутреннего обработчика, он выяснит, соответствует ли целевой эле¬ 
мент события (элемент, в котором оно возникло) строке селектора, и вызовет ука¬ 
занную функцию обработчика. То есть, чтобы обеспечить обработку события 
«тоизеоѵег» и в старых, и во вновь созданных элементах <а>, можно зарегистри¬ 
ровать обработчик, как показано ниже: 

$(с!оситеп1:).йе1еда1:е("а", "тоизеоѵег", ІіпкНапсІІег); 

Или сначала применить метод Ыпс1() к статической части документа, а затем с по¬ 
мощью метода с)е1еда1;е() обработать динамически изменяемую часть: 

// Статические обработчики событий для статических ссылок 
$("а"). ЬіпсІ("тоизеоѵег''. ІіпкНапсІІег); 

// Динамические обработчики событий для фрагментов документа, 

// которые изменяются динамически 
$С'.сІупатіс").сІе1еда1:е("а", "тоизеоѵег", ІіпкНапсІІег); 

Подобно тому, как метод Ьіпсі( ) имеет версию с тремя аргументами, позволяющую 
указать значение свойства сіаіа объекта события, метод сіеІедаІіеО имеет версию 
с четырьмя аргументами, позволяющую то же самое. При использовании этой 
версии дополнительные данные следует передавать в третьем аргументе, а функ¬ 
цию обработчика - в четвертом. 

Важно понимать, что динамические события основаны на механизме всплытия. 
К тому моменту, когда оно всплывет до объекта документа, оно может пройти че¬ 
рез множество статических обработчиков. А если какой-либо из этих обработчи¬ 
ков вызовет метод сапсе1ВиЬЫе() объекта Еѵепі:, динамический обработчик так 
и не будет вызван. 

Объект ]0иегу имеет метод 1іѵе( ), который также можно использовать для регист¬ 
рации динамических обработчиков событий. Метод 1іѵе( ) устроен немного слож¬ 
нее, чем метод сіе1едаі:е( ), но он, как и метод Ьіпсі( ), имеет версии с двумя и тремя 
аргументами, которые чаще всего используются на практике. Два вызова метода 
гіеІедаІеО, показанные выше, можно было бы заменить следующими вызовами 
метода 1іѵе(): 

$("а”). 1іѵе("тоизеоѵег", ІіпкНапсІІег); 

$("а", $(".с!упатіс")). 1іѵе("тоизеоѵег”, ІіпкНапсІІег); 

Когда вызывается метод 1іѵе(), элементы, находящиеся в объекте ]0иегу, в дейст¬ 
вительности никак не используются. Что имеет значение, так это строка селекто¬ 
ра и объект контекста (первый и второй аргументы функции $()), использовав¬ 
шиеся при создании объекта ]0ііегу. Эти значения доступны в виде свойств зеіесііог 
и сопіехі: объектов ]0ііегу (раздел 19.1.2). Обычно функция $() вызывается с един¬ 
ственным аргументом, а роль контекста в этом случае играет текущий документ. 
То есть при использовании объекта х типа ^Оііегу следующие две строки можно 
считать эквивалентными: 
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х. 1іѵе(1:уре. ИапсІІег); 

$(х.соп1;ехі:).сІе1едаі:е(х.зе1ес1:ог, {уре, ИапсІІег); 

Для удаления динамических обработчиков событий используются методы (5іе( У 
и ыпРеІедаІіеО. Метод Ріе() может вызываться с одним или с двумя аргументами. 
Если методу передать единственный аргумент, определяющий тип события, он 
удалит все динамические обработчики событий, соответствующие селектору и ти¬ 
пу событий. А если передать тип события и функцию обработчика, он удалит 
только указанный обработчик. Например: 

$( 'а').с!іе('тоизеоѵег' ); // Удалит все динамические обработчики 

// события тоіізеоѵег из элементов <а> 

$( ’а').с!іе( тоіізеоѵег' , ІіпкНапсІІег ) ; // Удалит только указанный динамический обработчик 

Метод ипРе1еда1:е() действует аналогично методу Ріе(), но более явно отделяет кон¬ 
текст (элементы, в которых был зарегистрирован внутренний обработчик) и стро¬ 
ку селектора. Вызовы метода Ріе() выше можно было заменить вызовами метода 
ыпсіе1еда1:е( ), как показано ниже: 

$(с!осіітепі:) . ітс!е1едаі:е( 'а'); // Удалит все динамические обработчики из элементов <а> 

$(с!осіітеп1:) . ьпсІеІеда'ІіеС а', 'тоизеоѵег'); // Удалит динамические обработчики 

// события тоизеоѵег 

$( сіоситепі: ). ипс!е1еда1:е( а'. 'тоизеоѵег', ІіпкНапсІІег); // Указанный обработчик 

Наконец, метод ііпсіе1еда1:е() может также вызываться вообще без аргументов. 
В этом случае он удаляет все динамические обработчики, привязанные к выбран¬ 
ным элементам. 

19.5. Анимационные эффекты 

В главе 16 демонстрировалось, как можно управлять стилями С88 в элементах 
документа. Например, устанавливая С88-свойство ѵізіЫШу, можно заставлять 
элементы появляться и скрываться. В разделе 16.3.1 было показано, как, управ¬ 
ляя стилями С88, можно воспроизводить анимационные эффекты. Например, 
вместо того, чтобы просто сделать элемент невидимым, можно постепенно умень¬ 
шать значение его свойства орасіііу в течение половины секунды и заставить его 
исчезать плавно. Подобные визуальные эффекты оставляют у пользователей бо¬ 
лее приятные впечатления, и библиотека і(}иегу упрощает их реализацию. 

Объект ]0иегу определяет методы воспроизведения основных визуальных эффек¬ 
тов, такие как ГасІеІп( ) и ГаРеОиі:( ). Кроме них он определяет также метод апіта1:е( ), 
позволяющий воспроизводить более сложные эффекты. В следующих подразде¬ 
лах описываются и методы воспроизведения простых эффектов, и более сложный 
универсальный метод апіта1:е(). Однако для начала познакомимся с некоторыми 
общими особенностями механизма анимационных эффектов в библиотеке і(}иегу. 

Каждый анимационный эффект имеет продолжительность, которая определяет, 
как долго должен продолжаться эффект. Продолжительность можно указать 
в виде числа миллисекунд или в виде строки. Строка ♦і’азі» означает 200 милли¬ 
секунд. Строка «8Іо\ѵ» означает 600 миллисекунд. Если указать строку, которая 
не будет распознана библиотекой і(}иегу, по умолчанию будет использована про¬ 
должительность 400 миллисекунд. Имеется возможность определять новые на¬ 
звания, обозначающие продолжительность, добавляя новые отображения строк 
в числа в объект ]Оііегу.Гх.зреедз: 
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^Оиегу. Тх. зреес!з[ "тесІіит-Тазі: " ] = 300; 

]0цегу. Рх. зреейз[ "тесІіііт-зІоѵГ ] = 500; 

Методы воспроизведения эффектов объекта ]0ііегу обычно принимают продолжй- 
тельность в первом необязательном аргументе. Если опустить этот аргумент, по 
умолчанию продолжительность будет составлять 400 миллисекунд. Однако не¬ 
которые методы, не получив аргумент с продолжительностью, выполняют опера¬ 
цию немедленно, без анимационного эффекта: 

$("#теззаде"). Тас1еІп( ); // Эффект проявления будет длиться 400 мсек 

$( "Дтеззаде"). І'асІеОиІіС ” І'азі; ”); // Эффект растворения будет длиться 200 мсек 

Эффекты в библиотеке іС^иегу воспроизводятся асинхронно. Когда производится 
вызов метода анимационного эффекта, такого как ^ас!еІп( ), он сразу же возвраща¬ 
ет управление, а воспроизведение эффекта выполняется «в фоновом режиме». По¬ 
скольку методы анимационных эффектов возвращают управление до того, как 
эффект завертится, многие из них принимают во втором аргументе (также не¬ 
обязательном) функцию, которая будет вызвана по окончании воспроизведения 
эффекта. Этой функции не передается никаких аргументов, но ссылка Шз в ней 
будет указывать на элемент документа, к которому применялся эффект. Функ¬ 
ция будет вызвана по одному разу для каждого выбранного элемента: 

// Быстро проявить элемент, а когда он станет видимым, вывести в нем текст. 

$("#теззаде"). *ГасІеІп( " 'Газі: ", РііпсІіопО { $(ІНіз). ІехРС Привет, Мир! "); }); 

Передача функции обратного вызова методу воспроизведения эффекта позволяет 
выполнять действия по его окончании. Однако в этом нет необходимости, когда 
требуется просто последовательно воспроизвести несколько эффектов. По умолча¬ 
нию библиотека і(}иег у ставит анимационные эффекты в очередь (в разделе 19.5.2.2 
демонстрируется, как изменить это поведение по умолчанию). Если вызвать метод 
анимационного эффекта относительно элемента, для которого уже воспроизво¬ 
дится анимационный эффект, воспроизведение нового эффекта не начнется не¬ 
медленно, а будет отложено до окончания воспроизведения текущего эффекта. На¬ 
пример, можно заставить элемент «моргать», пока он не проявится окончательно: 

$("#Ь1іпкег"). РасІеІп(ІОО). І'асІеОиІ: (100). 1"асІеІп( 100). І'асІеОиІ:(100). РасІеІпО; 

Методы анимационных эффектов объекта ]0ііегу принимают необязательные ар¬ 
гументы, определяющие продолжительность и функцию обратного вызова. Од¬ 
нако этим методам можно также передавать объект, свойства которого определя¬ 
ют параметры эффектов: 

// Передать продолжительность и функцию не в отдельных аргументах, а в свойствах объекта 

$( "йтеззаде"). ^асІеІпС { 
сіцгаіііоп : "•Разѣ", 

сотріере: Рцпс*іоп() { $(Шз). РехК"Привет, Мир!"); } 

}); 

Этот прием с передачей объекта обычно применяется при использовании универ¬ 
сального метода апіта1:е( ), но он также может применяться и при работе с метода¬ 
ми простых анимационных эффектов. Использование объекта позволяет также 
определять и другие, расширенные параметры, такие как параметры управле¬ 
ния очередью и переходами эффектов. Доступные параметры будут описаны 
в разделе 19.5.2.2. 
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Отключение анимационных эффектов 

Анимационные эффекты стали нормой на многих веб-сайтах, но они нра¬ 
вятся не всем пользователям: некоторые считают их раздражающими, 
а кто-то даже может испытывать неприятные ощущения. Пользователи 
с ограниченными возможностями могут обнаружить, что анимационные 
эффекты затрудняют использование вспомогательных технологий, таких 
как программы чтения с экрана, а владельцы устаревших компьютеров бу¬ 
дут ощущать нехватку вычислительных мощностей. В качестве жеста ува¬ 
жения к своим пользователям вы должны стараться использовать более 
простые анимационные эффекты и в небольшом количестве, а также пре¬ 
доставлять возможность полностью отключать их. Библиотека і(}иегу дает 
простую возможность отключить сразу все эффекты: достаточно просто ус¬ 
тановить свойство зОиегу.-Рх. сРІ 1 в значение Ігие. В результате продолжи¬ 
тельность всех эффектов будет установлена равной 0 миллисекунд, что за¬ 
ставит их выполняться мгновенно, без анимации. 

Чтобы дать пользователям возможность отключать анимационные эффек¬ 
ты, можно включить в сценарий следующий фрагмент: 

$('\5І:ортоѵіпд'').с1іск(1 : ііпс1:іоп() { ^Оііегу. ^х.оН = {те; }); 

Затем веб-дизайнер должен включить в страницу элемент с классом «зіор- 
ШОѴІП&», щелчок на котором будет отключать воспроизведение анимаци¬ 
онных эффектов. 


19.5.1. Простые эффекты 

Библиотека іС^иегу реализует девять методов простых анимационных эффектов 
скрытия и отображения элементов. Их можно разделить на три группы по типам 
воспроизводимых ими эффектов: 

^аРе1п(), ^агіеОігЮ, ^айеТоО 

Это самые простые эффекты: методы ?асіеІп() и ТадеОиіО просто управляют 
С88-СВОЙСТВОМ орасіііу, чтобы скрыть элемент или сделать его видимым. Оба 
принимают необязательные аргументы, определяющие продолжительность 
и функцию обратного вызова. Метод ^аРеТо() несколько отличается: он прини¬ 
мает аргумент, определяющий конечное значение непрозрачности и плавно 
изменяет текущее значение непрозрачности элемента до указанного. В первом 
обязательном аргументе методу ^ас!еТо() передается продолжительность (или 
объект с параметрами), а во втором обязательном аргументе - конечное значе¬ 
ние непрозрачности. Функция обратного вызова передается в третьем необя¬ 
зательном аргументе. 

зію\л/(), ІіігіеО, *одд1е() 

Метод ^асІеОиіО, описанный выше, делает элемент невидимым, но сохраняет 
занимаемую им область в документе. Метод МісІеО, напротив, удаляет элемент 
из потока документа, как если бы его С88-свойство Різріау было установлено 
в значение попе. При вызове без аргументов методы МісІеО и зію\л/() просто не- 
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медленно скрывают и отображают выбранные элементы. Однако при вызове 
с аргументом, определяющим продолжительность (или объект с параметра¬ 
ми), они воспроизводят анимационный эффект скрытия или появления. Ме; 
тод Міс1е( ) уменьшает ширину и высоту элемента до 0 и одновременно уменьша¬ 
ет до 0 непрозрачность элемента. Метод зіюѵѵ( ) выполняет обратные действия. 

Метод 1:одд1е() изменяет состояние видимости элементов: для скрытых элемен¬ 
тов он вызывает метод зіісмО, а для видимых - метод Міс1е( ). Как и при работе 
с методами зИо\л/() и ІіісіеО, чтобы воспроизвести анимационный эффект, мето¬ 
ду 1одд1е() необходимо передать продолжительность или объект с параметра¬ 
ми. Передача значения Хгие методу *одд1е( ) эквивалентна вызову метода зИо\л/() 
без аргументов, а передача значения І'аізе - вызову метода ІіісіеО без аргу¬ 
ментов. Обратите также внимание, что если передать методу іодд1е( ) одну или 
более функций, он зарегистрирует обработчики событий, как описывалось 
в разделе 19.4.1. 

5Іісіе0о\л/п(), з1ісіеІІр( ), зІісіеТоддІеО 

Метод 5ІіРеІІр( ) скрывает выбранные элементы в объекте ]0ііегу, постепенно 
уменьшая их высоту до 0, и затем устанавливает С88-свойство Різріау в значе¬ 
ние «попе». Метод 5Ііс1е0о\л/п( ) выполняет противоположные действия, чтобы 
сделать скрытый элемент видимым. Метод 5ІіРеТодд1е( ) переключает состоя¬ 
ние видимости элементов, используя методы зІісіеІІрС ) и з1ісіе0о\л/п(). Каждый 
из этих трех методов принимает необязательные аргументы, определяющие 
продолжительность и функцию обратного вызова (или объект с параметрами). 

Следующий пример демонстрирует использование методов из всех трех групп. 
Имейте в виду, что по умолчанию библиотека і(}иегу ставит анимационные эф¬ 
фекты в очередь, что обеспечивает их выполнение по очереди: 

// Растворить все элементы, затем показать их, затем свернуть и развернуть 
$( "ітд" ). ?ас!еОіі{( ). зИо\л/(300). з1іс!еІІр( ). 8ІісІеТодд1е( ); 

Различные расширения библиотеки і(}иегу (раздел 19.9) добавляют в нее допол¬ 
нительные анимационные эффекты. Наиболее полный набор эффектов включает 
библиотека і(}иегу Ш (раздел 19.10). 

19.5.2. Реализация собственных 
анимационных эффектов 

Метод апітаіеО позволяет воспроизводить более сложные анимационные эффек¬ 
ты, чем методы простых эффектов. Первый аргумент метода апітаІеО определяет 
воспроизводимый эффект, а остальные аргументы - параметры этого эффекта. 
Первый аргумент является обязательным: это должен быть объект, свойства ко¬ 
торого задают С88-атрибуты и их конечные значения. Метод апіта1:е( ) плавно из¬ 
меняет С88-свойства всех элементов от текущих их значений до указанного ко¬ 
нечного значения. То есть эффект, воспроизводимый описанным выше методом 
з1іс!еІІр( ), можно, например, реализовать, как показано ниже: 

// Уменьшить высоту всех изображений до О 
$("ітд") . апіта1:е( { ЬеідМ:: 0 }); 

Во втором необязательном аргументе методу апітаІеО можно передать объект 
с параметрами эффекта: 
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// Изменить непрозрачность до 0,25 
// Изменить размер шрифта до 10 пикселов 


$( "#зргіі:е"). апіта1:е( { 
орасііу: .25, 

І'опі-зііе: 10 

}, { 

сіигаіііоп: 500, 
сотріеіе: ?ітс*іоп() { 

ІМІ5.іехіС'До свидания"); 

} 

}): 


// Продолжительность 1/2 секунды 
// Вызвать эту функцию по окончании 
// Изменить текст в элементе. 


Вместо объекта с параметрами во втором аргументе метод апітаІеО позволяет 
также передать три наиболее часто используемых параметра в виде отдельных 
аргументов. Во втором аргументе можно передать продолжительность (в виде 
числа или строки), в третьем аргументе - имя функции, выполняющей переходы 
(подробнее об этой функции рассказывается чуть ниже.) И в четвертом аргумен¬ 
те - функцию обратного вызова. 

В самом общем случае метод апіта1:е( ) принимает два аргумента с объектами. Пер¬ 
вый определяет С88-атрибуты, которые будут изменяться, а второй - параметры 
их изменения. Чтобы полностью понять, как выполняются анимационные эффек¬ 
ты в библиотеке іС^иегу, необходимо поближе познакомиться с обоими объектами. 


19.5.2.1. Объект, определяющий изменяемые атрибуты 

Первым аргументом метода апіта1:е() должен быть объект. Имена свойств этого 
объекта должны совпадать с именами С88-атрибутов, а значения этих свойств 
должны определять конечные значения атрибутов, которые должны быть полу¬ 
чены к окончанию эффекта. Участвовать в анимационном эффекте могут только 
атрибуты с числовыми значениями: невозможно реализовать плавное изменение 
значения цвета, шрифта или свойств-перечислений, таких как Різріау. Если зна¬ 
чением свойства является число, подразумевается, что оно измеряется в пиксе¬ 
лах. Если значение является строкой, в ней можно указать единицы измерения. 
Если единицы измерения отсутствуют, опять же предполагается, что значение 
измеряется в пикселах. Чтобы указать относительные значения, в строковые зна¬ 
чения следует добавить префикс: «+=» - для увеличения и «-=* - для уменьше¬ 
ния значения. Например: 

$("р").апіта1:е({ 

"тагдіп-ІеГі; ‘: "+=.5іп", // Увеличить отступ абзаца 

орасііу: "-=.1" // Уменьшить непрозрачность 

}): 

Обратите внимание на кавычки, окружающие имя свойства «таг&іп-ІеН;» в при¬ 
мере литерала объекта выше. Наличие дефиса в имени этого свойства делает его 
недопустимым идентификатором в языке Лѵабсгірі, поэтому в подобных случа¬ 
ях следует использовать кавычки. Разумеется, библиотека і(}иегу позволяет так¬ 
же использовать альтернативные имена со смешанным регистром символов, та¬ 
кие как тагдіпІ_е^. 

Помимо числовых значений (с необязательными единицами измерения и пре¬ 
фиксами «+=» и «-=») существует еще три значения, которые можно использовать 
в объектах, определяющих изменяемые свойства. Значение «Ысіе» сохранит теку¬ 
щее значение указанного свойства и затем плавно изменит его до 0. Значение 
«зЬо\ѵ» плавно изменит значение С88-свойства до его сохраненного значения. При 
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использовании значения «8Ьо\ѵ» библиотека і(}иегу вызовет метод зИо\л/() по завер¬ 
шении эффекта. Л при использовании значения «ЬМе» она вызовет метод ГіісІе(). 

Можно также использовать значение «Іо&&1е», которое обеспечит увеличение 
(«8Ьо\ѵ») или уменьшение («ЪЫе») значения атрибута в зависимости от его текуще¬ 
го состояния. Например, ниже показано, как можно реализовать эффект «зіісіе- 
Кі&Ьі» сворачивания вправо (подобный эффекту сворачивания вверх, воспроиз¬ 
водимому методом з1ісіеІІр( ), но изменяющий ширину элемента): 

$(" ітд" ). апітаІеС { 
и/ісІІИ: "Ііісіе", 

ЬогсІегІеіЧ: "Иісіе", 

ЬогйегРідИІ:: "Иісіе”, 
расІсІіпдІ.еІЧ: "Иісіе". 
расШпдРідйі:: "Иісіе" 

}); 

Замените значения свойств на «8Ьо\ѵ» или «1о&&1е», чтобы получить эффект раз¬ 
ворачивания по горизонтали, аналогичные тем, что воспроизводятся методами 

зШеОомпО и з1ісіеТодд1е(). 

19.5.2.2. Объект с параметрами анимационного эффекта 

Во втором необязательном аргументе методу апітаІеО может передаваться объ¬ 
ект с параметрами анимационного эффекта. Вы уже знакомы с двумя наиболее 
важными параметрами. Значением свойства сіигаіііоп может быть число, опреде¬ 
ляющее длительность эффекта в миллисекундах, а также строка «Іазі», «зіодѵ» 
или любая другая, объявленная в свойстве зОиегу.'Рх.зреесіз. 

Другим параметром, с которым вы уже встречались, является свойство сотріеііе: 
оно определяет функцию, которая должна быть вызвана по окончании эффекта. 
Похожее свойство зііер определяет функцию, которая должна вызываться для ка¬ 
ждого шага или кадра анимации. Элемент, к которому применяется эффект, пе¬ 
редается этой функции в виде значения ссылки Шз, а текущее значение изменяе¬ 
мого свойства - в первом аргументе. 

Свойство дыеие объекта с параметрами определяет - должен ли данный эффект 
ставиться в очередь. То есть должно ли откладываться воспроизведение данного 
эффекта до окончания всех предыдущих эффектов. По умолчанию все анимаци¬ 
онные эффекты ставятся в очередь. Если свойству дііеие присвоить значение Шзе, 
эффект не будет поставлен в очередь. Воспроизведение таких внеочередных эф¬ 
фектов начинается немедленно. Последующие анимационные эффекты, которые 
ставятся в очередь, не будут ждать завершения внеочередных эффектов. Рассмот¬ 
рим следующий пример: 

$("ітд"). ^ас!еІп(500) 

. апітаі:е( { "\ѵіс!1:И " : ”+=100"}, {диеие: ^аізе, сіигаіііоп: 1000}) 

. ^асІеОиІ: (500); 

Эффекты, запускаемые методами 1"асіеІп() и ^асІеОиіО, будут поставлены в оче¬ 
редь, а эффект, запускаемый вызовом метода апітаіеО (эффект изменения значе¬ 
ния свойства ѵу/ісіііИ на протяжении 1000 миллисекунд) - нет. Изменение ширины 
начнется одновременно с эффектом 1"асіеІп(). Эффект ^айеОыШ начнется сразу по¬ 
сле окончания эффекта ^асіеІп(): он не будет ждать, пока завершится эффект, из¬ 
меняющий ширину элемента. 
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Функции переходов 

В самом простом случае воспроизведение анимационного эффекта заклю¬ 
чается в линейном изменении во времени значения свойства. Например, 
через 100 миллисекунд после начала эффекта, длительность которого со¬ 
ставляет 400 миллисекунд, величина изменения значения свойства соста¬ 
вит 25%. То есть при линейном изменении свойства орасгЕу от 1,0 до 0,0 
(как, например, при использовании метода ^агіеОиШ) в этот момент оно 
должно иметь значение 0,75. Однако, как оказывается, визуальные эффек¬ 
ты дают более глубокие впечатления, если они выполняются нелинейно. 
Поэтому библиотека іСіиегу предусматривает возможность использования 
«функции перехода», которая отображает проценты от общего времени вы¬ 
полнения эффекта в проценты от конечного значения свойства. Библиоте¬ 
ка і()иегу передает функции перехода значение времени в диапазоне от 0 до 
1, а она должна вернуть другое значение в диапазоне от 0 до 1, исходя из 
которого библиотека іСіиегу вычислит значение С88-свойства, опираясь на 
его вычисленное значение. Конечно, в общем случае ожидается, что функ¬ 
ции переходов будут возвращать значение 0, когда им передается значение 
0, и 1, когда им передается значение 1, но между этими двумя значениями 
они могут быть нелинейными, что будет проявляться в ускорении и замед¬ 
лении анимационных эффектов. 

По умолчанию в библиотеке іСіиегу используется синусоидальная функ¬ 
ция перехода: эффект сначала протекает медленно, затем ускоряется, и за¬ 
тем опять замедляется при приближении к конечному значению. Функции 
переходов в библиотеке іСіиегу имеют имена. Функция по умолчанию на¬ 
зывается «влѵіпё», а линейная функция называется «Ііпеаг». Вы можете до¬ 
бавлять свои функции переходов в объект зОыегу.еазіпд: 

ІОиегу. еазіпд["зрііагегоо1:"] = МаІИ.зрг*; 

Библиотека іСіиегу ІЛ и расширение, известное как «іЬе і(}иегу Еазіпд Р1и&- 
іп», определяют весьма исчерпывающий набор дополнительных функций 
переходов. 


Остальные параметры анимационных эффектов имеют отношение к функциям 
переходов. Свойство еазіпд объекта с параметрами определяет имя функции пере¬ 
хода. По умолчанию библиотека іСіиегу использует синусоидальную функцию 
с именем «влѵіпз». Если необходимо, чтобы анимационный эффект воспроизво¬ 
дился линейно, следует использовать параметры, как показано ниже: 

$(" ітд" ). апіта1:е( { ”\ѵісІ1;И" : "+=100”}, { сіига1:іоп: 500, еазіпд: "Ііпеаг"}); 

Напомню, что параметры сіигаіііоп, еазіпд и сотр1е1:е можно также передавать ме¬ 
тоду апіта1:е() в виде отдельных аргументов. То есть предыдущий анимационный 
эффект можно запустить так: 

$(” ітд "). апіта1:е( { " ѵу/ісіііИ" : "+=100"}, 500, "Ііпеаг"); 
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Наконец, механизм воспроизведения анимационных эффектов в библиотеке 
І()иегу позволяет даже указывать для разных С88-свойств разные функции пере¬ 
ходов. Сделать это можно двумя разными способами, как показано в следующем 
примере: 

// Требуется скрыть изображения, подобно методу ИісІе( ). при этом изменение 
// размеров изображения должно протекать линейно, а изменение непрозрачности - 
// с применением функции перехода "зѵѵіпд" по умолчанию 

// Первый способ: 

// Использовать параметр зресіаІЕазіпд, чтобы указать другую функцию перехода 
$(" ітд” ). апіта1:е( { \л/ісІ1:И : "Иісіе". ИеідИТ: "Нісіе", орасііу: "Нісіе" }, 

{ зресіаІЕазіпд: { місИН: "Ііпеаг", НеідНІ: "Ііпеаг" }}); 


// Второй способ: 

// Передать массивы [целевое значение, функция перехода] в объекте, 

// который передается в первом аргументе. 

$(" ітд" ). апітаТе( { 

ѵѵісііП: ["Нісіе", "Ііпеаг"], НеідНІ: ["Иісіе", "Ііпеаг"], орасііу:"Нісіе" 

}); 


19.5.3. Отмена, задержка и постановка 
эффектов в очередь 

В библиотеке іСіиегу определяется еще несколько методов, имеющих отношение 
к анимационным эффектам и очередям, которые необходимо знать. Первым из 
них является метод з1:ор(): он останавливает воспроизведение текущего анимаци¬ 
онного эффекта для выбранных элементов. Метод з1:ор() принимает два необяза¬ 
тельных логических аргумента. Если в первом аргументе передать ігие, очередь 
анимационных эффектов для выбранных элементов будет очищена: т. е. вместе 
с текущим эффектом будут отменены все остальные эффекты, находящиеся в оче¬ 
реди. По умолчанию этот аргумент принимает значение І'аізе: если аргумент не 
указан, эффекты, находящиеся в очереди, не отменяются. Второй аргумент опре¬ 
деляет, должны ли изменяемые С88-свойства остаться в текущем состоянии или 
им должны быть присвоены конечные значения. Значение 1:гие во втором аргу¬ 
менте заставляет присвоить им конечные значения. Значение Шзе (или отсутст¬ 
вие аргумента) оставляет текущие значения С88-свойств. 

Когда анимационные эффекты запускаются по событиям, возникающим в резуль¬ 
тате действий пользователя, может потребоваться отменить все текущие и запла¬ 
нированные анимационные эффекты, прежде чем запустить новые. Например: 

// Сделать изображения непрозрачными, когда указатель мыши находится над ними. 

// Не забудьте отменить все запланированные анимационные эффекты по событиям мыши! 

$("ітд").Ьіпсі({ 

тоіізеоѵег: ?ітс*іоп() { $(Шз). зіор( ). 1=ас1еТо(300, 1.0): }, 
тоіізеоііі:: ^ьпсііопО { $(іНіз). зіор(). ^асІеТо(300, 0.5): } 

}): 

Второй метод, связанный с анимацией, который мы рассмотрим здесь, - это ме¬ 
тод с!е1ау(). Он просто добавляет задержку в очередь эффектов. В первом аргумен¬ 
те он принимает задержку в миллисекундах (или строку), а во втором необяза¬ 
тельном аргументе - имя очереди (указывать второй аргумент обычно не требует- 



594 


Глава 19. Библиотека іОиегу 


ся: об именах очередей будет рассказываться ниже). Метод с1е1ау() можно исполь¬ 
зовать в составных анимационных эффектах, как показано ниже: 

// Быстро растворить элемент до половины, подождать, а затем свернуть его 
$("ітд"). ГасІеТо( 100. 0. 5).сІе1ау(200). з1іс!еІ)р( ); 

В примере выше, где применялся метод з1:ор(), были использованы обработчики 
событий «тоивеоѵег» и «тоивеоиі» для плавного изменения непрозрачности изо¬ 
бражений. Этот пример можно усовершенствовать, если добавить в него корот¬ 
кую задержку перед запуском анимационного эффекта. При таком подходе, если 
указатель мыши быстро пересекает изображение без остановки, никакого анима¬ 
ционного эффекта не возникает: 

$("ітд"). ЬіпсІ({ 

тоіізеоѵег: ^ііпсііопО { $(Шз). зІорСІгііе).сІеІау(ІОО). І'асІеТоСЗОО, 1.0); }, 
тоіізеоьі:: ^цпсііопО { $( 1:Ыз ).з1:ор( 1: гие ).ГасІеТо(300, 0.5); } 

}); 

Последняя группа методов, с которыми мы познакомимся, предоставляют низко¬ 
уровневый доступ к механизму очередей в библиотеке іСіиегу. Очереди в библио¬ 
теке іСіиегу реализованы в виде списков функций, которые выполняются в поряд¬ 
ке их следования. Каждая очередь связана с определенным элементом документа 
(или с объектом Оосытепі: или Міпсісм), и все очереди в элементах не зависят друг от 
друга. Добавить новую функцию в очередь можно с помощью метода диеыеО. Ко¬ 
гда функция достигнет головы очереди, она будет автоматически исключена из 
очереди и вызвана. Внутри этой функции ключевое слово Шз ссылается на эле¬ 
мент, с которым связана данная очередь. В единственном аргументе функции бу¬ 
дет передана другая функция. Когда функция из очереди завершит свою работу, 
она должна вызвать переданную ей функцию; тем самым она запустит следую¬ 
щую операцию из очереди. Если эта функция не будет вызвана, обработка очере¬ 
ди будет заморожена и оставшиеся в ней функции никогда не будут вызваны. 

Мы уже знаем, что методам анимационных эффектов можно передавать функ¬ 
ции обратного вызова для выполнения некоторых действий по завершении вос¬ 
произведения эффекта. Того же эффекта можно добиться, поместив эту функцию 
в очередь: 

// Проявить элемент, подождать, записать в него текст, и изменить его рамку 
$("#теззаде"). ^ас!еІп( ). с!е1ау(200). диеие( ^ипсІіопСпехі: ) { 

$(ІПІ5) . ІехК "Привет, Мир!"); // Вывести текст 

пехІО; // Запустить следующую функцию в очереди 

}).апітаі:е({ЬогсІегІл/ісІ1:Н: "+=10рх;"}); // Увеличить толщину рамки 

Аргумент с функцией, который передается функции, помещаемой в очередь, - 
это новая особенность, появившаяся в версии іС^иегу 1.4. При использовании бо¬ 
лее ранних версий библиотеки функции в очереди извлекали следующую функ¬ 
цию «вручную», вызывая метод йедыеиеО: 

$(ІНіз).сІедііеііеС ); // Вместо пехІ() 

Если очередь пуста, метод сІедыеиеС ) ничего не делает. В противном случае он уда¬ 
ляет функцию, находящуюся в голове очереди, и вызывает ее, устанавливая зна¬ 
чение ссылки Шз и передавая функцию, описанную выше. 
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Кроме того, существует еще несколько методов управления очередью вручную. 
Метод сІеагОиеыеО очищает очередь. Если вместо единственной функции пере¬ 
дать методу диеыеО массив функций, он заменит текущую очередь новым масси¬ 
вом функций. А вызов метода дііеііе( ) без аргумента вернет текущую очередь в ви¬ 
де массива. Кроме того, библиотека іСіиегу определяет версии методов дііеие() 
и дедііеие() в виде вспомогательных функций. Например, если потребуется доба¬ 
вить функцию Т в очередь элемента е, сделать это можно будет с помощью метода 
или функции: 

$(е). рііеііеСИ; // Создать объект іОііегу, хранящий е, и вызвать метод дііеііе 

ІОііегу.цііеііеСе, И; // Просто вызвать вспомогательную функцию іОііегу. цііеііеС ) 

Наконец, обратите внимание, что методы диеие(), с1едиеие() и с1еаг0иеііе() принима¬ 
ют необязательный первый аргумент с именем очереди. Методы анимационных 
эффектов используют очередь с именем «1х» и именно эта очередь используется 
по умолчанию, если имя очереди не указано явно. Механизм очередей в библио¬ 
теке іСіиегу с успехом можно использовать для выполнения асинхронных опера¬ 
ций в определенной последовательности: вместо того чтобы передавать функцию 
обратного вызова каждой асинхронной операции, чтобы она запускала следую¬ 
щую функцию в последовательности, для управления последовательностью мож¬ 
но использовать очередь. Просто используйте имя очереди, отличное от «1х», и не 
забывайте, что функции в очереди не вызываются автоматически. Чтобы запус¬ 
тить первую функцию в очереди, необходимо явно вызвать метод йедиеиеО, а по 
завершении каждая операция должна запускать следующую. 

19.6. Реализация Аіах в библиотеке іОиегу 

Аіах - популярное название комплекса приемов разработки веб-приложений, 
в которых применяются возможности использования протокола НТТР (глава 18) 
для загрузки данных по мере необходимости без перезагрузки страниц. Приемы 
Аіах оказались настолько полезны в современных веб-приложениях, что в биб¬ 
лиотеку іСіиегу были включены вспомогательные функции, реализующие и уп¬ 
рощающие их использование. Библиотека іСіиегу определяет один высокоуровне¬ 
вый вспомогательный метод и четыре высокоуровневые вспомогательные функ¬ 
ции. Все они основаны на одной низкоуровневой функции, іОыегу.азахО. В сле¬ 
дующих подразделах мы сначала познакомимся с высокоуровневыми утилитами, 
а затем детально рассмотрим функцию іОііегу.а]ах(). Понимание принципов дей¬ 
ствия функции ]0иегу.а]ах() совершенно необходимо, чтобы до конца понять, как 
действуют высокоуровневые утилиты, даже если вам никогда не придется ис¬ 
пользовать ее явно. 

19.6.1. Метод ІоасІ() 

Метод 1оас1() является самой простой из всех утилит в библиотеке іСіиегу: он при¬ 
нимает ШІЬ-адрес, асинхронно загружает его содержимое и затем вставляет это 
содержимое в каждый из выбранных элементов, заменяя любое имеющееся со¬ 
держимое. Например: 

// Загружать и отображать последнюю информацию о состоянии каждые 60 сек. 

зе1:Іп1:егѵа1 ( ^ипс1:іоп( ) { $( "«зііаіз" ). 1оас1( “з1:аі:из_герогі:. ітіііпі"); }, 60000); 




Коды состояния А]ах, генерируемые 
библиотекой іОиегу 

Все утилиты поддержки архитектуры Азах в библиотеке іСіиегу, включая 
метод 1оас1(), вызывают функции обратного вызова, чтобы асинхронно уве¬ 
домить приложение об успехе или неудаче. Во втором аргументе этим функ¬ 
циям обратного вызова передается строка с одним из следующих значений: 

«зиссезз» 

Указывает, что запрос выполнен успешно. 

« поітойіііей » 

Эта строка говорит о том, что запрос выполнен нормально, но сервер вер¬ 
нул НТТР-ответ 304 «N 0 ! МобШесЬ, сообщая, что запрошенный доку¬ 
мент не изменился с момента предыдущего запроса. Этот код состояния 
возвращается, только когда параметр і'ГМосІі’ГіесІ имеет значение Ігие (под¬ 
робнее об этом в разделе 19.6.3.1.). Версия іСіиегу 1.4 интерпретирует код 
«поЪтобШесЬ как успех, но в более ранних версиях он интерпретиро¬ 
вался как ошибка. 

«еггог» 

Указывает, что запрос завершился неудачей из-за возникновения ка¬ 
кой-либо НТТР-ошибки. Чтобы получить более подробную информацию 
об ошибке, можно проверить код состояния НТТР в объекте ХМІ_НІ*р- 
Редиезі:, который также передается функции. 

«іітеоиі» 

Если Аоах-запрос не завершился в течение указанного вами интервала 
времени, функции обратного вызова будет передан этот код состояния. 
По умолчанию Аоах-запросы в библиотеке іС^иегу не имеют ограниче¬ 
ний по времени выполнения. Этот код состояния может быть получен, 
только если был установлен параметр Итеои* (раздел 19.6.3.1). 

«рагзегеггог» 

Этот код состояния говорит о том, что НТТР-запрос завершился успеш¬ 
но, но библиотека іСіиегу не смогла разобрать ответ. Этот код возвращает¬ 
ся, например, когда сервер отправляет ХМЬ-документ или Л8СЖ-текст, 
сформированный с ошибками. Обратите внимание, что строка имеет зна¬ 
чение «рагзегеггог», а не «рагзееггог». 


Мы уже встречались с методом 1оас1() в разделе 19.4.1, где использовали его для 
регистрации обработчика события «Іоасі». Если в первом аргументе этому методу 
передать функцию, а не строку, он будет играть роль метода регистрации обработ¬ 
чика события, а не метода поддержки архитектуры Аоах. 

Если вам потребуется просто отобразить фрагмент загруженного документа, до¬ 
бавьте в конец ІЖЬ-адреса пробел и селектор іС^иегу. Когда содержимое ІІНЬ-ад- 
реса будет загружено, указанный селектор будет использован для выбора фраг¬ 
мента загруженного НТМЬ-документа и его отображения: 
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// Загрузить и отобразить температуру из документа со сводкой погоды 
$(' #1етр‘). 1оасІ( Лл/еаТИег_геро гі: . Мті йіетрегаііі ге"); 

Обратите внимание, что селектор в конце этого ІЖЬ-адреса похож на идентифи¬ 
катор фрагмента (части ЬГКЬ-адресов, начинающиеся с символа решетки, описы¬ 
вались в разделе 14.2). Пробел в данном случае является обязательной частью, 
если необходимо, чтобы библиотека іС^иегу вставила лишь выбранный фрагмент 
(или фрагменты) загруженного документа. 

В дополнение к обязательному ЬГКЬ-адресу метод 1оасі() принимает два необяза¬ 
тельных аргумента. Первый - данные, добавляемые в ЬГКЬ-адрес или отправляе¬ 
мые вместе с запросом. Если в этом аргументе передать строку, она будет добавле¬ 
на в конец ІІКЬ (при необходимости после ? или &). Если передать объект, он будет 
преобразован в строку пар имя/значение, разделенных амперсандами, и отправ¬ 
лен вместе с запросом. (Описание особенностей преобразования объекта в строку 
для использования в составе запроса Азах приводится во врезке в разделе 19.6.2.2). 
Обычно метод 1оас1() выполняет НТТР-запрос методом ОЕТ, но, если передать объ¬ 
ект с данными, будет выполнен запрос методом Р08Т. Например: 

// Загрузить сводку погоды для населенного пункта с указанным почтовым индексом 
$( '#1:етр'). ІоасІ (" из_\ѵеа1: Ие г_ геро гі: . Ыті", ”2ірсосіе=02134"); 

// Здесь данные передаются в виде объекта, в котором дополнительно указывается, 

// что температура должна возвращаться в градусах по шкале Фаренгейта 
$( ’Я1:етр’). 1оас1( "ив_\л/еа1:»тег_герогі: . Иіті ”, { гірсосіе: 02134, ітіЛзі'Р' }); 

В другом необязательном аргументе методу ІоасІ () можно передать функцию, ко¬ 
торая будет вызвана в случае завершения Ао ах-запроса, успешного или нет, 
и (в случае успеха) после того, как содержимое ШІЬ-адреса будет загружено 
и вставлено в выбранные элементы. Если методу не передаются никакие дополни¬ 
тельные данные, эту функцию обратного вызова можно передать во втором аргу¬ 
менте. Иначе она должна передаваться в третьем аргументе. Указанная функция 
будет вызвана как метод для каждого элемента, находящегося в объекте іСіиегу, 
и ей будет передано три аргумента: полное содержимое, загруженное с указанно¬ 
го ІІНЬ-адреса, строка с кодом состояния и объект ХМЫН1:1:рРедиез1:, использовав¬ 
шийся для загрузки содержимого. Аргумент с кодом состояния - это код состоя¬ 
ния, созданный библиотекой іС^иегу, а не возвращаемый протоколом НТТР, и он 
может быть строкой, такой как «виссевв», «еггог» или «іітеоиі». 

19.6.2. Вспомогательные функции поддержки Ад'ах 

Другие высокоуровневые утилиты поддержки архитектуры Аоах в библиотеке 
ІСІиегу являются функциями, а не методами и вызываются относительно глобаль¬ 
ного имени ]0ыегу или $, а не относительно объекта с выбранными элементами. 
Функция ]0ыегу.де1:3сг1р1:() загружает и выполняет файлы со сценариями на язы¬ 
ке ^ѵаЗсгірі. Функция ]0иегу.де1^50М() загружает содержимое ІІКЬ и разбирает 
его как текст в формате ^СЖ, а получившийся в результате объект передает ука¬ 
занной функции обратного вызова. Обе эти функции вызывают функцию ]0иегу. 
деШ, которая является более универсальной функцией загрузки данных из ука¬ 
занного ЦКЬ-адреса. Наконец, функция ^Оыегу.розШ действует подобно функции 
зОыегу.деШ, но выполняет НТТР-запрос методом Р08Т, а не ОЕТ. Как и метод 
1оас1(), все эти функции выполняются асинхронно: они возвращают управление 




598 


Глава 19. Библиотека іОиегу 


еще до того, как будут загружены какие-либо данные, и извещают программу 
о результатах посредством указанной функции обратного вызова. 

19.6.2.1. іОиегу.деі$сгірі() 

Функция ^Оиегу. де1:3сгір1:() принимает в первом аргументе ІІКЬ-адрес файла со 
сценарием на языке ЛаѵаЗсгірі. Она асинхронно загружает и выполняет этот 
сценарий в глобальной области видимости. Выполняться могут сценарии как об¬ 
щего происхождения с документом, так и сторонние: 

// Динамически загрузить сценарий с некоторого другого сервера 
зОиегу. деІЗсгірі: ("ИТТр: //ехатріе . сот/з з/хл/ісідеі: . з з"); 

Во втором аргументе можно передать функцию обратного вызова, и в этом случае 
библиотека іСіиегу вызовет ее сразу после того, как загруженный сценарий будет 
выполнен. 

// Загрузить библиотеку и воспользоваться ею после загрузки 
зОиегу. де1:3сгірі:( ' ^з/здиегу. ту_р1идіп . із", Гітс*іоп() { 

$( ’сііѵ').ту_р1идіп(); // Воспользоваться загруженной библиотекой 

}); 

Для получения текста сценария, который должен быть выполнен, функция ]0ие- 
гу.деіЗсгіріО обычно использует объект ХМІ_Н1:1:рПедиез1:. Но для выполнения меж¬ 
доменных запросов (когда сценарий поставляется сервером, отличным от того, от¬ 
куда был получен текущий документ), библиотека іСіиегу использует элемент 
<зсгірі:> (раздел 18.2). Если запрос удовлетворяет ограничениям политики общего 
происхождения, в первом аргументе функции обратного вызова передается текст 
сценария, во втором - код состояния «виссевв» и в третьем - объект ХМЫНИрРериезІ:, 
использовавшийся для получения текста сценария. Возвращаемым значением 
функции ]0иегу.де1:3сгірі:( ) в данном случае также является объект ХМІ_Н1:1:рРедие5І:. 
Для междоменных запросов, которые выполняются без участия объекта ХМІ_Н*Ір- 
Рерыезі:, текст сценария не сохраняется. В этом случае в первом и третьем аргумен¬ 
тах функции обратного вызова передается значение ипсіе^іпесі, и возвращаемым 
значением функции ]0ыегу.де1:3сг1р1:() также является значение ипсіеі'іпесі. 

Функция обратного вызова, передаваемая функции зОиегу.деіЗсгіріО, вызывает¬ 
ся только в случае успешного выполнения запроса. Если также необходимо полу¬ 
чить извещение в случае ошибки, следует использовать низкоуровневую функ¬ 
цию ]0иегу.а]ах(). То же относится и к трем другим вспомогательным функциям, 
описываемым в этом разделе. 

19.6.2.2. іОиегу.деІІ§ОМ() 

Функция з0иегу.де^30М() подобна функции зОыегу.деіЗсгіріО: она загружает текст 
и затем обрабатывает его особым образом перед вызовом указанной функции об¬ 
ратного вызова. Функция ^Оыегу.де^ЗОМО не выполняет загруженный текст как 
сценарий, а выполняет синтаксический разбор этого текста как данных в форма¬ 
те Л8СЖ (используя функцию зОыегу.рагзе^ОМО: описывается в разделе 19.7). 
Функцию ^Оыегу.деІ^ЗОМО имеет смысл использовать, только когда ей передается 
функция обратного вызова. Если содержимое ІЖЬ было благополучно загружено 
и разобрано, как данные в формате Л8(Ж, то полученный в результате объект пе¬ 
редается функции обратного вызова в первом аргументе. Как и при использова- 
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нии функции ]0ііегу.де1:5сгір1:(), во втором и третьем аргументах передаются код 
состояния «виссевв» и объект ХМІ_Н1:1:рПедиез1:: 

// Допустим, что сіаіа.ізоп содержит текст: * { "х”: 1. "у":2}' 

І0иегу.де^30М("сІа1:а.ізоп", ^ипсТіоп(сІаТа) { 

// Здесь сІаТа - это объект {х: 1, у:2} 

}); 


Передача данных утилитам поддержки Аіах 

в библиотеке іОиегу 

Большинство методов поддержки архитектуры Азах в библиотеке і(}иегу 
принимают аргумент (или параметр), определяющий данные для отправки 
на сервер вместе с ІІКЬ. Обычно эти данные принимают вид строки, закоди¬ 
рованной в формате ІІНЬ, пар имя/значение, отделяющихся друг от друга 
символами амперсанда. (Этот формат представления данных известен, как 
МІМЕ-тип «арр1ісаІіоп/хлѵ\ѵ\ѵ-іЪгт-иг1епсосІесІ». Его можно рассматривать 
как аналог формата Л8СЖ - формата представления простых ЛаѵаВсгірі- 
объектов в виде строк.) При выполнении НТТР-запросов методом ОЕТ эта 
строка с данными добавляется в конец ІІКЬ-адреса запроса. При выполне¬ 
нии запросов методом Р08Т она отправляется в теле запроса после отправ¬ 
ки НТТР-заголовков. 

Получить строку с данными в этом формате можно с помощью метода зегіа- 
1ііе() объекта ]0ыегу, содержащего формы или элементы формы. Отпра¬ 
вить, например, НТМЬ-форму с помощью метода 1оас1() можно следующим 
образом: 

$( “#зиЬші1:_Ьи1:1:оп" ). с1іск( 1=ипс1:іоп(еѵеп1: ) { 

$(1:Иіз. ^огш). 1оасІ( // Заменить форму, загрузив... 

ІЬіз.^огт.асііоп, // из указанного іігі 

$(ІИіз. , Рогт).5егіа1і2е()); // с данными, добавленными в него 
еѵепі:.ргеѵепЮеІ'аиІК): // Отменить отправку формы по умолч. 

ІМз.сіізаЫесі = "сІізаЫесГ; // Предотвратить несколько 

}); // попыток отправки 

Если в аргументе (или параметре) передать функции поддержки архитек¬ 
туры Азах в библиотеке іС^иегу объект, а не строку, то библиотека і(}иегу по 
умолчанию (с исключениями, описываемыми ниже) автоматически преоб¬ 
разует объект в строку, вызвав функцию ]Оііегу.рагат(). Эта вспомогатель¬ 
ная функция интерпретирует свойства объекта как пары имя/значение 
и, например, преобразует объект {х:1,у:"Ие11о"} в строку "х=1&у=Ие11о". 

В версии іСіиегу 1.4 функция ]Оиегу.рагат() способна обрабатывать более 
сложные объекты. Если значение свойства объекта является массивом, для 
каждого элемента этого массива будет создана отдельная пара имя/значе¬ 
ние, а к имени свойства будут добавлены квадратные скобки. Если значе¬ 
нием свойства является объект, имена свойств этого вложенного объекта 
помещаются в квадратные скобки и добавляются к имени внешнего свой¬ 
ства. Например: 
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$.рагат({а:[1.2,3]}) // Вернет "а[]=1&а[]=2&а[]=3" 

$.рагат({о: {х: 1,у: 1; гие }}) // Вернет "о[х]=1&о[у]=1:гііе" 

$.рагат({о:{х:{у:[1.2])>>) // Вернет "о[х][у][]=1&о[х][у][]=2" 

Для обратной совместимости с версией іСіиегу 1.3 и ниже во втором аргу¬ 
менте функции ]0ыегу. рагапі() можно передать значение 1:гие или установить 
параметр ІтасІШопаІ в значение Ітие. Это предотвратит использование рас¬ 
ширенных возможностей сериализации свойств, значениями которых яв¬ 
ляются массивы или объекты. 

Иногда бывает необходимо передать в теле Р08Т-запроса объект Оосытепі: 
(или какой-то другой объект, который не должен преобразовываться авто¬ 
матически). В этом случае можно установить в параметре согѵЕегѵЕТуре тип 
данных и в параметре ргосеззОаІіа значение Гаізе и тем самым предотвра¬ 
тить передачу объекта с данными функции ]0иегу.рагагл( ). 


В отличие от ^0иегу.де1:3сгір1:( ), функция зОыегу.де^ЗОМО принимает необязатель¬ 
ный аргумент с данными, подобный тому, что передается методу 1оасІ( ). Если функ¬ 
ции зОыегу.деІ^ЗОМО необходимо передать данные, они должны передаваться во 
втором аргументе, а функция обратного вызова - в третьем. Если дополнительные 
данные не требуются, функцию обратного вызова можно передать во втором аргу¬ 
менте. Если данные являются строкой, она будет добавлена в конец ШІЬ-адреса, 
вслед за символом ? или &. Если данные передаются в виде объекта, он будет пре¬ 
образован в строку (как описывается во врезке) и добавлен в конец ШІЬ-адреса. 

Если строка ІШЬ или данных, передаваемая функции ^Оиегу.де^ЗОЩ), содержит 
последовательность символов «=?» в конце или перед амперсандом, она определя¬ 
ет запрос Л8СЖР. (Описание формата Л8СЖР приводится в разделе 18.2.) Библио¬ 
тека іСіиегу заменит знак вопроса именем функции обратного вызова, которая 
будет создана автоматически, и функция ]0иегу.де1^50М() будет действовать, как 
если бы выполнялся запрос сценария, а не объекта в формате Л8СЖ. Этот прием не 
работает со статическими Л8(Ж-файлами данных: он может применяться только 
при наличии сценариев на стороне сервера, поддерживающих формат Л8СЖР. Од¬ 
нако, поскольку данные в формате Л8СЖР обрабатываются как сценарии, для их 
получения допускается выполнять междоменные запросы. 

19.6.2.3. 10иегу.де1() и і()иегу.ро5І() 

Функции ]0иегу.де1;() и зОыегу.розШ загружают содержимое из указанного адре¬ 
са ЬГКЬ, отправляя дополнительные данные, если они имеются, и передавая ре¬ 
зультат указанной функции обратного вызова. Функция ]0иегу.де1:() делает это, 
выполняя НТТР-запрос методом СЕТ, а функция ]0ыегу. роз1:() - методом Р08Т, но 
во всем остальном эти две вспомогательные функции совершенно идентичны. Обе 
они принимают те же три аргумента, что и функция ]0иегу.де1^50М(): обязатель¬ 
ный ЬГНЬ-адрес, необязательную строку или объект с данными и технически не¬ 
обязательную, но практически всегда используемую функцию обратного вызова. 
В первом аргументе функции обратного вызова передаются полученные данные, 
во втором - строка «зиссезз» и в третьем - объект ХМІ_Н1:1:рРедиез1: (если он исполь¬ 
зовался для выполнения запроса): 
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// Запросить текст с сервера и отобразить его в диалоге аіе гТ 
зОііегу.деіС'сІеЬид. ТхТ", аіегі); 

Помимо трех аргументов, описанных выше, эти две функции могут принимать 
четвертый необязательный аргумент (передается как третий аргумент, если до¬ 
полнительные данные отсутствуют), который определяет тип запрашиваемых 
данных. Этот аргумент влияет на обработку полученных данных перед передачей 
их функции обратного вызова. Метод 1оас1() использует тип «ЫтЬ, зОыегу.деІ:- 
Зсгір1:() - тип «всгірі», а ]0ыегу.де1:330М() - тип «івоп». Однако функции ]0иегу.де1:() 
и ]0ііегу.роз1:() более гибкие, чем эти специализированные утилиты, и им можно 
указать любой из этих типов. Допустимые значения этого аргумента и особенно¬ 
сти поведения библиотеки іСіиегу при его отсутствии описываются во врезке. 


Типы данных, поддерживаемые 
реализацией Аіах в библиотеке іОиегу 

Функциям ]0ыегу.де1:() и ]0ыегу. розИ() допускается передавать любой из шес¬ 
ти типов данных. Кроме того, как описывается ниже, любой из этих типов 
можно также передавать функции ]0иегу.а]ах() в виде параметра сІаІаТуре: 

"Іехі" 

Вернуть ответ сервера как простой текст, без дополнительной обработки. 

"ИНтГ 

Этот тип обрабатывается так же, как тип "Іехі": ответ возвращается как 
простой текст. Этот тип используется методом 1оас1(), который вставля¬ 
ет текст ответа в документ. 

"хті" 

Предполагает, что ЦКЬ-адрес ссылается на данные в формате ХМЬ, 
и для их получения вместо свойства гезропзеТехІ: объекта ХМЫН1:1:рРедиез1: 
библиотека іСіиегу использует свойство гезропзеХМ1_. Функции обратного 
вызова передается не строка с текстом документа, а объект Ооситепі:, 
представляющий ХМЬ-документ. 

■’зсгірі:" 

Предполагает, что ІІКЬ-адрес ссылается на файл со сценарием на языке 
^ѵаЗсгірі, и перед передачей функции обратного вызова текст ответа 
выполняется как сценарий. Этот тип используется функцией ]0иегу.де1> 
Зсгірі:(). Когда указывается тип зсгірі:", библиотека будет выполнять 
междоменные запросы с помощью элемента <зсгір1:> вместо объекта 
ХМІ_Н1:1:рРедие5І:. 

"]50П" 

Предполагает, что ЬГКЬ-адрес ссылается на файл с данными в формате 
^СЖ. Функции обратного вызова в этом случае передается объект, по¬ 
лученный в результате разбора содержимого ответа с помощью функ¬ 
ции зОыегу.рагзе^ОМО (раздел 19.7). Этот тип используется функцией 
зОиегу.де'ЫЗОМО. Если указан тип ’^зоп" и строка ІІКЬ или данных содер¬ 
жит "=? ", тип преобразуется в "]зопр”. 
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"ззопр" 

Предполагает, что ІЖЬ-адрес ссылается на серверный сценарий, поддер¬ 
живающий протокол Л8СЖР передачи данных в формате Л8(Ж в виде 
аргумента указанной функции на стороне клиента. (Подробнее о форма¬ 
те Л8СЖР рассказывается в разделе 18.2.) Когда указывается этот тип, 
функции обратного вызова передается разобранный объект. Поскольку 
Л8(ЖР-запросы могут выполняться с помощью элементов <зсгірі;>, этот 
тип можно использовать для выполнения междоменных запросов, по¬ 
добно типу “зсгірі;". При использовании этого типа строка ІШЬ или дан¬ 
ных обычно должна включать параметр вида "&]зопр=?" или , &са11Ьаск=? ". 
Библиотека і(}иегу заменит знак вопроса именем автоматически соз¬ 
данной функции обратного вызова. (Обратите внимание на параметры 
ізопр и ззопрСаІІЬаск, описываемые в разделе 19.6.3.3, позволяющие оп¬ 
ределить альтернативные варианты.) 

Если при вызове ]0иегу.деі:(), ]0иегу.роз1:() или ]0иегу.а]ах() не указан ни 
один из этих типов, библиотека і(}иегу проверит заголовок «Сопіепі-Туре» 
НТТР-ответа. Если этот заголовок включает подстроку «хті», функции об¬ 
ратного вызова будет передан ХМЬ-документ. Иначе, если заголовок вклю¬ 
чает подстроку «івоп», ответ будет разобран, как данные в формате Л8СЖ, 
и полученный объект будет передан функции обратного вызова. Иначе, ес¬ 
ли заголовок включает подстроку «Лаѵабсгірі», ответ будет выполнен как 
сценарий. Иначе данные будут интерпретироваться как простой текст. 


19.6.3. Функция іОиегу.аіах() 

Все утилиты поддержки архитектуры Аіах в библиотеке і(}иегу в конечном итоге 
вызывают ]0ііегу. Э]ах() - самую сложную функцию во всей библиотеке. Функция 
]0иегу.а]ах() принимает всего один аргумент: объект с параметрами, свойства ко¬ 
торого определяют детали, касающиеся выполнения Аіах-запроса. Вызов ^Оиегу. 
деІіЗсгірііСигІ, саІІЬаск), например, эквивалентен следующему вызову функции 
]0иегу.а]ах(): 

ІОыегу.аіах({ 

Іуре: "СЕТ”, 
игі: и гі , 
сіаіа: пиіі, 
сІаіаТуре: "зсгірі:", 
зиссезз: саІІЬаск 

}); 

Эти пять фундаментальных параметров можно также установить при использо¬ 
вании функций ]0иегу.де1;() и ]0иегу.розі:(). Однако при непосредственном исполь¬ 
зовании ]0иегу.а]ах() имеется возможность указать большое количество других 
параметров. Все параметры (включая пять основных, представленных выше) де¬ 
тально описываются ниже. 


// Метод НТТР-запроса. 

// ІІРІ_-адрес запрашиваемых данных. 

// Не добавлять дополнительные данные в УРІ_. 
// Выполнить ответ как сценарий. 

// Вызвать эту функцию по завершении. 




19.6. Реализация А]ах в библиотеке іОиегу 


603 


Прежде чем погрузиться в описание параметров, обратите внимание, что имеется 
возможность определить значения по умолчанию любых из этих параметров, пе¬ 
редав объект с параметрами функции ]0иегу.а]ахЗе1:ир(): 

ІОиегу. аіах$е1:ир( { 

Іітеоиі:: 2000, // Прерывать все А]ах-запросы через 2 секунды 
сасНе: ^аізе // Игнорировать кэш броузера, добавляя время в ІІПІ_ 

}); 

После выполнения программного кода, приведенного выше, указанные парамет¬ 
ры ііітеоиі: и сасОе будут действовать для всех Аіах-запросов (включая высоко¬ 
уровневые утилиты, такие как ]0иегу.де1:() и ІоасК)), при вызове которых не ука¬ 
зываются значения этих параметров. 

В процессе знакомства с многочисленными параметрами и особенностями функ¬ 
ций обратного вызова в следующих разделах может оказаться полезным еще раз 
ознакомиться с информацией во врезках, касающейся кодов состояния Аіах-за- 
просов и типов данных в разделах 19.6.1 и 19.6.2.3. 


Поддержка А|ах в версии іОиегу 1.5 

В версии іС^иегу 1.5, которая вышла, когда эта книга готовилась к печати, 
модуль поддержки архитектуры Діах был полностью переписан, и в нем по¬ 
явилось несколько новых удобных особенностей. Самое важное, что функ¬ 
ция ]0иегу.а]ах() и все утилиты поддержки Аіах, описанные выше, теперь 
возвращают объект ^дХНВ. Этот объект имитирует прикладной интерфейс 
объекта ХМЬНіііірВедиезі: даже для запросов (например, выполняемых функ¬ 
цией $.деі5сгір*()), не использующих объект ХМЫНіііірВедиезі:. Кроме того, 
объект ^дХНВ определяет методы зиссеззО и еггог(), которые можно исполь¬ 
зовать для регистрации функций, вызываемых в случае успешного или не¬ 
удачного завершения запроса. То есть вместо того чтобы передавать функ¬ 
цию обратного вызова функции ]0иегу.де1:(), например, ее можно зарегист¬ 
рировать с помощью метода зиссеззО объекта ^дХНР, возвращаемого этой 
утилитой: 

ІОиегу. деК "сіаіа. Іхі" ) 

.зиссезз( Гипсіііоп ( сіаііа ) { сопзоіе. 1од("Получено ", сіаіа); }) 

. зиссѳ58(1 : ипс1:іоп(с1аі:а) { ргосезз(Раі:а); }); 


19.6.3.1. Часто используемые параметры 

Ниже перечислены параметры, которые наиболее часто передаются функции 

]0иегу.а]ах(): 

Нуре 

Определяет метод НТТР-запроса. По умолчанию имеет значение «СЕТ». Дру¬ 
гим наиболее часто используемым значением является «Р08Т». Допускается 
указывать также другие методы НТТР-запросов, такие как «БЕЬЕТЕ» и «РИТ», 
но они поддерживаются не всеми броузерами. Обратите внимание, что имя 
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этого параметра может вводить в заблуждение: он не имеет никакого отноше¬ 
ния к типу данных в запросе или ответе, и для него лучше подошло бы имя 
«теіЬосІ». 


II гі 

ІЖЬ-адрес загружаемых данных. При выполнении ОЕТ-запросов параметр 
йаГа добавляется в конец этого ІЖЬ-адреса. Библиотека іС^иегу может автома¬ 
тически добавлять параметры в строку ИНЬ при выполнении Л8(ЖР-запросов 
и когда параметр сасИе имеет значение Гаізе. 

баХа 

Данные, добавляемые в конец ІШЬ-адреса (для ОЕТ-запросов) или отправляе¬ 
мые в теле запроса (для Р08Т-запросов). Может быть строкой или объектом. 
Объекты обычно преобразуются в строки, как описывалось во врезке в разде¬ 
ле 19.6.2.2, однако имеются некоторые исключения, которые приводятся в опи¬ 
сании параметра ргосеззОаГа. 

сіаііаТуре 

Определяет тип ожидаемых данных в ответе и способ их обработки библиоте¬ 
кой іС^иегу. Допустимыми значениями являются «іехі», «Мті», «всгірі», «ізоп», 
«Ізопр» и «хтЬ. Суть этих значений описана во врезке в разделе 19.6.2.3. Этот 
параметр не имеет значения по умолчанию. Если он не указан, библиотека 
І(}иегу проверит заголовок «Сопіепі-Туре» ответа, чтобы определить, что де¬ 
лать с полученными данными. 

сопГепгТуре 

Определяет НТТР-заголовок «Сопіепі-Туре» запроса. По умолчанию имеет 
значение «арр1ісаііоп/х->ѵ>ѵ>ѵ-1огт-иг1епсо(іе(і», которое обычно используется 
НТМЬ-формами и большинством серверных сценариев. Если вы установили 
параметр Гу ре в значение «Р08Т» и собираетесь отправить в теле запроса про¬ 
стой текст или ХМЬ-документ, вам должны также установить этот параметр. 

Гітеоиі: 

Предельное время ожидания в миллисекундах. Если этот параметр установ¬ 
лен и запрос не завершится в течение указанного времени, выполнение запро¬ 
са прервется и будет вызвана функция обратного вызова е г го г с кодом состоя¬ 
ния «іітеоиі». По умолчанию параметр ПтеоиГ имеет значение 0, которое оз¬ 
начает, что выполнение запроса будет продолжаться до его завершения и ни¬ 
когда не будет прервано. 

сасИе 

При выполнении ОЕТ-запросов, если этот параметр будет установлен в значе¬ 
ние Гаізе, библиотека іСіиегу добавит параметр _= в строку ИНЬ или заменит 
существующий параметр с этим именем. В качестве значения этого параметра 
будет установлено текущее время (в виде количества миллисекунд). Это пре¬ 
дотвратит использование кэша броузера, поскольку каждый раз, когда запрос 
будет выполняться, строка ІЖЬ будет иной. 

іГМосІіГіесІ 

Когда этот параметр имеет значение Гше, библиотека іС^иегу будет сохранять 
значения заголовков «Ьаві-МосІШесІ» и «И-Копе-МаісЬ» ответов для каждого 
запрошенного ІЖЬ-адреса и затем будет устанавливать эти заголовки во всех 
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последующих запросах к тем же самым ІЖЬ-адресам. Это предписывает сер¬ 
веру отправлять НТТР-ответ 304 «Ыоі МогіШесІ», если содержимое по указан¬ 
ному ІЖЬ-адресу не изменилось с момента последнего обращения. По умолча¬ 
нию данный параметр не установлен и библиотека іС^иегу не сохраняет эти 
заголовки. 

Библиотека іСіиег у преобразует НТТР-ответ 304 в код состояния «поітосіШеб». 
Код «поіпккІШеб» не считается ошибкой и передается функции обратного вы¬ 
зова зиссезз вместо обычного кода состояния «зиссезв». То есть если вы уста¬ 
навливаете параметр іІ'МосІШесІ, вы также должны проверять код состояния 
в своей функции обратного вызова - если будет получен код состояния «поіто- 
сІШесІ», то первый аргумент функции (данные из ответа) будет иметь значение 
ипйе^пей. Обратите внимание, что в версии іС^иегу ниже 1.4 НТТР-ответ 304 
интерпретировался как ошибка, и код состояния «поІтосІШесІ» передавался 
функции обратного вызова еггог, а не зиссезз. Подробнее о кодах состояния 
рассказывается во врезке в разделе 19.6.1. 

дІоЬаІ 

Этот параметр определяет, должна ли библиотека іС^иегу возбуждать события 
в ходе выполнения Аіах-запроса. По умолчанию имеет значение Іігие. При¬ 
свойте этому параметру значение ^аізе, чтобы запретить все события, связан¬ 
ные с поддержкой архитектуры Аіах. (Полное описание событий приводится 
в разделе 19.6.4.) Имя этого параметра несколько обескураживает: он имеет 
имя «&1оЪа1», потому что обычно библиотека іС^иегу возбуждает события гло¬ 
бально, а не в конкретном объекте. 

19.6.3.2. Функции обратного вызова 

Следующие параметры определяют функции, вызываемые на разных стадиях 
в ходе выполнения Аіах-запроса. С параметром зиссезз вы уже знакомы: это функ¬ 
ция обратного вызова, которая передается методам, таким как }0иегу.де1^50М(). 
Обратите внимание, что библиотека іС^иегу также посылает извещения в ходе вы¬ 
полнения Аіах-запроса в виде событий (если параметр дІоЬаІ не был установлен 
в значение ^аізе). 

сопіехі 

Этот параметр определяет объект, используемый в качестве контекста - зна¬ 
чения ссылки Шз - для различных функций обратного вызова. Данный пара¬ 
метр не имеет значения по умолчанию, и если его не устанавливать, функции 
обратного вызова будут вызываться в контексте объекта с параметрами, в ко¬ 
тором они определяются. Значение параметра сопіехі: также воздействует на 
порядок возбуждения событий механизмом поддержки Аіах (раздел 19.6.4). 
Значением этого параметра должен быть объект іл/іпсіом, Ооситепі: или Еіетепі, 
в котором могут возбуждаться события. 

Ье1"огеЗепс1 

Этот параметр определяет функцию, которая должна вызываться перед от¬ 
правкой Аіах-запроса на сервер. Первым аргументом этой функции передает¬ 
ся объект ХМЫНіііірРедиезі;, а вторым - объект с параметрами запроса. Функция 
ЬсГогеЗепсІ дает программе возможность установить собственные НТТР-заго- 
ловки в объекте ХМШіііірРедиезІ:. Если эта функция вернет 1"а1зе, выполнение 
Аіах-запроса будет прервано. Обратите внимание, что для выполнения междо- 
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менных запросов типов «всгірі» и «івопр» объект ХМЫНіііірРедиезі; не использует¬ 
ся и функция, определяемая параметром ЬеГогеЗепсІ, не вызывается. 

зиссезз 

Этот параметр определяет функцию, которая должна вызываться в случае ус : 
пешного выполнения Аіах-запроса. В первом аргументе ей передаются дан¬ 
ные, отправленные сервером. Во втором аргументе - код состояния, сгенери¬ 
рованный библиотекой іС^иегу, и в третьем - объект ХМЫН1:1;рРедиез1:, использо¬ 
вавшийся для выполнения запроса. Как описывалось в разделе 19.6.2.3, тип 
данных в первом аргументе зависит от значения параметра сІаііаТуре или заго¬ 
ловка «Сопіепі-Туре» в ответе сервера. Если данные имеют тип «хті», в пер¬ 
вом аргументе передается объект Ооситепіі. Если данные имеют тип «двоп» или 
«Івопр», в первом аргументе передается объект, полученный в результате раз¬ 
бора ответа сервера в формате Л8СЖ. Если данные имеют тип «зсгірі», ответом 
является текст загруженного сценария (однако к моменту вызова функции 
сценарий уже будет выполнен, поэтому в данном случае ответ обычно игнори¬ 
руется). Для других типов ответ интерпретируется как простой текст, содер¬ 
жащийся в запрошенном ресурсе. 

Код состояния во втором аргументе обычно является строкой «зиссезз». Но, 
если был установлен параметр і^МосІШесІ, в этом аргументе может также пере¬ 
даваться строка «поітосІШесІ». В этом случае сервер не отправляет данные 
в ответе, и в первом аргументе будет передано значение ипйеГіпесІ. Для выпол¬ 
нения междоменных запросов на получение данных типов «зсгірі» и «дзопр» 
используется элемент <зсгіріі>, а не объект ХМШіііірВедиезі:, поэтому для таких 
запросов в третьем аргументе вместо объекта ХМЫНіііірВедиезі: будет передавать¬ 
ся значение ііпйеГіпесІ. 

еггог 

Этот параметр определяет функцию, которая должна вызываться в случае не¬ 
удачи Діах-запроса. В первом аргументе этой функции передается объект 
ХМІ_Н1ііірНедие5Іі запроса (если таковой использовался). Во втором аргументе- 
код состояния, сгенерированный библиотекой іС^иегу. Это может быть строка 
«еггог» - в случае ошибки протокола НТТР, «іітеоиі» - в случае превышения 
времени ожидания и «рагзегеггог» - в случае ошибки, возникшей в ходе разбо¬ 
ра ответа сервера. Например, если ХМЬ-документ или объект в формате Л8СЖ 
будет сформирован неправильно, функция получит код состояния «рагзег- 
еггог». В этом случае в третьем аргументе функции еггог будет передан объект 
Еггог, представляющий исключение. Обратите внимание, что запросы с пара¬ 
метром сіаі:аТуре="зсгірі;**, возвращающие недопустимый программный код 
ѵабсгірі, не вызывают ошибки. Любые ошибки в сценарии просто игнориру¬ 
ются и вместо функции еггог вызывается функция зиссезз. 

сотріеііе 

Этот параметр определяет функцию, которая должна вызываться по заверше¬ 
нии Аіах-запроса. Каждый Аіах-запрос завершается либо успехом и вызывает 
функцию зиссезз, либо неудачей и вызывает функцию еггог. Библиотека іС^иегу 
вызывает функцию сотріеііе после вызова функции зиссезз или еггог. В первом 
аргументе функции сотріеііе передается объект ХМЫНІіІірВедиезІі, а во втором - 
код состояния. 
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19.6.3.3. Редко используемые параметры и обработчики 

Следующие параметры используются довольно редко. Некоторые из них являют¬ 
ся параметрами, которые вам едва ли придется устанавливать, а другие опреде¬ 
ляют обработчики для тех, кому потребуется изменить порядок обработки Діах- 
запросов, используемый в библиотеке іС^иегу по умолчанию. 

азупс 

Запросы НТТР по своей природе являются асинхронными. Однако объект 
ХМШіііірРедиезі: дает возможность заблокировать выполнение сценария до полу¬ 
чения ответа. Если присвоить этому параметру значение ^аізе, библиотека 
ІСІиегу будет блокировать работу сценария. Данный параметр не влияет на зна¬ 
чение, возвращаемое функцией ]0иегу.а]ах(): она всегда возвращает объект 
ХМЬНіііірРедиезі:, если он используется. При выполнении синхронных запросов 
вы можете самостоятельно извлекать ответ сервера и код состояния НТТР из 
объекта ХМЫНіііірРедиезі: или определить функцию обратного вызова сотр1е1:е 
(как в случае асинхронных запросов), чтобы получить разобранный ответ и код 
состояния іС^иегу. 

йаіаРШег 

Этот параметр определяет функцию фильтрации или предварительной обра¬ 
ботки данных, возвращаемых сервером. В первом аргументе ей будут переда¬ 
ваться необработанные данные, полученные от сервера (либо в виде строки, ли¬ 
бо в виде объекта Ооситепі:, при запросе ХМЬ-документа), а во втором аргумен¬ 
те - значение параметра йаі:аТуре. Эта функция должна возвращать значение, 
которое будет использоваться вместо ответа сервера. Обратите внимание, что 
функция сІаіаРШег вызывается перед разбором данных в формате Л80К или пе¬ 
ред выполнением сценария. Кроме того, отметьте, что сІаіаРШег не вызывается 
при выполнении междоменных запросов данных типов «зсгірі» и «ізопр». 

]50ПР 

Когда параметр сІаІаТуре имеет значение «ізопр», значение параметра игі или 
с!а1:а обычно включает параметр строки запроса вида «ізопр=?». Если библиоте¬ 
ка іСіиегу не обнаружит этот параметр в ІШЬ-адресе или в данных, она вставит 
его, используя значение параметра ізопр в качестве имени параметра в строке 
запроса. По умолчанию параметр ізопр имеет значение «саІІЪаск». Присвойте 
ему другое значение, если сервер, поддерживающий обмен данными в форма¬ 
те Л8СЖР, ожидает получить другое имя параметра в строке запроса и вы явно 
не указываете это имя в строке ІШЬ или в данных. Подробнее о формате 
Л8СЖР рассказывается в разделе 18.2. 

ІзопрСаІІЬаск 

Для запросов с параметром йаі:аТуре, имеющим значение «ізопр» (или «ізоп», 
когда ШІЬ-адрес включает параметр строки запроса, такой как «ізопр=?»), 
библиотека іС^иегу будет изменять строку ІІКЬ, подставляя вместо знака во¬ 
проса имя функции-обертки, которой сервер будет передавать данные. Обыч¬ 
но библиотека іС^иегу синтезирует уникальное имя функции, опираясь на те¬ 
кущее время. Присвойте этому параметру свое значение, если вам потребуется 
явно указать собственную функцию. Но имейте в виду, что в этом случае биб¬ 
лиотека іС^иегу не будет вызывать функции обратного вызова зиссезз и сотр1е1:е 
и не будет возбуждать обычные события. 




608 


Глава 19. Библиотека іОиегу 


ргосеззОаі:а 

Когда значением параметра сіаііа является объект (или объект передается во 
втором аргументе функции ^Оиегу.де1:( ) и родственным ей функциям), библио- 
тека іСіиегу обычно преобразует этот объект в строку в формате «арріісаііоп/х- 
^ѵлѵдѵ-іЪгт-игІепсобесЬ (как описывается во врезке в разделе 19.6.2.2). Если по¬ 
требуется предотвратить это преобразование (например, чтобы передать объ¬ 
ект Ооситепі: в теле Р08Т-запроса), присвойте этому параметру значение Гаізе. 

зсгірііСИагзеІ; 

Для междоменных запросов данных типов «зсгірі» и «дзопр», при выполнения 
которых используется элемент <зсгір1:>, этот параметр определяет значение 
атрибута сГіагзеІ: элемента. Он никак не влияет на обычные запросы, выпол¬ 
няемые с помощью объекта ХМЫНіііірРедиезІ;. 

ІхасІШопаІ 

В библиотеке іС^иегу версии 1.4 несколько изменился способ сериализации 
объектов с данными в строки формата «аррІісаиоп/х-^ѵ^ѵ^ѵ-Іогт-игІепсогіесЬ 
(подробности приводятся во врезке в разделе 19.6.2.2). Присвойте этому пара¬ 
метру значение Іігие, если необходимо, чтобы библиотека іС^иегу использовала 
прежний порядок. 

изегпате, раззмогсі 

Если для выполнения запроса необходимо выполнить процедуру аутентифика¬ 
ции пользователя, укажите имя пользователя и пароль в этих двух параметрах. 

хЬг 

Этот параметр определяет фабричную функцию, создающую объект ХМ1_Н11р- 
Редиезі:. Она вызывается без аргументов и должна возвращать объект, реали¬ 
зующий прикладной программный интерфейс объекта ХМЫНіііірВедиезі:. Этот 
весьма низкоуровневый обработчик позволяет создавать собственные обертки 
вокруг объекта ХМЫНіііірВедиезІ: и добавлять новые особенности или расширять 
его методы. 

19.6.4. События в архитектуре Аіах 

В разделе 19.6.3.2 говорилось, что функция ^Оиегу.а^ахО имеет четыре парамет¬ 
ра, определяющие функции обратного вызова: ЬеГоге8епсІ, зиссезз, еггог и сотр1е1:е. 
Помимо вызова этих функций, функции поддержки архитектуры Аіах в библио¬ 
теке іС^иегу также возбуждают собственные события на каждой стадии выполне¬ 
ния запроса. В следующей таблице перечислены параметры, определяющие функ¬ 
ции обратного вызова, и соответствующие им события: 


Функция обратного вызова 

Тип события 

Метод регистрации обработчика 

ЬеГогеЗепсІ 

«аіах8епсЬ 

а^ахЗепсК) 

51ІССѲ55 

«аіахЗиссегг» 

азахЗыссеззО 

еггог 

«аіахЕггог* 

а^ахЕггог() 

сотріеііе 

♦аіахСотрІеіе» 

а^ахСотрІеІіеО 


♦аіахВіагі» 

а^ахЗіагііО 


«а;ах81ор» 

а^ахЗіорО 
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Зарегистрировать обработчики этих событий можно с помощью метода Ьіпс1( ) 
(раздел 19.4.4), используя строку с типом события из второй колонки, или с помо¬ 
щью методов из третьей колонки. Метод а^ахЗиссеззО и другие действуют точцо 
так же, как с1іск(), тоизеоѵег() и другие простые методы регистрации событий, 
о которых рассказывалось в разделе 19.4.1. 

Поскольку события, генерируемые реализацией архитектуры Аіах, являются не¬ 
стандартными и генерируются самой библиотекой іС^иегу, а не броузером, объект 
Еѵепі:, передаваемый обработчикам, не содержит сколько-нибудь полезной инфор¬ 
мации. Однако вместе со всеми событиями - «аіахЗешІ», «аіахбиссезз», «аіахЕг¬ 
гог» и «аіахСотрІеІе» - передаются дополнительные аргументы. Всем обработ¬ 
чикам этих событий будет передаваться два дополнительных аргумента. В пер¬ 
вом дополнительном аргументе будет передаваться объект ХМЫНіііірРедиезі:, а во 
втором - объект с параметрами. Это означает, что обработчик события, например 
«аіах8епсЬ>, сможет добавлять собственные заголовки в объект ХМЫНіііірВедиезі:, по¬ 
добно функции обратного вызова ЬеІ'огеЗепсІ. Обработчикам события «аіахЕггог» 
передается третий дополнительный аргумент помимо двух, только что описан¬ 
ных. В этом последнем аргументе будет передаваться объект Еггог, если таковой 
имеется, который был создан в результате возникшей ошибки. Довольно стран¬ 
но, но обработчикам событий архитектуры Аіах не передается код состояния, ге¬ 
нерируемый библиотекой іС^иегу. Если, например, в обработчике события «аіах¬ 
биссезз» потребуется отличать состояния «зиссезз» и «поіпккІШесІ», необходимо 
будет проверить код состояния НТТР-ответа в объекте ХМЫНіііірРедиезі:. 

Последние два события, перечисленные в таблице выше, отличаются от других 
тем, что не имеют соответствующих им функций обратного вызова, а также тем, 
что их обработчикам не передаются дополнительные аргументы, «аіахбіагі» 
и «аіахбіор» - это пара событий, которые извещают о начале и окончании выпол¬ 
нения сетевых операций при выполнении Аіах-запроса. Когда библиотека іС^иегу 
не выполняет ни одного Аіах-запроса и инициируется новый запрос, она возбуж¬ 
дает событие «аіахбіагі». Если до того, как завершится первый запрос, будут за¬ 
пущены новые запросы, эти новые запросы не будут вызывать появление нового 
события «аіах81аг1». Событие «аіахЗІор» генерируется, когда завершится по¬ 
следний Аіах-запрос и при этом библиотека іС^иегу уже не выполняет никаких 
сетевых операций. Эта пара событий может пригодиться для отображения и со¬ 
крытия анимированного сообщения «Загрузка...» или изображения, свидетель¬ 
ствующего о выполнении сетевых операций. Например: 

$( "#1оа(Ипд_апіта1:іоп" ). ЬіпсІ( { 

аіахЗіагі:: 1"ипс1:іоп() { $( 1:1ііз). зііо\л/(); }, 
аіахЗіор: І'ипсіііоп() { $(1:Міз).ИісІе(); } 

}); 

Обработчики событий «аіахбіагі» и «аіахбіор» можно связать с любым элементом 
документа: библиотека іС^иегу генерирует их глобально (раздел 19.4.6), а не для 
какого-то конкретного элемента. Другие четыре события архитектуры Діах- 
«аіахбеші», «аіахбиссезз», «аіахЕггог» и «аіахСотрІеІе» - также обычно генери¬ 
руются глобально, поэтому их обработчики также можно связать с любым эле¬ 
ментом документа. Однако если установить параметр сопіехі: при вызове функ¬ 
ции ]0иегу.а]ах(), эти четыре события будут генерироваться только в контексте 
указанного элемента. 




610 


Глава 19. Библиотека іОиегу 


Наконец, запомните, что появление всех событий архитектуры Аіах в библиоте¬ 
ке іСіиегу можно предотвратить, присвоив параметру дІоЬаІ значение Гаізе. Не¬ 
смотря на обескураживающее имя параметра дІоЬаІ, присваивание ему значения 
Гаіае предотвращает возбуждение событий не только в глобальном масштабе, но 
и в объекте сопГехГ. 

19.7. Вспомогательные функции 

Библиотека іС^иегу определяет множество вспомогательных функций (и два свой¬ 
ства), которые могут вам пригодиться в ваших программах. Как вы увидите 
в списке ниже, для многих из этих функций теперь имеются эквиваленты в стан¬ 
дарте ЕСМА8сгірі 5 (Е85). Функции в библиотеке іС^иегу были созданы еще до 
появления стандарта Е85 и действуют во всех броузерах. Ниже в алфавитном по¬ 
рядке перечислены вспомогательные функции: 

]Оиегу.Ьго\л/зег 

Свойство Ьгсмзег является не функцией, а объектом, который можно использо¬ 
вать для определения типа броузера (раздел 13.4.5). Если сценарий выполняет¬ 
ся в ІЕ, свойство тзіе этого объекта будет иметь значение Ггие. В ГігеГох и род¬ 
ственных ему броузерах значение Ггііе будет иметь свойство тоііііа. В 8аГагі 
и СЬготе значение Ггие будет иметь свойство меЬкіГ, а в броузере Орега значение 
Гше будет иметь свойство орега. В дополнение к этим свойствам объект Ьгомзег 
имеет также свойство ѵегзіоп, содержащее номер версии броузера. Приема оп¬ 
ределения типа броузера лучше стараться избегать, насколько это возможно, 
тем не менее это свойство можно использовать обхода ошибок, характерных 
для разных броузеров, как показано ниже: 

ІГ ($.Ьгсмзег. то2і11а && рагзеІпГ($. Ьгомзег. ѵегзіоп) < 4) { 

// Здесь обрабатывается гипотетическая ошибка в РігеГох... 

} 

}Оиегу.сопГаіпз() 

Эта функция принимает в аргументах два элемента документа. Она возвращает 
Ггііе, если первый элемент содержит второй, иначе возвращает значение Гаізе. 

]Оиегу.еасИ() 

В отличие от метода еасМ( ), который выполняет итерации только по объектам 
]0иегу, вспомогательная функция ]Оиегу.еасИ() способна выполнять итерации 
по элементам массива или свойствам объекта. В первом аргументе она прини¬ 
мает массив или объект, по которому выполняются итерации. Во втором аргу¬ 
менте принимается функция, которая должна быть вызвана для каждого эле¬ 
мента массива или свойства объекта. Этой функции передаются два аргумен¬ 
та: индекс элемента массива или имя свойства объекта и значение элемента 
массива или свойства объекта. Значение ссылки ГІііз в этой функции совпада¬ 
ет со значением второго аргумента. Если функция вернет Гаізе, ]0иегу.еас1і() 
сразу же вернет управление, не завершив итерации. Функция ^Оиегу.еасМ() 
всегда возвращает значение первого аргумента. 

Перечисление свойств функцией ]Оиегу.еасИ() выполняется в том же порядке, 
что и в обычном цикле Гог/іп, т.е. в итерациях участвуют все перечислимые 
свойства, включая унаследованные. Перечисление элементов массива функ- 
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цией ]0иегу.еас1і() выполняется в порядке следования их индексов, и она не 
пропускает неопределенные элементы в разреженных массивах. 

]0иегу.ех1іепсІ() 

Эта функция принимает объекты в своих аргументах. Она копирует свойства 
из второго и всех последующих объектов в первый объект, затирая все одно¬ 
именные свойства в первом объекте. Она пропускает все свойства, имеющие 
значение ипсІе'ГіпесІ или піііі. Если передать ей только один объект, свойства 
этого объекта будут скопированы в сам объект ^Оиегу. Возвращаемым значени¬ 
ем функции является объект, в который копировались свойства. Если в пер¬ 
вом аргументе передать значение Іігие, будет выполнено глубокое, или рекур¬ 
сивное, копирование: второй аргумент будет дополнен свойствами третьего 
(и всех последующих) объектов. 

Эту функцию удобно использовать для создания копий объектов и объедине¬ 
ния объектов с параметрами с настройками по умолчанию: 

ѵаг сіопе = ^Оиегу. ехі:епсІ( {}. огідіпаі); 

ѵаг орііопз = зОиегу .ех1:епсІ( {}. сІе?аи]Л_ор*іопз, іі5ег_ор1:іоп5); 

]0иегу.д1оЬа1Еѵа1() 

Эта функция выполняет строку с программным кодом на языке Лѵабсгірі 
в глобальном контексте, как если бы она была содержимым элемента <зсгіріі>. 
(В действительности эта функция создает элемент <зсгіріі> и временно встав¬ 
ляет его в документ.) 

:Оиегу.дгер() 

Эта функция похожа на метод Шііег() объекта Аггау, определяемый стандартом 
Е85. В первом аргументе она принимает массив, а во втором - функцию-преди¬ 
кат и вызывает эту функцию для каждого элемента массива, передавая ей зна¬ 
чение и индекс элемента. Функция ]Оиегу.дгер( ) возвращает новый массив, со¬ 
держащий только те элементы аргумента-массива, для которых функция-пре¬ 
дикат вернула значение Іігие (или другое значение, которое оценивается как ис¬ 
тинное). Если в третьем аргументе передать функции }Оиегу.дгер( ) значение Іігие, 
она будет инвертировать возвращаемое значение функции-предиката и вернет 
массив элементов, для которых функция-предикат вернула ложное значение. 

]Оиегу.іпАггау() 

Эта функция похожа на метод іпсІехСИЧ) объекта Аггау, определяемый стандар¬ 
том Е85. В первом аргументе она принимает произвольное значение, а во вто¬ 
ром - массив (или объект, подобный массиву) и возвращает индекс первого 
элемента в массиве, имеющего это значение, или -1, если указанное значение 
отсутствует в массиве. 

]Оиегу.ізАггау() 

Возвращает Іігие, если аргумент является объектом Аггау. 

}0иегу.ізЕтрі:у0Ь}ес1:() 

Возвращает Іігие, если аргумент не содержит перечислимых свойств. 

]0иегу.ізРипс1ііоп() 

Возвращает Іігие, если аргумент является объектом Рипсіііоп. Обратите внима¬ 
ние, что в ІЕ версии 8 и ниже такие методы, определяемые броузером, как 

1/\/іпсІом.а1ег1і() и Еіетепіі. а1і1іасИЕѵеп1і( ), не являются функциями в этом смысле. 
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]0иегу. ізР1аіпОЬ]ес1:( ) 

Возвращает Іігие, если аргумент является «простым* объектом, а не экземпля¬ 
ром некоторого более специализированного типа или класса объектов. 

]Оиегу.такеАггау() 

Если аргумент является объектом, подобным массиву, эта функция скопирует 
элементы из этого объекта в новый (истинный) массив и вернет этот массив. 
Если аргумент не является объектом, подобным массиву, эта функция просто 
вернет новый массив с аргументом в качестве единственного элемента. 

]0иегу.тар() 

Эта функция похожа на метод тар() объекта Аггау, определяемый стандартом 
Е85. В первом аргументе она принимает массив или объект, подобный масси¬ 
ву, а во втором - функцию. Она передает указанной функции значение и ин¬ 
декс каждого элемента массива и возвращает новый массив, содержащий зна¬ 
чения, возвращаемые функцией. ]0иегу.тар() имеет пару отличий от метода 
тар( ) в стандарте Е85. Если ваша функция отображения вернет пиіі, это значе¬ 
ние не будет включено в массив с результатами. И если ваша функция отобра¬ 
жения вернет массив, в результат будут добавлены элементы этого массива по 
отдельности, а не сам массив. 

]Оиегу.тегде() 

Эта функция принимает два массива или объекта, подобных массивам, добав¬ 
ляет элементы второго массива в первый и возвращает первый массив. Первый 
массив изменяется, а второй - нет. Обратите внимание, что эту функцию можно 
использовать для поверхностного копирования массивов, как показано ниже: 

ѵаг сіопе = іОііегу. тегде([], огідіпаі); 

]0иегу.рагзе^0М() 

Эта функция разбирает строку в формате ^(Ж и возвращает результат. Она 
возбуждает исключение, если в исходной строке будет обнаружена ошибка. 
Библиотека іСіиегу использует стандартную версию функции ^(ЖрагзеО, ес¬ 
ли она определена в броузере. Обратите внимание, что в библиотеке ](}иегу 
имеется только функция разбора строк в формате ^(Ж, но в ней отсутствует 
функция сериализации объектов в формат ^<Ж. 

]Оиегу.ргоху() 

Эта функция напоминает метод Ьіпс1() (раздел 8.7.4) объекта Рипс1:іоп, опреде¬ 
ляемый стандартом Е85. В первом аргументе она принимает функцию, а во 
втором - объект и возвращает новую функцию, которая вызывает оригиналь¬ 
ную как метод указанного объекта. Она не выполняет частичное применение 
аргументов, как метод Ьіпс1(). 

Функция ]Оиегу.ргоху() может также вызываться с объектом в первом аргу¬ 
менте и именем свойства во втором. Значение свойства с указанным именем 
должно быть функцией. В этом случае вызов функции ]Оиегу.ргоху(о,п) вернет 
то же, что и вызов ]Оиегу.ргоху(о[п],о). 

Функция ]Оиегу.ргоху() предназначена для использования с механизмом свя¬ 
зывания обработчиков событий в библиотеке і(}иегу. Если в качестве обработ¬ 
чика была связана функция, полученная с помощью ]0иегу. ргоху( ), то удалить 
ее можно, указав ее оригинал. 
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]0иегу.зиррог1: 

Это свойство подобно свойству ]Оиегу.Ьго\л/зег, но оно предназначено для пере¬ 
носимой проверки поддерживаемых возможностей (раздел 13.4.3) вместо иГе- 
нее надежного способа определения типа броузера. Значением свойства ]0иегу. 
зиррогі: является объект, все свойства которого имеют логические значения 
и определяют наличие или отсутствие поддержки различных возможностей 
броузеров. Большинство свойств объекта ]0иегу. зиррогі: содержат низкоуров¬ 
невую информацию, используемую внутренними механизмами библиотеки 
ІСІиегу. В основном они представляют интерес для разработчиков расширений 
и мало чем полезны прикладным программистам. Одно исключение - свойст¬ 
во ]0иегу.зиррогі:.ЬохМойеІ: оно имеет значение 1:гие, если броузер использует 
блочную модель «сопіехі-Ъох», соответствующую стандарту С88, и значение 
1"а1зе в ІБ6 и ІБ7, работающих в режиме совместимости (раздел 16.2.3.1). 

]Оиегу.і:гіт() 

Эта функция похожа на метод 1:гіт( ), добавленный в строки стандартом Е85. 
Она принимает единственный строковый аргумент и возвращает его копию, 
из которой удалены начальные и завершающие пробельные символы. 

19.8. Селекторы и методы выбора 
в библиотеке іОиегу 

На протяжении всей главы мы использовали функцию выбора $() из библиотеки 
ІСІиегу, применяя простые С88-селекторы. Теперь пришло время поближе позна¬ 
комиться с грамматикой селекторов і(}иегу, а также с некоторыми методами, по¬ 
зволяющими фильтровать и расширять множество выбранных элементов. 

19.8.1. Селекторы іОиегу 

Библиотека ](}иегу поддерживает достаточно полное подмножество селекторов, 
определяемых проектом стандарта «С883 Зеіесіогз», расширенное нестандарт¬ 
ными, но очень удобными псевдоклассами. Основы С88-селекторов обсуждались 
в разделе 15.2.5. Здесь мы продолжим это обсуждение и дополнительно познако¬ 
мимся с более сложными селекторами. Имейте в виду, что в этом разделе описы¬ 
ваются селекторы, реализованные в библиотеке і(}иегу. Многие из них могут ис¬ 
пользоваться в таблицах стилей С88, но не все. 

Грамматика селекторов делится на три уровня. Вы наверняка уже встречались 
с простейшими видами селекторов ранее. Селектор «#1ез1» выбирает элемент 
с атрибутом і Р, имеющим значение «іезі». Селектор «Ыоскциоіе» выбирает все 
элементы <Ыоскрио1:е> в документе, а селектор «біѵ.поіе» выбирает все элементы 
<с!іѵ> с атрибутом сіазз, имеющим значение «поіе». Простые селекторы можно 
объединять в «комбинированные селекторы», такие как «(Иѵ.поіе>р» и «Ыоск- 
циоіе Ь, отделяя их символом-комбинатором. И простые, и комбинированные се¬ 
лекторы можно группировать в списки, отделяя их точкой с запятой. Такие груп¬ 
пы селекторов являются наиболее универсальной разновидностью селекторов, 
обычно передаваемых функции $(). Прежде чем перейти к обсуждению комбини¬ 
рованных селекторов и групп селекторов, необходимо познакомиться с синтакси¬ 
сом простых селекторов. 




614 


Глава 19. Библиотека Юиегу 


19.8.1.1. Простые селекторы 

Простой селектор начинается (явно или неявно) с имени тега. Если, к примеру* 
интерес представляют только элементы <р>, простой селектор должен начинаться 
с «р». Если требуется выбрать элементы независимо от имени тега, используется 
шаблонный символ «*». Если селектор не начинается с имени тега или шаблонно* 
го символа, подразумевается присутствие шаблонного символа. 

Имя тега или шаблонный символ определяют начальное множество элементов до¬ 
кумента, кандидатов на выбор. Фрагмент селектора, следующий за определением 
имени тега, состоит из нуля или более фильтров. Фильтры применяются слева 
направо, в порядке их следования, и каждый из них сужает множество выбран¬ 
ных элементов. Фильтры, поддерживаемые библиотекой іСЗиегу, см. в табл. 19.1. 

Обратите внимание, что некоторые из фильтров, перечисленных в табл. 19.1, при¬ 
нимают аргументы в круглых скобках. Следующий селектор, например, выберет 
абзацы, которые являются первыми или каждыми третьими дочерними элемен¬ 
тами своих родителей при условии, что они содержат слово ♦ ^ѵабсгірі» и не со¬ 
держат элемент <а>. 

р: піііі-сі'ііісКЗп+і ) :1:ех1:иаѵаЗсгірі:) :по*(:Иаз(а)) 

Обычно фильтры действуют более эффективно, если им предшествует имя тега. 
Например, вместо использования простого фильтра «ігасііо» для выбора радиокно¬ 
пок лучше использовать селектор «іприіігабіо». Исключение составляют фильт¬ 
ры, проверяющие значение атрибута ісі, которые наиболее эффективно действуют, 
когда они употребляются автономно. Например, селектор «#ас1с1ге88» обычно дей¬ 
ствует эффективнее, чем более явный селектор «іогт#ас1с1ге88». 

Таблица 19.1. Фильтры селекторов, поддерживаемые библиотекой 'фиегу 


Фильтр 


Описание 


ЯМ 


Соответствует элементам с атрибутом ісі, имеющим значение іб. Допусти¬ 
мые НТМЬ-документы никогда не имеют более одного элемента с одним 
и тем же значением в атрибуте ісі, поэтому этот фильтр обычно использу¬ 
ется как самостоятельный селектор. 


.сіазз 


Соответствует элементам с атрибутом сіазз, значение которого (интерпре¬ 
тируется как список слов, разделенных пробелами) включает слово сіазз. 


[ап г] 


Соответствует элементам, имеющим атрибут аПг (независимо от значения). 


[ апг-ѵаі ] 


Соответствует элементам, имеющим атрибут аПг со значением ѵаі. 


[аПг\=ѵа1] 


Соответствует элементам, не имеющим атрибут аПг 9 или элементам с ат¬ 
рибутом ап г , значение которого не равно ѵаі (расширение іС^иегу). 


[ аПг~=ѵа1 ] 


Соответствует элементам с атрибутом аХХг 9 значение которого начинается 
с ѵаі. 


[аХХг$=ѵа1] 


Соответствует элементам с атрибутом аХХг 9 значение которого оканчивает¬ 
ся на ѵаі. 


[аХХг*=ѵа1] 

[аПг~=ѵа1] 


Соответствует элементам с атрибутом аХХг 9 значение которого содержит ѵаі. 

Соответствует элементам с атрибутом аХХг 9 когда элемент, интерпретируе¬ 
мый как список слов, разделенных пробелами, содержит слово ѵаі. То 
есть селектор «<Ііѵ.поіе» - это то же самое, что и «<Ііѵ[с1а88~=поіе]*. 
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Фильтр 

[ аі1:г\=ѵа1 ] 

:апіта1:ес1 

:ЬііТ*оп 

хІіескЬох 

:с!іескес1 

:соп1:аіП5(ТехО 


ісІізаЫесІ 

:етр1:у 

:епаЫес1 

:ес\(п) 

:еѵеп 

:Ше 

:?ігзТ 

:?ІГ5Т-СІ1ІІСІ 

:д ип) 

:Ііаз(5еі) 
:Ііеас1ег 
: Місісіеп 
:ітаде 
: іприі: 


Описание _ 

Соответствует элементам с атрибутом аііг, значение которого начинается 
с ѵаі и, возможно, следующим за ним дефисом и любыми другими симво¬ 
лами. 

Соответствует элементам, к которым в настоящее время применяется ани¬ 
мационный эффект ІСіиегу. 

Соответствует элементам <ЬііТТоп Туре="ЬиТТоп"> и <іпри1: Туре="ЬиІІоп"> 
(расширение іСіиегу). 

Соответствует элементам <іпри1: Туре =, 'сІіескЬох "> (расширение іСіиегу). Эф¬ 
фективнее всего использовать этот фильтр с именем тега іприі:: «іп- 
риіісЬескЪох». 

Соответствует отмеченным элементам ввода. 

Соответствует элементам, содержащим указанный текст іехі (расширение 
ІСіиегу). Текст в этом фильтре ограничивают круглые скобки, т. е. кавыч¬ 
ки здесь не нужны. Текстовое содержимое элементов проверяется этим 
фильтром по значениям их свойств ТехТСопТепІ: и іппегТехІ:; это простой, не¬ 
обработанный текст документа, из которого исключены теги и коммента¬ 
рии. 

Соответствует элементам в запрещенном состоянии. 

Соответствует элементам, не имеющим потомков, в том числе текстовых 
узлов. 

Соответствует элементам в незапрещенном состоянии. 

Соответствует только п -му элементу в списке совпадений, расположенных 
в порядке следования в документе, отсчет в котором начинается с нуля 
(расширение іСіиегу). 

Соответствует элементам с четными индексами в списке. Поскольку пер¬ 
вый элемент имеет индекс 0, фактически этот фильтр соответствует перво¬ 
му, третьему, пятому (и так далее) элементам (расширение іСіиегу). 

Соответствует элементам <іпри1: іуре= Ті1е"> (расширение іСіиегу). 

Соответствует только первому элементу в списке. То же, что и :ед(0) (рас¬ 
ширение іСіиегу). 

Соответствует только элементам, которые являются первыми дочерними 
элементами своих родителей. Обратите внимание, что этот фильтр полно¬ 
стью отличается от фильтра :?ігзі. 

Соответствует элементам в списке совпадений, расположенным в порядке 
следования в документе, отсчет в котором начинается с нуля, чей индекс 
больше значения п (расширение ІСіиегу). 

Соответствует элементам, имеющим потомков, соответствующих селекто¬ 
ру зеі. 

Соответствует любым элементам-заголовкам: <М>, <1і2>, <МЗ>, <М4>, <Гі5> или 
<Іі6> (расширение іСіиегу). 

Соответствует всем невидимым на экране элементам, т. е. элементам, зна¬ 
чения свойств о^зеШЖІі и о^ТзеТНеідІіТ которых равны 0. 

Соответствует элементам <іпри1: іуре="ітаде">. Обратите внимание, что 
этот фильтр не соответствует элементам <ітд> (расширение ІСіиегу). 

Соответствует элементам ввода: <іпри1:>, <іех1:агеа>, <зе1ес1:> и <Ьи1:1:оп> (рас¬ 
ширение іСіиегу). 
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Фильтр 

:1аз1: 

іІазТ-сШсІ 

:Щп) 

:г\оХ(зе1) 

:г)ХЬ(п) 

:п1:И-сГіі1с1(п) 


:ос!с1 

:оп1у-сГіі1с! 

: рагепі: 

:разз\л/огсІ 
: гасііо 
:гезе1: 

:зе1ес1:ес1 

: зиЬшіІ: 

:ТехТ 

:ѵізіЫе 


Таблица 19.1 (продолжение) 

Описание _'_ 

Соответствует последнему элементу в списке совпадений (расширение і(}ие- 
гу). 

Соответствует всем элементам, которые являются последними дочерними 
элементами своих родителей. Обратите внимание, что этот фильтр полно¬ 
стью отличается от фильтра :1аз1:. 

Соответствует элементам в списке совпадений, расположенным в порядке 
следования в документе, отсчет в котором начинается с нуля, чей индекс 
меньше значения п (расширение іС^иегу). 

Соответствует элементам, которые не соответствуют селектору зеі. 
Синоним фильтра :ец(п) (расширение іС^иегу). 

Соответствует элементам, которые являются п-ми дочерними элементами 
своих родителей, п может быть числом, словом «еѵеп*, словом «оск1» или 
формулой. Для выбора второго, четвертого (и так далее) элементов в спи¬ 
сках дочерних элементов их родителей можно использовать фильтр :пііі- 
сИіІсі(еѵеп). Для выбора первого, третьего (и так далее) элементов можно 
использовать фильтр :Ш:И-сИі1с1(ос1с1). 

В самом общем случае п может быть формулой вида хп или хл+у, где х и у яв¬ 
ляются целыми числами, а п - символом п. То есть фильтр ггЫі-сііі1сі(Зп+1) 
выберет первый, четвертый, седьмой (и так далее) элементы. 

Обратите внимание, что отсчет индексов в этом фильтре ведется с едини¬ 
цы, поэтому индекс первого дочернего элемента его родителя считается не¬ 
четным и он соответствует формуле Зп+1, но не соответствует формуле Зп. 
Сравните этот фильтр с фильтрами :еѵеп и : осісі, которые начинают отсчет 
элементов в списке совпадений с нуля. 

Соответствует элементам с нечетными индексами в списке (отсчет начина¬ 
ется с нуля). Обратите внимание, что элементы с индексами 1 и 3 являют¬ 
ся вторым и четвертым элементами, соответственно (расширение іС^иегу). 

Соответствует элементам, являющимся единственными дочерними эле¬ 
ментами своих родителей. 

Соответствует элементам, которые являются родителями. Этот фильтр яв¬ 
ляется обратным по отношению к фильтру :етр1у (расширение іС^иегу). 

Соответствует элементам <іпри1: 1:уре="ра55\л/огсі"> (расширение і(}иегу). 

Соответствует элементам сіпрыі: 1:уре="гасііо"> (расширение іСіиегу). 

Соответствует элементам сіпрыі: 1:уре="гезе1:"> и сЬііІІіоп 1уре="гезе1: '> (рас¬ 
ширение і(}иегу). 

Соответствует элементам <ор1:іоп>, которые были отмечены. Для выбора от¬ 
меченных флажков и переключателей (радиокнопок) используйте фильтр 
хііескесі (расширение іС^иегу). 

Соответствует элементам <іпри1: 1: уре="зиЬті1:" > и <Ьы1:1:оп 1:уре= "зиЬті1:"> 

(расширение іС^иегу). 

Соответствует элементам <іпри1: {уре="*ех*"> (расширение і(}иегу). 

Соответствует всем элементам, которые видимы в текущий момент, т. е. 
элементам, свойства оГГзеІМісііГі и о^зе1:НеідІіІ которых не равны нулю. 
Этот фильтр является обратным по отношению к фильтру :Ііісісіеп. 
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19.8.1.2. Комбинированные селекторы 

Простые селекторы могут объединяться с использованием специальных операто¬ 
ров, или «комбинаторов», для представления отношений между элементами в де¬ 
реве документа. В табл. 19.2 перечислены комбинированные селекторы, поддер¬ 
живаемые библиотекой ](}иегу. Эти же комбинированные селекторы поддержи¬ 
ваются стандартом С883. 

Ниже приводится несколько примеров комбинированных селекторов: 

"Ыоскдіюііе і" // Соответствует элементу <і> в элементе <Ыоскдію1:е> 

"оі > 1і" // Элемент <1і>, прямой потомок элемента <о1> 

"#ои*ріЦ + *" // Братские элементы, следующие за элементом с іс!="ои1:ри1:" 

"сііѵ.поііе > М + р" // Элемент <р>, следующий за <М> в <с!іѵ с1а55="по1іе"> 

Обратите внимание, что комбинированные селекторы не ограничены комбинация¬ 
ми из двух селекторов: допустимыми являются также комбинации из трех и более 
селекторов. Обработка комбинированных селекторов выполняется слева направо. 

Таблица 19.2. Комбинированные селекторы, поддерживаемые библиотекой іЯиегу 


Комбинирован¬ 
ный селектор 

Описание 

А В 

Выбирает элементы документа, которые соответствуют селектору В и яв¬ 
ляются потомками элементов, соответствующих селектору А. Обратите 
внимание, что здесь символом-комбинатором является простой пробел. 

А > В 

Выбирает элементы документа, которые соответствуют селектору В 
и являются непосредственными потомками элементов, соответствую¬ 
щих селектору А. 

А + В 

Выбирает элементы документа, которые соответствуют селектору В 
и следуют непосредственно за элементами, соответствующими селекто¬ 
ру А (текстовые узлы и комментарии в учет не принимаются). 

А " В 

Выбирает элементы документа, которые соответствуют селектору В 
и являются братскими для элементов, соответствующих селектору А. 


19.8.1.3. Группы селекторов 

Группа селекторов, которая является разновидностью селекторов, передаваемых 
функции $() (или используемых в таблицах стилей), - это просто список простых 
или комбинированных селекторов, разделенных запятыми. Группе селекторов 
соответствуют все элементы, которые соответствуют любому из комбинирован¬ 
ных селекторов в группе. С позиции нашего обсуждения даже простой селектор 
можно рассматривать как комбинированный. Ниже приводится несколько при¬ 
меров групп селекторов: 

"М, Іі2, М3" // Соответствует элементам <М>, <М2> и <МЗ> 

"#р1, #р2, ирЗ” // Соответствует элементам с ісі, равным рі, р2 и рЗ 

"сііѵ.поііе, р.поіе" // Соответствует элементам <с!іѵ> и <р> с с1а$$="по1:е" 

"Ьос1у>р, сііѵ. по1:е>р" // <р>, вложенный в <Ьос1у>, и <с!іѵ с1аз$="по1:е"> 

Обратите внимание, что синтаксис селекторов С88 и іС^иегу позволяет использо¬ 
вать круглые скобки в некоторых фильтрах в простых селекторах, но не допускает 
более обобщенного их использования для группировки селекторов. Нельзя по- 
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местить группу селекторов или комбинированный селектор в скобки и интерпре¬ 
тировать их как простой селектор, например: 

(М, П2, ИЗ )+р // Недопустимо 

М+р, П2+р, НЗ+р // Следует использовать этот вариант 


19.8.2. Методы выбора 


В дополнение к грамматике селекторов, поддерживаемой функцией $(), библио¬ 
тека іСіиегу определяет несколько методов выбора. Большинство методов из биб¬ 
лиотеки іС^иегу, с которыми мы встречались в этой главе до сих пор, выполняют 
некоторые операции над выбранными элементами. Методы выбора отличаются 
от них: они изменяют множество выбранных элементов, фильтруя, расширяя 
или используя его в качестве отправной точки для нового выбора. 

В данном разделе описываются эти методы выбора. Здесь вы увидите, что многие 
методы реализуют те же функциональные возможности, которые обеспечивает 
грамматика селекторов. 

Самой простой является операция фильтрации выбора по позициям элементов 
в выбранном множестве. Метод ГігзШ возвращает объект ]0ііегу, содержащий 
только первый выбранный элемент, а метод ІазШ возвращает объект ]0иегу, со¬ 
держащий только последний выбранный элемент. Более обобщенный метод еч() 
возвращает объект ]0ііегу, содержащий единственный выбранный элемент с ука¬ 
занным индексом. (В версии і(}иегу 1.4 допускается использовать отрицательные 
индексы, в этом случае отсчет начинается с конца выбранного множества.) Обра¬ 
тите внимание, что эти методы возвращают объект ]0иегу с единственным эле¬ 
ментом, что отличает их от обычной операции индексирования массива, которая 
возвращает единственный элемент без объекта ]0иегу, обертывающего его: 


ѵаг рагаз = $("р"); 
рагаз. ?ігз*( ) 
рагаз. 1аз1:() 
рагаз.ец(1) 
рагаз.ец(-2) 
рагаз[1] 


// Выберет только первый элемент <р> 

// Выберет только последний элемент <р> 
// Выберет второй элемент <р> 

// Выберет второй с конца элемент <р> 

// Сам второй элемент <р> 


Универсальным методом фильтрации выбора по позиции является метод з1ісе(). 
Этот метод действует подобно методу Аггау. 5Іісе( ): он принимает начальный и ко¬ 
нечный индексы (отрицательные индексы откладываются от конца массива) 
и возвращает объект ]0иегу, содержащий элементы с индексами от начального до 
конечного, не включая его. Если конечный индекс не указан, возвращаемый объ¬ 
ект будет содержать все элементы от начального индекса и до конца: 

$("р"). з1ісе(2, 5) // Выберет 3-й, 4-й и 5-й элементы <р> 

$( "сііѵ" ). зІісе(-З) // Последние три элемента <с!іѵ> 


Метод ГШегО является универсальным методом фильтрации и может использо¬ 
ваться тремя разными способами: 

• Если передать методу Г і Не г () строку с селектором, он вернет объект ] Оие гу, со¬ 
держащий только те из выбранных элементов, которые соответствуют этому 
селектору. 

• Если передать методу ГШег() другой объект ]0ііегу, он вернет новый объект 
]0иегу, содержащий пересечение множеств элементов в двух исходных объек- 
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тах ]0иегу. Методу можно также передать массив элементов и даже единствен¬ 
ный элемент документа. 

• Если передать методу 1"Шег( ) функцию-предикат, эта функция будет вызвана 
для каждого выбранного элемента и метод ^і11:ег( ) вернет объект ]0ііегу, содер¬ 
жащий только те элементы, для которых функция-предикат вернет іхііе (или 
любое другое истинное значение). Элемент будет передан функции в виде зна¬ 
чения ссылки Шз, а индекс элемента - в виде аргумента. (Смотрите также 
описание метода ]Оиегу.дгер() в разделе 19.7.) 

$("с!іѵ"). ШііегС'.поІе") // Аналогично $("с1іѵ.поіе") 

$("с!іѵ").'Шіег($(".поІе")) //Аналогично $("с!іѵ. поіе") 

ЗС'сИѵ"). Шіег^ііпсІііопЦсІх) { геішгп іс!х%2==0 }) // Аналогично $("с1іѵ:еѵеп") 

Метод поШ действует точно так же, как метод ^Шег(), за исключением того, что 
он инвертирует значение фильтра. Если передать методу поШ строку с селекто¬ 
ром, он вернет новый объект зОцегу, содержащий только те из выбранных элемен¬ 
тов, которые не соответствуют селектору. Если передать методу по!() объект 
]0иегу, массив элементов или единственный элемент, он вернет все выбранные эле¬ 
менты, кроме тех, что были явно указаны. Если передать методу поШ функцию- 
предикат, он вызовет ее для каждого выбранного элемента, как и метод Ш1:ег(), 
но вернет объект ^Оііегу, содержащий только те выбранные элементы, для кото¬ 
рых функция возвратит 1"а1зе или любое другое ложное значение: 

$("с!іѵ"). по1:("#Ііеас1ег, й^ооіег"); // Все элементы <сііѵ>, кроме двух указанных 

В версии іСіиегу 1.4 имеется метод Раз(), обеспечивающий еще один способ фильт¬ 
рации выбора. Если ему передать селектор, он вернет новый объект ]0ііегу, содер¬ 
жащий только те из выбранных элементов, которые имеют потомков, соответст¬ 
вующих селектору. Если передать методу Раз() элемент документа, он вернет толь¬ 
ко те выбранные элементы, которые являются предками указанного элемента: 

$(”р"). Маз("а[Мге^]*') // Абзацы, включающие ссылки 

Метод аРсК) не фильтрует и не сужает выбор, а расширяет его. Метод аРР() можно 
вызывать с любыми аргументами (кроме функций), которые можно передавать 
функции $(). Он возвращает первоначальное множество выбранных элементов, 
плюс элементы, которые были бы выбраны (или созданы) при передаче этих же 
аргументов функции $(). Метод аРР() удаляет повторные вхождения элементов 
и сортирует элементы в порядке их следования в документе: 

// Эквивалентные способы выбора всех элементов <Ріѵ> и <р> 

$("Ріѵ. р") // Используется группа селекторов 

$("Ріѵ").аРР("р") // Передать методу ас1сІ() селектор 

$( " сііѵ" ).ас!с1($("р")) // Передать методу асІсІО объект іОііегу 

ѵаг рагаз = сіоситепі: .де1:Е1ешеп1:зВуТадМате(“р"); // Объект, подобный массиву 

$("с!іѵ').асісі(рагаз); // Передать методу асІсІО массив элементов 

19.8.2.1. Использование результатов выбора 
в качестве контекста 

Методы Ш1:ег(), асісі( ) и поШ, описанные выше, возвращают пересечение, объеди¬ 
нение и разность независимых множеств выбранных элементов. Библиотека 
ІСІиегу определяет также несколько других методов выбора, которые используют 
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текущее множество выбранных элементов в качестве контекста. Для каждого вы¬ 
бранного элемента эти методы создают новое множество, используя выбранный 
элемент в качестве контекста, или отправной точки, и возвращают новый объект 
]0иегу, содержащий объединение этих множеств. Как и метод асЮ(), эти методы 
удаляют повторные вхождения одних и тех же элементов и сортируют их в по¬ 
рядке следования в документе. 

Наиболее универсальным в этой категории методов выбора является метод ГіпсІ( ). 
Он выполняет поиск потомков в каждом выбранном элементе, соответствующих 
указанной строке селектора, и возвращает новый объект ]0ііегу, представляю¬ 
щий новое множество соответствующих потомков. Обратите внимание, что вновь 
выбранные элементы не объединяются с существующим множеством - они воз¬ 
вращаются в виде нового множества элементов. Отметьте также, что метод 1 = іпс1( ) 
отличается от метода ^Шег(), который просто сужает текущее множество вы¬ 
бранных элементов, не добавляя новых: 

$(”СІІѴ"). ГіпсІС'р”) // Отыскать элементы <р> в <с!іѵ>. То же, что и $(' с!іѵ р") 

Другие методы из этой категории возвращают новые объекты ]0иегу, представ¬ 
ляющие дочерние, братские или родительские элементы для каждого выбранно¬ 
го элемента. Чаще всего им передается необязательный строковый аргумент с се¬ 
лектором. При вызове без селектора они возвращают, соответственно, все дочер¬ 
ние, братские или родительские элементы. При вызове с селектором они фильт¬ 
руют список и возвращают только элементы, соответствующие селектору. 

Метод сМі1с!геп( ) возвращает дочерние элементы каждого выбранного элемента, 
фильтруя результат с применением необязательного селектора: 

// Отыскать все элементы <зрап>, которые являются дочерними для элементов 
// с ісІ="Реас1ег" и іс!="Гооіе г". Тот же результат дает вызов 
// $("#Ііеас1ег>5рап І й^ооТег^рагГ) 

$("#Реас1ег, «Тооіег" ). сШсІгеп( "зрап") 

Метод сопТепТзО действует так же, как метод сШс1геп(), но возвращает все дочер¬ 
ние узлы, включая текстовые, каждого выбранного элемента. Кроме того, для эле¬ 
ментов <іТгате> метод сопііепТзО возвращает объект Боситепі: с содержимым этого 
элемента. Обратите внимание, что метод сопТепТзО не принимает необязательный 
строковый аргумент с селектором - это обусловлено тем, что он возвращает объек¬ 
ты Ооситепі:, не являющиеся элементами, а селекторы позволяют описывать толь¬ 
ко элементы. 

Методы пех1:() и ргеѵ() возвращают следующий и предыдущий братский элемент 
для каждого выбранного элемента, если они имеются. Если методу передать се¬ 
лектор, выбраны будут только братские узлы, соответствующие селектору: 

$("Ы '). пехі: ( "р") // То же, что и $(”М+р") 

$("М"). ргеѵ( ) // Братские элементы перед элементами <М> 

Методы пехТА11() и ргеѵА11() возвращают все следующие и предыдущие братские 
элементы (если имеются) для каждого выбранного элемента. А метод зіЫіпдз() 
возвращает все братские элементы для каждого выбранного элемента (элементы 
не считаются братскими по отношению к самим себе). Если любому из этих мето¬ 
дов передать селектор, выбраны будут только братские узлы, соответствующие 
селектору: 
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$("Яі'ооіег"). пехТАПС'р'' ) // Все братские элементы <р>, следующие за йі'ооіег 

$("#^ооТег").ргеѵА11() // Все братские элементы, предшествующие йТооТег 

В версии і(}иегу 1.4 и выше методы пех*ІМі1() и ргеѵІІпШО принимают аргумент 
с селектором и выбирают все братские элементы, следующие за выбранным эле¬ 
ментом или предшествующие ему, пока не будет встречен братский элемент, соот¬ 
ветствующий селектору. При вызове без селектора они действуют точно так же, 
как методы пехі:А11() и ргеѵА11() при вызове их без селектора. 

Метод рагеп1:() возвращает родителя для каждого выбранного элемента: 

$("1і").рагеп1:( ) // Родители элементов списка, такие как <іі1> и <о1> 

Метод рагеггЕзО возвращает предков (вплоть до элемента <М1:т1>) для каждого вы¬ 
бранного элемента. Оба метода, рагепі;() и рагегѵЕзО, принимают необязательный 
строковый аргумент с селектором: 

$("а[И геі 3 ]”). рагепТзС'р") // Элементы <р>, содержащие ссылки 

Метод рагепі:5ІІпі;і1() выбирает предков для каждого выбранного элемента, пока 
не будет встречен первый предок, соответствующий указанному селектору. Ме¬ 
тод с1озе5І:() принимает обязательный строковый аргумент с селектором и воз¬ 
вращает ближайшего предка (если имеется) для каждого выбранного элемента, 
соответствующего селектору. Этот метод рассматривает элементы как предки са¬ 
мим себе. В версии і(}иегу 1.4 методу сІозезШ можно также передать второй не¬ 
обязательный аргумент, чтобы не дать библиотеке іС^иегу подняться по дереву 
предков выше указанного в этом аргументе элемента: 

$( "а[Иге^]").с1озезІ("с1іѵ") // Самые внутренние элементы <с!іѵ>, содержащие ссылки 
$("а[Ііге^]"). рагепІзІІпіііИ" : поі: ( сііѵ) ") // Все элементы <сИѵ>, непосредственно 

// обертывающие элементы <а> 

19.8.2.2. Возврат к предыдущему выбору 

Чтобы обеспечить возможность составления цепочек вызовов методов, большин¬ 
ство методов объекта ]0иегу возвращают объект, относительно которого они вы¬ 
зываются. Однако все методы, которые рассматривались в этом разделе, возвра¬ 
щают новые объекты ]0иегу. Они также могут включаться в цепочку вызовов, но 
вы должны иметь в виду, что методы, вызываемые в цепочке вслед за ними, будут 
оперировать другим множеством элементов, отличным от того, которое использо¬ 
валось в начале цепочки. 

Однако на самом деле ситуация несколько сложнее. Когда методы выбора, опи¬ 
санные здесь, создают и возвращают новый объект ]0ііегу, они сохраняют в нем 
ссылку на прежний объект зОшегу, на основе которого был порожден новый объ¬ 
ект. В результате создается список, или стек объектов ]0ііегу. Метод епс!() вытал¬ 
кивает объект на вершине этого стека и возвращает сохраненный объект ]0иегу. 
Вызов метода епс!() в цепочке восстанавливает множество выбранных элементов 
в предыдущее состояние. Взгляните на следующий фрагмент: 

// Отыскать все элементы <сИѵ>, затем внутри множества выбранных элементов отыскать 
// элементы <р>. Выделить элементы <р> цветом и затем окружить рамками элементы <с!іѵ>. 

// Сначала рассмотрим, как это сделать без цепочек вызовов методов 

ѵаг сііѵз = $( "сііѵ" ); 

ѵаг рагаз = сііѵз. Ппс1("р"); 
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рагаз. асЗсІСІаззС “ІіідІіІідІіТ; "); 
сііѵз.сззС "Ьогсіег", "зоШ Ыаск Ірх"); 

// А теперь то же самое, составив цепочку вызовов методов 

$("с!іѵ"). ^іпсІ( ”р** ).асЗсІС1азз("ГіідГі1ідГіТ;").епсІ().сзз("Ьогсіег”. "зоіісі Ыаск Ірх "); 

// То же самое можно реализовать без вызова метода епсК), просто переупорядочив операции 
$(’ сііѵ").сзз( "Ьогсіег”, "зоіісі Ыаск Ірх"). ГіпР("р").асІсІС1а55("ЫдЫідЫ"); 

Если вам когда-нибудь потребуется вручную определить множество выбранных 
элементов и обеспечить его совместимость с методом епсІ(), передайте новое мно¬ 
жество элементов в виде массива или в виде объекта, подобного массиву, методу 
ріі5ЬЗі:аск(). Указанные элементы будут преобразованы в новое множество вы¬ 
бранных элементов, а предыдущее множество будет помещено в стек, откуда его 
можно будет извлечь вызовом метода епсІ( ): 

ѵаг зеі = $( "сііѵ” ); // Выбрать все <Ьіѵ> 

зеі . ризГі5і:аск(сіоситепі:. деТ;Е1етепТ;5ВуТадМате("р”)); // Заменить его множеством 

// всех элементов <р> 

зеІ.епсК); // Восстановить множество элементов <с!іѵ> 

Теперь, когда мы познакомились с методом епсі() и со стеком, хранящим множе¬ 
ства выбранных элементов, нам осталось познакомиться с еще одним методом. 
Метод апсІЗеІІЧ) возвращает новый объект ]0иегу, включающий все элементы из 
текущего множества выбранных элементов плюс все элементы (за исключением 
дубликатов) из предыдущего множества. Метод апсІЗеІІЧ) действует подобно мето¬ 
ду асісІ() и для него больше подошло бы имя «асІсІРгеѵ». В качестве примера рас¬ 
смотрим следующий вариант реализации предыдущего примера: он выделяет 
цветом элементы <р> и вмещающие их элементы <сііѵ> и затем добавляет рамки 
к элементам <с!іѵ>: 

$( "сііѵ” ). ГіпсІ("р "). апсІЗе1Г( ). // Отыскать <р> в <сЗіѵ> и объединить их 

асЮСІаззС ЫдЫідЫ"). // Выделить их все цветом 

епсЗ(). епсі (). // Вытолкнуть со стека дважды до $( "сііѵ" ) 

сзз( "Ьогсіег", "зоіісі Ыаск Ірх"); // Добавить рамки к элементам <сЗіѵ> 

19.9. Расширение библиотеки іОиегу 
с помощью модулей расширений 

Библиотека ]0иегу написана так, что позволяет легко добавлять в нее новые функ¬ 
циональные возможности. Модули, добавляющие новые функциональные возмож¬ 
ности, называются расширениями (ріид-іп), большое количество которых можно 
отыскать на сайте Нир://рІи§іп8^иегу.сот . Расширения для библиотеки іСІиегу 
являются обычными файлами с программным кодом на языке ^ѵаЗсгірі, и, что¬ 
бы задействовать их в своих веб-страницах, достаточно просто подключить их 
с помощью элемента <зсгірі:>, как любую другую библиотеку на языке ^ѵаЗсгірі 
(разумеется, расширения должны подключаться после подключения самой биб¬ 
лиотеки іСіиегу). 

Создание собственных расширений для библиотеки іСіиегу является почти три¬ 
виальной задачей. Вся хитрость заключается в объекте-прототипе зОиегу.'Рп, ко¬ 
торый является прототипом для всех объектов ]0иегу. Если добавить новую функ¬ 
цию в этот объект, она превратится в метод объекта ]0иегу. Например: 
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^Оііегу. Гп. ргіпііп = ^ыпсііопО { 

// Объединить все аргументы в одну строку, разделив их пробелами 
ѵаг тзд = Аггау. ргоііоііуре. ;іоіп.са11(агдіітепі:5, " "); 

// Обойти в цикле все элементы в объекте ^Оііегу 
іііііз . еасМ( ^ипсіііоп () { 

// В конец каждого из них добавить строку с простым текстом и <Ьг/>. 

]0цегу(Шз). аррепсКсІосіітепІ: . сгеа1:еТех1:Ыос1е(т5д)). аррепсК "<Ьг/>"); 

}): 

// Вернуть объект ^Оцегу, чтобы обеспечить возможность составления цепочек 
геіііігп Шз; 

}; 

Определив эту функцию ^Оиегу.-Гп. ргіпіііп, мы получаем возможность вызывать 
метод ргіпі:1п() относительно любого объекта ]0иегу, как показано ниже: 

$( "йсІеЬид" ). ргіп1:1п("х = ”, х, у = ", у); 

В ]0иегу.-Гп постоянно добавляются новые методы. Если обнаружится, что прихо¬ 
дится «вручную» выполнять обход элементов в объекте іСіиегу с помощью метода 
еасИ() и выполнять над ними некоторые операции, - это повод задуматься о необ¬ 
ходимости реструктуризации программного кода, чтобы переместить вызов ме¬ 
тода еасИ() в дополнительный метод. Если при создании такого метода следовать 
приемам модульного программирования и соблюдать некоторые соглашения, 
принятые в библиотеке іСіиегу, этот дополнительный метод можно назвать рас¬ 
ширением и поделиться им с другими. Ниже приводится перечень соглашений, 
которым необходимо следовать при создании расширений для библиотеки іС^иегу: 

• Не полагайтесь на идентификатор $: подключающая страница может вызы¬ 
вать функцию ]0иегу. поСопИісІ( ), после чего $() уже не будет синонимом функ¬ 
ции ]0иегу(). В коротких расширениях, как в примере выше, можно просто 
использовать имя ]0иегу вместо $. Если вы создаете большое расширение, то 
вы наверняка обернете его единственной анонимной функцией, чтобы избе¬ 
жать создания глобальных переменных. В этом случае можно использовать 
распространенный прием передачи ссылки на функцию іОиегу в виде аргумен¬ 
та и принимать это значение в параметре с именем $: 

( ^ыпсі:іоп ($) { // Анонимная функция с одним параметром $ 

// Здесь находится реализация расширения 
КіОііегу)); // Вызвать функцию с объектом ^Оііегу в виде аргумента 

• Если метод расширения не должен возвращать какое-то свое значение, он дол¬ 
жен возвращать объект ]0иегу, чтобы этот метод можно было использовать в це¬ 
почках вызовов. Обычно этот объект передается методам в виде ссылки Шз, 
которую можно просто вернуть вызывающей программе. Метод в примере вы¬ 
ше завершается строкой геііигп Шз;. Некоторые методы можно немного сокра¬ 
тить (и сделать их сложнее для понимания), используя еще один распростра¬ 
ненный прием: возвращая результат метода еасП(). Например, метод ргіпіі1п() 
мог бы содержать программный код геііигп Шз.еас['і(1 : ипс1:іоп() {...}); 

• Если метод расширения принимает более двух параметров или параметров 
настройки, дайте пользователю метода передавать параметры в форме объек¬ 
та (как мы видели на примере метода апітаІе() в разделе 19.5.2 и функции 
]0иегу.а]ах() в разделе 19.6.3). 
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• Не засоряйте пространство имен іСіиегу лишними методами. Правильно оформ¬ 
ленные расширения для библиотеки іСіиегу определяют минимальное количе¬ 
ство методов, образуя непротиворечивый и удобный прикладной интерфейс. 
Обычно расширения іСіиегу определяют в объекте ]0иегу.Гп единственный ме¬ 
тод. Этот метод принимает в первом аргументе строку и интерпретирует ее как 
имя функции, которой следует передать остальные аргументы. Если расшире¬ 
ние определяет единственный метод, его имя должно совпадать с именем рас¬ 
ширения. Если необходимо определить более одного метода, в именах методов 
следует использовать имя расширения в качестве префикса. 

• Если расширение привязывает обработчики событий, их следует поместить 
в пространство имен событий (раздел 19.4.4). В качестве имени пространства 
имен следует использовать имя расширения. 

• Если расширение использует метод с!аі:а( ) для связывания данных с элемента¬ 
ми, все данные следует помещать в единственный объект и хранить его как 
единственное значение, дав ему имя, совпадающее с именем расширения. 

• Файл с программным кодом расширения должен иметь имя в формате ^иегу. 
ріи&іп.ів», где подстроку «ріи^іп» следует заменить на имя расширения. 

Расширения могут определять новые вспомогательные функции, добавляя их 
в сам объект ]0иегу. Например: 

// Этот метод выводит свои аргументы (с помощью метода расширения ргіпІІпО) 

// в элемент с атрибутом іс!="с1еЬид ”. Если такой элемент отсутствует, он будет 
// создан и добавлен в документ. 

ІОіюгу. сіебид = Гипс1іоп() { 

ѵаг еі* = ^^^е^у(■'#сIеЬ^д'■); // Отыскать элемент ЯРеЬіід 

Н (еіі:. Іепдіііт == 0) { // Создать, если он отсутствует 

еИ = }0иегу("<с1іѵ ісЗ= ’сІеЬид ’ ><Іі1>0еЬиддіпд 0и1:ри1:</Гі1></с1іѵ>"); 

^Оиегу (сіоситепі:. Ьоду). аррепсКеІІ:); 

} 

еИ. ргіпіііп. арр1у(е11:, агділпеп1:5); // Вывести в него аргументы 

}; 

Помимо создания новых методов можно также расширять и другие части библио¬ 
теки іСіиегу. В разделе 19.5, например, мы узнали, что имеется возможность до¬ 
бавлять новые имена, определяющие продолжительность визуальных эффектов 
(вдобавок к «Іазі» и «зіоіѵ»)» создавая новые свойства в объекте ^Оиегу.Гх.зреесІз, 
и добавлять новые функции переходов, включая их в объект іОиегу.еазіпд. Более 
того, с помощью расширений можно даже добавлять новые возможности в меха¬ 
низм селекторов библиотеки іСіиегу! Например, можно определить новые псевдо¬ 
классы фильтров (такие как :Гігз1: и : іприі:), добавив свойства в объект іОиегу. 
ехрг[ ': ']. Ниже приводится пример определения нового фильтра :сІгаддаЫе, кото¬ 
рый возвращает только элементы с атрибутом с!гаддаЫе=1:гие: 

]0иегу.ехрг[ ':' ].ргаддаЫе = Гипсііоп(е) { геіііігп е.сІгаддаЫе === 1:гие; }; 

Добавив этот фильтр, мы сможем выбирать доступные для буксировки изображе¬ 
ния вызовом $("ітд:сігаддаЫе") вместо более длинного $("ітд[дгаддаЬ1е=1:гие]"). 

Как можно заметить в примере выше, функции фильтра передается элемент 
БОМ - кандидат на выбор. Она должна вернуть Іігие, если элемент соответствует 
фильтру, и Гаізе - в противном случае. Многие нестандартным фильтрам доста¬ 
точно одного аргумента с элементом, но в действительности им передается четыре 
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аргумента. Во втором аргументе передается целочисленный индекс, определяю¬ 
щий позицию элемента в массиве кандидатов. Этот массив передается в четвертом 
аргументе, но ваша функция фильтра не должна модифицировать его. В третьем 
аргументе передается весьма интересное значение: это массив результатов вызова 
метода.ехес() объекта РедЕхр. В четвертом элементе этого массива (с индексом 3) 
хранится значение, переданное псевдоклассу фильтра в круглых скобках (если 
оно имеется). Из этого значения удаляются все скобки и кавычки, и остается 
только строка. Например, ниже показано, как можно было бы реализовать псев¬ 
докласс :сіа1:а(х), возвращающий 1:гие только для элементов, имеющих атрибут 
сіаііа-х (раздел 15.4.3): 

]Оиегу.ехрг[':' ]. сіаііа = Гипс1:іоп(е1етеп1:, іпйех, таІсИ. аггау) { 

// Примечание: В ІЕ версии 7 и ниже метод ГіазАНгіЬіііеС) отсутствует 
геііигп еіетепі:.НазАигіЬиІеС'йаіа-" + та1:сИ[3]); 

}; 

19.10. Библиотека іОиегу III 

Функциональные возможности, поддерживаемые библиотекой іСіиегу, сосредо¬ 
точены на методах для работы с деревом БОМ, стилями С88, обработчиками со¬ 
бытий и поддержки архитектуры Азах. Все вместе это является отличным фунда¬ 
ментом для построения высокоуровневых абстракций, таких как виджеты поль¬ 
зовательского интерфейса, которые предоставляет библиотека іСіиегу Ш. Пол¬ 
ный охват возможностей библиотеки іСіиегу Ш выходит далеко за рамки этой 
книги, и все, что нам доступно, - это краткий обзор. Саму библиотеку и докумен¬ 
тацию к ней можно найти на сайте Ыір:Ц}диегуиі.сот . 

Как следует из ее имени, библиотека іСіиегу Ш определяет множество виджетов 
пользовательского интерфейса: поля ввода с функцией автодополнения, элемен¬ 
ты выбора даты, многостраничные виджеты и вкладки для организации инфор¬ 
мации, движки и индикаторы хода выполнения операции для визуального пред¬ 
ставления числовых значений и модальные диалоги для срочного оповещения 
пользователя. В дополнение к этим виджетам библиотека іСіиегу Ш реализует 
более универсальные «механизмы взаимодействий», позволяющие легко сделать 
любой элемент документа буксируемым, изменяющим размеры, выбираемым 
или сортируемым. Наконец, библиотека іСіиегу Ш определяет множество новых 
методов визуальных эффектов (включая возможность изменять цвет) вдобавок 
к тем, что предлагаются самой библиотекой іСіиегу, и добавляет множество но¬ 
вых функций переходов. 

Библиотеку іСіиегу Ш можно представить как пакет расширений для библиотеки 
ІСІиегу, помещенных в один файл. Чтобы воспользоваться библиотекой іСіиегу Ш, 
достаточно просто подключить ее к веб-странице после подключения основной 
библиотеки іСіиегу. На странице Боѵѵпіоасі (Загрузка), на сайте Мір:/Гщиегуиі.сот , 
можно выбрать компоненты, которые предполагается использовать, и сконструи¬ 
ровать собственную версию библиотеки, что поможет вам сократить время за¬ 
грузки ваших страниц в сравнении со случаем использования полной версии биб¬ 
лиотеки іСіиегу Ш. 

Библиотека іСіиегу Ш поддерживает темы оформления, которые реализуются 
в виде файлов С88. То есть помимо загрузки в ваши страницы программного кода 
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Глава 19. Библиотека \Оиегу 


библиотеки іСіиегу Ш вам также придется подключить файл С88 с выбранной те¬ 
мой оформления. На сайте библиотеки іС^иегу Ш имеется множество готовых тем 
оформления, а также страница ♦ТЬетеКоІІег», позволяющая настраивать и загру; 
жать собственные темы оформления. 

Виджеты и механизмы взаимодействий в библиотеке іС^иегу Ш оформлены в виде 
расширений, каждое из которых определяет единственный метод объекта ]0иегу. 
Обычно, когда такие методы применяются к существующим элементам докумен¬ 
та, они преобразуют эти элементы в виджеты. Например, чтобы превратить тек¬ 
стовое поле ввода в виджет выбора даты, при щелчке на котором отображается 
календарик, достаточно просто вызвать метод с!а1:еріскег(), как показано ниже: 

// Превратить элементы <іпри1:> с атрибутом с1а55="йа1:е" в виджеты выбора даты 

$(" іприі; . сіаіе" ). сІа1:еріскег( ); 

Для полноценного использования виджета из библиотеки іСіиегу Ш необходимо 
знать три вещи: его параметры настройки, его методы и его события. Все видже¬ 
ты в библиотеке іСіиегу Ш являются настраиваемыми, и некоторые из них имеют 
весьма значительное количество настроек. Поведение и внешний вид виджетов 
можно настраивать, передавая объект с параметрами (подобный объекту с пара¬ 
метрами, который передается методу апіта1:е()) методу виджета. 

Виджеты в библиотеке іСіиегу Ш обычно определяют хотя бы несколько ♦мето¬ 
дов» взаимодействия с виджетом. Однако, чтобы избежать быстрого роста коли¬ 
чества методов объекта ]0ііегу, виджеты в библиотеке іСіиегу Ш определяют свои 
♦методы» не как настоящие методы. Каждый виджет имеет всего один метод (та¬ 
кой как метод с!а1:еріскег( ) в примере выше). Когда необходимо вызвать ♦метод» 
виджета, имя требуемого ♦метода» передается единственному настоящему мето¬ 
ду, определяемому виджетом. Например, чтобы перевести виджет выбора даты 
в состояние запрещения, не нужно вызывать его метод с1ізаЫе0аі:еріскег( ); вместо 
этого нужно вызвать йа^ерз.скегС'ЩзаЬХе"). 

Как правило, виджеты в библиотеке іСіиегу Ш определяют собственные события, 
которые генерируются в ответ на действия пользователя. Установить обработчи¬ 
ки этих событий можно с помощью обычного метода ЫпР() или с помощью свойств 
обработчиков событий объекта с параметрами, который передается методу вид¬ 
жета. В первом аргументе этим обработчикам, как обычно, передается объект 
Еѵепі:. Некоторые виджеты во втором аргументе передают обработчикам объект 
♦пользовательского интерфейса». Этот объект, как правило, хранит информацию 
о состоянии виджета. 

Обратите внимание, что в документации к библиотеке іС^иегу Ш иногда описы¬ 
ваются ♦события», которые не являются настоящими событиями и являются 
скорее функциями обратного вызова, которые устанавливаются посредством объ¬ 
екта с параметрами настройки. Например, виджет выбора даты поддерживает 
несколько функций обратного вызова, которые вызываются им в различных си¬ 
туациях. Однако ни одна из этих функций не имеет сигнатуры, свойственной 
стандартным обработчикам событий, и обработчики этих ♦событий» нельзя заре¬ 
гистрировать с помощью метода Ьіпсі(). Вместо этого соответствующие функции 
обратного вызова необходимо указывать при настройке виджета в первом вызове 
метода с!а1:еріскег( ). 
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Сохранение данных на стороне клиента 


Веб-приложения могут использовать прикладные программные интерфейсы бро¬ 
узеров для сохранения данных локально, на компьютере пользователя. Этот ме¬ 
ханизм сохранения данных на стороне клиента выполняет роль памяти для веб¬ 
броузеров. Веб-приложения могут сохранять, например, настройки пользователя 
или даже полную информацию о своем состоянии, чтобы иметь возможность во¬ 
зобновить работу точно с того момента, на котором их работа была прервана при 
последнем посещении. Хранилище на стороне клиента разграничивает данные 
в соответствии с происхождением, поэтому страницы с одного сайта не смогут чи¬ 
тать данные, сохраненные страницами с другого сайта. Но две страницы с одного 
и того же сайта смогут использовать хранилище в качестве механизма взаимо¬ 
действий. Например, данные, введенные в форме на одной странице, можно ото¬ 
бражать в таблице на другой странице. Веб-приложения могут устанавливать 
срок хранения своих данных: данные могут храниться временно, т.е. получить 
такие данные из хранилища можно, пока не будет закрыто окно или пока броузер 
не завертит работу, или сохраняться на жестком диске и храниться постоянно, 
чтобы их можно было получить месяцы или даже годы спустя. 

Существует несколько разновидностей хранилищ на стороне клиента: 

\ѴеЬ 8іога§е 

АѴеЬ Зіога&е - это прикладной программный интерфейс, определение которо¬ 
го первоначально было частью стандарта НТМЬб, но впоследствии было выде¬ 
лено в отдельную спецификацию. Эта спецификация все еще находится в ста¬ 
дии проекта, но частично (переносимым образом) реализована во всех теку¬ 
щих броузерах, включая ІЕ8. Этот прикладной интерфейс содержит объекты 
ІосаІЗііогаде и зеззіопЗііогаде, которые, по сути, являются постоянно хранимы¬ 
ми ассоциативными массивами, отображающими ключи в строковые значе¬ 
ния. Интерфейс АѴеЬ Зіога&е очень прост в использовании, он подходит для 
хранения больших (но не огромных) объемов данных и доступен во всех теку¬ 
щих броузерах, но не поддерживается старыми броузерами. Объекты ІосаІЗііо¬ 
гаде и зеззіопЗііогаде описываются в разделе 20.1. 
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Глава 20. Сохранение данных на стороне клиента 


Соокіез 

Соокіез - старейший механизм хранения данных на стороне клиента, кото¬ 
рый предназначен для использования серверными сценариями. В языке ^ѵа? 
8сгірі имеется довольно неудобный прикладной интерфейс, позволяющий 
управлять соокіез на стороне клиента, но этот механизм сложен в использова¬ 
нии и подходит лишь для хранения небольших объемов текстовых данных. 
Кроме того, любые данные, хранящиеся в виде соокіез, всегда передаются сер¬ 
веру с каждым НТТР-запросом, даже если эти данные представляют интерес 
только для клиента. Однако механизм соокіез по-прежнему представляет 
определенный интерес для разработчиков клиентских сценариев, потому что 
он поддерживается всеми броузерами, старыми и новыми. Однако когда меха¬ 
низм АѴеЪ 8іога&е получит более широкое распространение, механизм соокіез 
вернется к своей первоначальной роли в качестве механизма хранения дан¬ 
ных для серверных сценариев на стороне клиента. Механизм соокіез рассмат¬ 
ривается в разделе 20.2. 

ІЕ ѴзегБаіа 

Корпорация МісгозоІІ реализовала в ІЕ версии 5 и выше свой собственный ме¬ 
ханизм хранения данных на стороне клиента, известный как «изегБаіа». Ме¬ 
ханизм изегОаіа позволяет хранить достаточно большие объемы строковых 
данных и может использоваться как альтернатива механизму АѴеЪ 8іога&е 
в ІЕ версии 7 и ниже. Прикладной интерфейс механизма изегБаіа рассматри¬ 
вается в разделе 20.3. 

ОЦІіпе Ѵ?еЪ Арріісаііопз 

Стандарт НТМЬб определяет прикладной программный интерфейс «СЖІіпе 
ЛѴеЬ Арріісаііопз» (автономные веб-приложения), позволяющий кэшировать 
веб-страницы и связанные с ними ресурсы (сценарии, С88-файлы, изображе¬ 
ния и т.д.). Это хранилище предназначено для сохранения веб-приложений 
целиком, а не только их данных, и позволяет веб-приложениям устанавливать 
себя, давая возможность использовать их даже при отсутствии соединения 
с Интернетом. Автономные веб-приложения рассматриваются в разделе 20.4. 

Базы данных для Веб 

Разработчики, которым приходится работать с по-настоящему огромными 
объемами данных, предпочитают использовать базы данных, и многие произ¬ 
водители начинают включать в свои броузеры функциональные возможности 
доступа к базам данных на стороне клиента. Броузеры 8аІагі, СЬготе и Орега 
включают прикладной интерфейс к базе данных 8()Ь. Однако попытка стан¬ 
дартизации этого прикладного интерфейса потерпела неудачу, и весьма мало¬ 
вероятно, что он будет реализован в Гігеіох и ІЕ. Существует альтернативный 
прикладной интерфейс доступа к базам данных, который был стандартизован 
под названием «Іпсіехесі БаіаЪазе АРІ». Это прикладной интерфейс к простей¬ 
шей объектной базе данных, не поддерживающей язык запросов. Оба при¬ 
кладных интерфейса являются асинхронными и требуют использования об¬ 
работчиков событий, что усложняет их использование. Они не будут описы¬ 
ваться в этой главе, но в разделе 22.8 вы найдете краткий обзор и пример при¬ 
менения механизма ІпсІехесШВ АРІ. 
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Прикладной интерфейс к файловой системе 

В главе 18 было показано, что современные броузеры поддерживают объект 
Рііе, позволяющий с помощью объекта ХМШіііірВедиезІ: выгружать файлы, вы¬ 
бранные пользователем. Проекты родственных стандартов определяют при¬ 
кладной интерфейс для организации частной, локальной файловой системы 
и выполнения операций чтения и записи в файлы, находящиеся в этой файло¬ 
вой системе. Эти появляющиеся прикладные интерфейсы описываются в раз¬ 
деле 22.7. Когда они получат более широкое распространение, у веб-приложе¬ 
ний будет возможность использовать механизмы хранения данных, основан¬ 
ные на файлах, уже знакомые многим программистам. 


Сохранность, безопасность и конфиденциальность 

Веб-броузеры часто предлагают пользователям сохранить пароли и сохра¬ 
няют их на диске в зашифрованном виде. Но ни один из механизмов хране¬ 
ния данных на стороне клиента, описываемый в этой главе, никак не свя¬ 
зан с шифрованием: все, что вы будете сохранять, будет сохраняться на 
жестком диске в незашифрованном виде. То есть хранящиеся данные мо¬ 
гут быть извлечены чересчур любопытным пользователем, имеющим дос¬ 
туп к компьютеру, или злонамеренным программным обеспечением (на¬ 
пример, разнообразными шпионскими программами), находящимся на 
компьютере. По этой причине ни один из механизмов хранения данных на 
стороне клиента никогда не должен использоваться для хранения паролей, 
номеров банковских счетов или другой конфиденциальной информации. 
Запомните: тот факт, что пользователь вводит какую-то информацию в по¬ 
ля форм при взаимодействии с вашим веб-сайтом, еще не означает, что он 
хочет сохранить копию этой информации на диске. Возьмите в качестве 
примера номер кредитной карты. Это конфиденциальная информация, ко¬ 
торую люди предпочитают сохранять в тайне в своих бумажниках. Сохра¬ 
нить эту информацию с помощью механизма хранения данных на стороне 
клиента - это все равно что написать номер кредитной карты на бумажке 
и приклеить ее к клавиатуре. 

Кроме того, учтите, что многие пользователи не доверяют веб-сайтам, ис¬ 
пользующим соокіез или другие механизмы хранения данных на стороне 
клиента для целей, которые напоминают «слежение». Применяйте меха¬ 
низмы хранения, описываемые в этой главе, для повышения удобства ра¬ 
боты с вашим сайтом, но не используйте их как механизм сбора конфиден¬ 
циальной информации. Если появится слишком большое количество сай¬ 
тов, дискредитирующих механизмы хранения данных на стороне клиента, 
пользователи будут отключать их или часто очищать хранилища, что сде¬ 
лает невозможным и их использование, и работу сайтов, опирающихся на 
их применение. 





630 


Глава 20. Сохранение данных на стороне клиента 


20.1. Объекты ІосаІБІогаде и $е$$іоп$1огаде 


Броузеры, реализующие положения проекта спецификации «\УеЪ Зіога&е», опре¬ 
деляют в объекте Иіпсіом два свойства: 1оса18ііогаде и зеззіопЗііогаде. Оба свойства 
ссылаются на объект Зіогаде - постоянно хранимый ассоциативный массив, ото¬ 
бражающий строковые ключи в строковые значения. Объекты Зііогаде действуют 
подобно обычным объектам в языке ЛаѵаЗсгірі: достаточно просто присвоить свой¬ 
ству объекта строку, и броузер автоматически сохранит ее. Разница между Іосаі- 
Зііогаде и зеззіопЗііогаде заключается лишь в сроке хранения и области видимости: 
они определяют, как долго будут храниться данные и кому они будут доступны. 

Ниже мы подробнее поговорим о сроке хранения и области видимости. Л пока рас¬ 
смотрим несколько примеров. Следующий фрагмент использует свойство Іосаі- 
Зіогаде, но он точно так же мог бы работать и со свойством зеззіопЗііогаде: 


ѵаг пате = ІосаІЗіогаде. цзегпате; // 
пате = ІосаІЗіогадеГ'изегпате"]; // 
ІГ (!пате) { 

пате = рготрі: ("Как вас зовут?"); // 
ІосаІЗіогаде. цзегпате = пате; // 


Получить сохраненное значение. 

Эквивалентная форма обращения, как к массиву 

Задать пользователю вопрос. 

Сохранить ответ. 


} 

// Выполнить итерации по всем хранящимся парам имя/значение 
Гог(ѵаг пате іп ІосаІЗіогаде) { // Итерации по всем хранящимся именам 

ѵаг ѵаіье = 1оса151:огаде[пате]; // Получить значение для каждого из них 


} 


Объекты Зііогаде также определяют методы для сохранения, извлечения и удале¬ 
ния данных. Эти методы рассматриваются в разделе 20.1.2. 

Проект спецификации «\УеЪ 8іога&е» определяет возможность сохранения струк¬ 
турированных данных (объектов и массивов), а также простых значений и дан¬ 
ных встроенных типов, таких как даты, регулярные выражения и даже объекты 
Рііе. Однако на момент написания этих строк броузеры позволяли сохранять 
только строки. Если потребуется сохранять и извлекать данные других типов, их 
можно кодировать и декодировать вручную. Например: 

// При сохранении числа оно автоматически преобразуется в строку. 

// Не забудьте выполнить обратное преобразование при извлечении из хранилища. 

ІосаІЗіогаде. х = 10; 

ѵаг х = рагзеіпі: (1оса181:огаде .х); 

// Преобразовать объект йаііе в строку при записи и обратно - при чтении 

ІосаІЗіогаде. ІазіПеасІ = (пе\ѵ Оаіе()).іоІЛСЗігіпд(); 

ѵаг ІазіПеасІ = пем 0аіе(0а1:е. рагзе(1оса131:огаде. ІазіПеай)); 

// Для кодирования любых простых или структурированных данных удобно 
// использовать формат ЭЗОИ 

ІосаІЗіогаде.сіаіа = Э80Ы. зі:гіпдіГу(сіаііа ); // Закодировать и сохранить 

ѵаг сіаіа = Э50М рагзе( 1оса181:огаде .сіаііа); // Извлечь и декодировать. 


20.1.1. Срок хранения и область видимости 

Объекты 1оса18ііогаде и зеззіопЗііогаде отличаются сроком хранения данных и об¬ 
ластью видимости хранилища. Объект ІосаІЗііогаде представляет долговременное 
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хранилище данных: срок хранения не ограничен, и данные сохраняются на ком¬ 
пьютере пользователя, пока не будут удалены веб-приложением или пока пользо¬ 
ватель не потребует от броузера (посредством некоторого пользовательского ин¬ 
терфейса, предоставляемого броузером) удалить их. 

Доступность данных в объекте ІосаІЗііогаде ограничивается происхождением до¬ 
кумента. Как описывалось в разделе 13.6.2, происхождение документа определя¬ 
ется такими параметрами, как протокол, имя хоста и номер порта, поэтому все 
следующие ШІЬ-адреса ссылаются на документы с разным происхождением: 

Ітир://ѵлм. ехатріе. сот // Протокол: Иир; имя хоста: мм. ехатріе. сот 

ИИрз : //\алѵѵѵ . ехатріе . сот // Другой протокол 

Н«р: //знаніе . ехатріе . сот // Другое имя хоста 

НП р: / Длю. ехатріе . сот: 8000 // Другой порт 

Все документы, имеющие одно и то же происхождение, будут совместно исполь¬ 
зовать одни и те же данные в объекте ІосаІЗііогаде (независимо от происхождения 
сценария, который фактически обращается к хранилищу ІосаІЗііогаде). Они смо¬ 
гут читать и изменять данные друг друга. Но документы с разными происхожде¬ 
ниями никогда не смогут прочитать или изменить данные друг друга (даже если 
оба они будут выполнять сценарий, полученный с одного и того же стороннего 
сервера). 

Обратите внимание, что видимость данных в хранилище ІосаІЗііогаде также огра¬ 
ничивается конкретным броузером. Если посетить сайт с помощью Еігеіох, а за¬ 
тем вновь посетить его, например, с помощью СЬгоше, никакие данные, сохра¬ 
ненные при первом посещении, не будут доступны при втором посещении. 

Данные, сохраняемые в зеззіопЗііогаде, имеют другой срок хранения: они хранят¬ 
ся, пока остается открытым окно верхнего уровня или вкладка броузера, в кото¬ 
рой выполнялся сценарий, сохранивший эти данные. При закрытии окна или 
вкладки все данные, хранящиеся в зеззіопЗііогаде, удаляются. (Отметьте, однако, 
что современные броузеры имеют возможность повторно открывать недавно за¬ 
крытые вкладки и восстанавливать последний сеанс работы с броузером, поэтому 
срок хранения информации об этих вкладках и связанных с ними хранилищах 
зеззіопЗііогаде может оказаться больше, чем кажется.) 

Доступность данных в хранилище зеззіопЗііогаде, как и в хранилище ІосаІЗііогаде, 
ограничивается происхождением документа, т. е. документы с разным происхож¬ 
дением никогда не смогут совместно использовать одни и те же данные в зеззіоп- 
Зіогаде. Но помимо этого доступность данных в хранилище зеззіопЗііогаде ограни¬ 
чивается также окном. Если пользователь откроет в броузере две вкладки, ото¬ 
бражающие документы с общим происхождением, эти две вкладки будут владеть 
разными хранилищами зеззіопЗііогаде. Сценарий, выполняющийся в одной вклад¬ 
ке, не сможет прочитать или изменить данные, сохраненные в другой вкладке, 
даже если в обеих вкладках будет открыта одна и та же страница и будет выпол¬ 
няться один и тот же сценарий. Обратите внимание, что разграничение хранилищ 
зеззіопЗііогаде в разных окнах касается только окон верхнего уровня. Если в одной 
вкладке броузера будет находиться несколько элементов <і1тате> и в этих фрей¬ 
мах будут отображаться документы с общим происхождением, они будут совме¬ 
стно использовать одно и то же хранилище зеззіопЗііогаде. 
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20.1.2. Прикладной программный 
интерфейс объекта Зіогаде 

Объекты ІосаІЗііогаде и зеззіопЗІіогаде часто используются как обычные объекты 
языка ^ѵаЗсгірі: присваивание значения свойству приводит к сохранению стро¬ 
ки, а чтение свойства - к ее извлечению из хранилища. Но эти объекты определя¬ 
ют также более формальный прикладной интерфейс, основанный на методах. Со¬ 
хранить значение можно с помощью метода зеШепК), передав ему имя и значение. 
Извлечь значение можно с помощью метода деШет(), передав ему имя. Удалить 
значение можно с помощью метода гетоѵеІ1іет(), передав ему имя. (В большинстве 
броузеров удалить значение можно также с помощью оператора йеіеііе, как если 
бы оно было обычным объектом, но этот прием не работает в ІБ8.) Удалить все 
хранящиеся значения можно вызовом метода с1еаг() (без аргументов). Наконец, 
перечислить имена всех хранящихся значений можно с помощью свойства ІепдІіГі 
и метода кеу( ), передавая ему значения от 0 до 1епд*Ь-1. Ниже приводится несколь¬ 
ко примеров использования объекта ІосаІЗііогаде. Этот программный код с тем же 
успехом мог бы использовать объект зеззіопЗІіогаде: 

ІосаІЗііогаде.зеІіІІіетС'х", 1); // Сохранить число под именем "х" 

ІосаІЗііогаде. деІіІІіетС'х"); // Извлечь значение 

// Перечислить все хранящиеся пары имя-значение 

1ч)г(ѵаг і = 0; і < ІосаІЗііогаде. ІепдІіП; і++) { // Іепдіііі дает количество пар 
ѵаг пате = 1оса131:огаде . кеу(і); // Получить имя і-й пары 

ѵаг ѵаіье = ІосаІЗііо гаде. деІИет( пате); // Получить значение этой пары 

} 

ІосаІЗііогаде. гетоѵеКетСѴ); // Удалить элемент "х" 

ІосаІЗііогаде. с1еаг(); // Удалить все остальные элементы 

Несмотря на то что обычно удобнее сохранять и извлекать данные, обращаясь 
к свойствам, тем не менее иногда может потребоваться использовать эти методы. 
Во-первых, метод с1еаг( ) не имеет эквивалента и является единственным способом 
удаления всех пар имя/значение в объекте Зіогаде. Аналогично метод гетоѵеІ1іет() 
является единственным переносимым способом удаления одной пары имя/значе¬ 
ние, потому что ІЕ8 не позволяет использовать оператор йеіеііе для этой цели. 

Если производители броузеров реализуют все положения спецификации и позво¬ 
лят сохранять в объекте Зііогаде другие объекты и массивы, появится еще одна 
причина использовать методы, такие как зе1іПіет() и деіПіет( ). Объекты и массивы 
являются изменяемыми значениями, поэтому объекту Зііогаде необходимо будет 
создавать копию сохраняемого значения, чтобы все последующие изменения 
в оригинале не коснулись хранящегося значения. Точно так же объект Зііогаде дол¬ 
жен будет создавать копию и при извлечении значения, чтобы никакие изменения 
в извлеченном значении не коснулись хранящегося значения. Когда такое копиро¬ 
вание будет реализовано, использование интерфейса свойств может показаться за¬ 
путывающим. Взгляните на следующий (гипотетический, пока броузеры не под¬ 
держивают возможность сохранения структурированных значений) фрагмент: 

ІосаІЗііогаде. о = {х: 1}; // Сохранить объект, имеющий свойство х 

ІосаІЗііогаде. о.х =2; // Попытка установить свойство хранящегося объекта 

ІосаІЗііогаде. о.х // => 1: свойство х не изменилось 
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Во второй строке в примере выше выполняется безуспешная попытка присвоить 
новое значение свойству хранящегося объекта, потому что интерпретатор снача¬ 
ла извлечет копию хранящегося объекта, присвоит свойству копии новое значе¬ 
ние и затем удалит копию. В результате изменения не коснутся хранящегося объ¬ 
екта. Меньше шансов ошибиться, если использовать метод деіІІіетО: 

ІосаІЗііогаде. деШИетС "о"). х = 2; // Не предполагает сохранение значения 2 

Наконец, еще одна причина отдать предпочтение более явному прикладному ин¬ 
терфейсу на основе методов заключается в возможности имитировать этот при¬ 
кладной интерфейс поверх других механизмов сохранения данных в броузерах, 
которые пока не поддерживают спецификацию «ЛѴеЪ 81ога&е». В следующих раз¬ 
делах будут представлены примеры реализации интерфейса объекта Зііогаде с при¬ 
менением соокіез и изегБаіа в ІБ. При использовании прикладного интерфейса 
на основе методов можно писать программный код, который будет использовать 
свойство ІосаІЗііогаде, когда оно доступно, и возвращаться к использованию дру¬ 
гих механизмов в противном случае. Такой программный код мог бы начинаться 
следующими строками: 

// Определить, какой механизм хранения будет использоваться 
ѵаг тетогу = міпсіом. ІосаІЗііогаде || 

(\ѵіпсіо\ѵ.1)зег0а1іа8ііогаде && пе\ѵ Ііве гйа1:а81:огаде( )) || 
пе\ѵ Соокіе81іогаде(); 

// Затем отыскать требуемый элемент в хранилище 
ѵаг ьзетате = тетогу.деіІіетС'іізе тате"); 

20.1.3. События объекта Зіогаде 

При изменении данных, хранящихся в ІосаІЗііогаде или зеззіопЗііогаде, броузер 
генерирует событие «зіога&е» во всех объектах Іл/іпсісм, в которых доступны эти 
данные (но не в окне, где выполнялось сохранение). Если в броузере открыты две 
вкладки со страницами с общим происхождением и в одной из страниц произво¬ 
дится сохранение значения в ІосаІЗііогаде, в другой вкладке будет сгенерировано 
событие «зіога&е». Не забывайте, что область видимости данных, хранящихся 
в зеззіопЗііогаде, ограничивается окном верхнего уровня, поэтому при изменении 
данных в зеззіопЗііогаде события «зіога&е» будут генерироваться только при на¬ 
личии нескольких фреймов. Обратите также внимание, что события «зіога&е» ге¬ 
нерируются, только когда содержимое хранилища действительно изменяется. 
Присваивание хранимому элементу его текущего значения, как и попытка уда¬ 
лить несуществующий элемент, не возбуждают событие. 

Регистрация обработчиков события «зіога&е» выполняется с помощью метода 
ас!с1Еѵеп1іІ_із1іепег( ) (или а1і1іасІіЕѵепіі( ) в ІЕ). В большинстве броузеров для этой цели 
можно также использовать свойство опзііогаде объекта Іл/іпсіом, но на момент напи¬ 
сания этих строк данное свойство не поддерживалось в Еіге^ох. 

Объект события, связанный с событием «зіога&е», имеет пять основных свойств 
(к сожалению, они не поддерживаются в ІЕ8): 

кеу 

Имя или ключ сохраняемого или удаляемого элемента. Если был вызван ме¬ 
тод с!еаг(), это свойство будет иметь значение пиіі. 
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пемѴаІие 

Новое значение элемента или пиіі, если был вызван метод гетоѵеГСет(). 
оІсІѴаІие 

Старое значение существующего элемента, изменившегося или удаленного, 
или значение пиіі, если был создан новый элемент. 

зііогадеАгеа 

Это свойство будет хранить значение свойства ІосаІЗііогаде или зеззіопЗІогаде 
целевого объекта Міпсіом. 

игі 

ШІЬ-адрес (в виде строки) документа, сценарий которого выполнил операцию 
с хранилищем. 

Наконец, обратите внимание, что объект ІосаІЗ^огаде и событие «зіога^е» могут 
служить широковещательным механизмом, с помощью которого броузер может 
отправлять сообщения всем окнам, в которых в настоящий момент открыт один 
и тот же веб-сайт. Например, если пользователь потребует от веб-сайта прекра¬ 
тить воспроизводить анимационные эффекты, сценарий может сохранить соот¬ 
ветствующий параметр настройки в ІосаІЗііогаде, чтобы соблюсти это требование 
при последующих посещениях сайта. При сохранении параметра будет сгенери¬ 
ровано событие, что позволит другим окнам, отображающим тот же сайт, также 
удовлетворить это требование. В качестве другого примера представьте веб-при- 
ложение графического редактора, позволяющее пользователю отображать па¬ 
литры с инструментами в отдельных окнах. При выборе пользователем некоторо¬ 
го инструмента приложение могло бы сохранять в ІосаІЗііогаде признак выбран¬ 
ного инструмента и тем самым рассылать другим окнам извещения о том, что 
был выбран новый инструмент. 

20.2. Соокіез 

Соокіез - это небольшие фрагменты именованных данных, сохраняемые веб-бро- 
узером и связанные с определенными веб-страницами или веб-сайтами. Соокіез 
первоначально предназначались для разработки серверных сценариев и на низ¬ 
шем уровне реализованы как расширение протокола НТТР. Данные в соокіез ав¬ 
томатически передаются между веб-броузером и веб-сервером, благодаря чему 
серверные сценарии могут читать и записывать значения, сохраняемые на сторо¬ 
не клиента. В этом разделе будет показано, как клиентские сценарии могут рабо¬ 
тать с соокіез, используя свойство соокіе объекта Ооситепіі. 

Прикладной интерфейс для работы с соокіез является одним из старейших, а это 
означает, что он поддерживается всеми броузерами. К сожалению, этот приклад¬ 
ной интерфейс слишком замысловат. В нем отсутствуют методы: операции чте¬ 
ния, записи и удаления соокіез осуществляются с помощью свойства соокіе объ¬ 
екта Ооситепіі с применением строк специального формата. Срок хранения и об¬ 
ласть видимости можно указать отдельно для каждого соокіе с помощью атрибу¬ 
тов. Эти атрибуты также определяются посредством записи строк специального 
формата в то же самое свойство соокіе. 
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Почему «соокіе»? 

Особого смысла у термина «соокіе» (булочка) нет, тем не менее появился он 
не «с потолка». В туманных анналах истории компьютеров термин «соокіе», 
или «та&іс соокіе», использовался для обозначения небольшой порции дан¬ 
ных, в частности, привилегированных или секретных данных, вроде паро¬ 
ля, подтверждающих подлинность или разрешающих доступ. В Лаѵа8сгірі 
соокіез применяются для сохранения информации о состоянии и могут 
служить средством идентификации для веб-броузера, хотя они не шифру¬ 
ются и не могут считаться безопасными (впрочем, это не относится к пере¬ 
даче их через защищенное соединение по протоколу Іііііірз :). 


В следующих подразделах сначала будут описаны атрибуты, которые определя¬ 
ют срок хранения и область видимости соокіез, а затем будет продемонстрирова¬ 
но, как сохранять и извлекать значения соокіез в сценариях на языке ЛаѵаЗсгірі. 
Завершится этот раздел примером реализации на основе соокіез прикладного ин¬ 
терфейса, имитирующего объект 51:о гаде. 


Как определить, когда поддержка соокіез включена 

Соокіез пользуются дурной славой у многих пользователей Всемирной пау¬ 
тины из-за недобросовестного использования соокіез, связанных не с самой 
веб-страницей, а с изображениями на ней. Например, сторонние соокіез по¬ 
зволяют компаниям, предоставляющим услуги рекламного характера, от¬ 
слеживать перемещение пользователей с одного сайта на другой, что выну¬ 
ждает многих пользователей по соображениям безопасности отключать ре¬ 
жим сохранения соокіез в своих веб-броузерах. Поэтому, прежде чем ис¬ 
пользовать соокіез в сценариях ЛаѵаЗсгірі, следует проверить, не отключен 
ли режим их сохранения. В большинстве броузеров это можно сделать, про¬ 
верив свойство паѵідаііог.соокіеЕпаЫесІ. Если оно содержит значение Іігие, 
значит, работа с соокіез разрешена, а если 1"а1зе - запрещена (хотя при этом 
может быть разрешено использование временных соокіез, срок хранения 
которых ограничивается продолжительностью сеанса работы броузера). 
Свойство паѵідаііог.соокіеЕпаЫесІ не является стандартным, поэтому если 
сценарий вдруг обнаружит, что оно не определено, придется проверить, 
поддерживаются ли соокіез, попытавшись записать, прочитать и удалить 
тестовый соокіе, используя прием, описываемый ниже. 


20.2.1. Атрибуты соокіе: срок хранения 
и область видимости 

Помимо имени и значения каждый соокіе имеет необязательные атрибуты, 
управляющие сроком его хранения и областью видимости. По умолчанию соокіез 
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являются временными - их значения сохраняются на период сеанса веб-броузера 
и теряются при закрытии броузера. Обратите внимание, что этот срок хранения 
не совпадает со сроком хранения данных в зеззіопЗІогаде: доступность соокіев не 
ограничивается единственным окном, поэтому период их хранения по умолча¬ 
нию совпадает с периодом работы процесса броузера, а не какого-то одного окна. 
Чтобы соокіе сохранялся после окончания сеанса, необходимо сообщить броузе¬ 
ру, как долго (в секундах) он должен храниться, указав значение атрибута тах- 
а§е. Если указать срок хранения, броузер сохранит соокіе в локальном файле 
и удалит его только по истечении срока хранения. 

Видимость соокіе ограничивается происхождением документа, как и при исполь¬ 
зовании хранилищ ІосаІЗІогаде и зеззіопЗііогаде, а также строкой пути к докумен¬ 
ту. Область видимости соокіе может регулироваться посредством атрибутов раік 
и йотаіп. По умолчанию соокіе связывается с создавшей его веб-страницей и до¬ 
ступен этой странице, а также другим страницам из того же каталога или любых 
его подкаталогов. Если, например, веб-страница кіір://іѵіѵіѵ.ехатрІе.сот/саіаІоё/ 
іпйех.кіті создаст соокіе, то этот соокіе будет также видим страницам кііріЦ 
иоиоио.ехатріе.сот/саіаіоё/огйег.кіті и кіір://іѵіѵіѵ.ехатрІе.сот/саіаІоё/іѵі<Іёеі8/іп- 
с іех.кіті , но невидим странице кіір://іѵіѵіѵ.ехатрІе.сот/аЪоиі.кітІ. 

Этого правила видимости, принятого по умолчанию, обычно вполне достаточно. 
Тем не менее иногда значения соокіе требуется использовать на всем многостра¬ 
ничном веб-сайте независимо от того, какая страница создала соокіе. Например, 
если пользователь ввел свой адрес в форму на одной странице, целесообразно бы¬ 
ло бы сохранить этот адрес как адрес по умолчанию. Тогда этим адресом можно 
будет воспользоваться при следующем посещении тем же пользователем этой 
страницы, а также при заполнении им совершенно другой формы на любой дру¬ 
гой странице, где требуется ввести адрес, например для выставления счета. Для 
этого в соокіе можно определить атрибут раік. И тогда любая страница того же 
веб-сервера с ШІЬ-адресом, начинающимся с указанного значения, сможет ис¬ 
пользовать этот соокіе. Например, если для соокіе, установленного страницей 
кіір://іѵіѵіѵ.ехатрІе.сот/саіаІоё/іѵі<Іёеі8/іп<Іех.кітІ , в атрибуте раік установлено 
значение «/саіаіо#», этот соокіе также будет виден для страницы кіір://іѵіѵи к 
ехатрІе.сот/саіаІоё/оЫег.кітпІ . А если атрибут раік установлен в значение «/», то 
соокіе будет видим для любой страницы на веб-сервере кіір://іѵипѵ.ехатрІе.сот. 

Установка атрибута раік в значение «/» определяет такую же область видимости 
соокіе, как для хранилища ІосаІЗііогаде, а также говорит о том, что броузер дол¬ 
жен передавать имя и значение соокіе на сервер при запросе любой веб-страницы 
с этого сайта. Имейте в виду, что атрибут раік не должен восприниматься как 
своеобразный механизм управления доступом. Если веб-странице потребуется 
прочитать соокіев, принадлежащие какой-то другой странице на том же веб-сай¬ 
те, она может просто загрузить эту страницу в скрытый элемент <і1тате> и прочи¬ 
тать все соокіев, принадлежащие документу во фрейме. Политика общего проис¬ 
хождения (раздел 13.6.2) предотвращает подобное «подглядывание» за соокіев, 
установленных веб-страницами с других сайтов, но оно считается вполне допус¬ 
тимым для документов с одного и того же сайта. 

По умолчанию соокіев доступны только страницам с общим происхождением. 
Однако большим веб-сайтам может потребоваться возможность совместного ис¬ 
пользования соокіев несколькими поддоменами. Например, серверу огйег.ехатр- 
Іе.сот может потребоваться прочитать значения соокіе, установленного сервером 
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саіаіоё.ехатріе.сот . В этой ситуации поможет атрибут (іотаіп . Если соокіе, соз¬ 
данный страницей с сервера саіаіоё.ехатріе.сот , имеет в атрибуте раіН значение 
«/», а В атрибуте (іотаіп - значение «.ехатріе.сот», этот соокіе будет доступен 
всем веб-страницам в поддоменах саіаіоё.ехатріе.сот , огйегз.ехатріе.сот и в лю¬ 
бых других поддоменах в домене ехатріе.сот. Если атрибут (іотаіп не установ¬ 
лен, его значением по умолчанию будет имя веб-сервера, на котором находится 
страница. Обратите внимание, что в атрибут (іотаіп нельзя записать значение, 
отличающееся от домена вашего сервера. 

Последний атрибут соокіе - это логический атрибут с именем зесиге , определяю¬ 
щий, как значения соокіе передаются по сети. По умолчанию соокіе не защищен, 
т.е. передается по обычному незащищенному НТТР-соединению. Однако если 
соокіе помечен как защищенный, он передается, только когда обмен между бро¬ 
узером и сервером организован по протоколу НТТР8 или другому защищенному 
протоколу. 

20.2.2. Сохранение соокіез 

Чтобы связать временное значение соокіе с текущим документом, достаточно 
присвоить его свойству соокіе строку следующего формата: 

имя-значение 

Например: 

сіосілпепі:. соокіе = "ѵегзіоп=" + епсосіеиРІСотропепіСсіоситепІ:. ІазіМосіШесі); 

При следующем чтении свойства соокіе сохраненная пара имя/значение будет 
включена в список соокіез документа. Значения соокіе не могут содержать точки 
с запятой, запятые или пробельные символы. По этой причине для кодирования 
значения перед сохранением его в соокіе, возможно, потребуется использовать гло¬ 
бальную ЛаѵаЗсгірі-функцию епсойеШСотропеп1:(). В этом случае при чтении зна¬ 
чения соокіе надо будет вызвать соответствующую функцию с!есос1еІІРІСотропеп1:( ). 

Записанный таким способом соокіе сохраняется в течение сеанса работы веб-бро- 
узера, но теряется при его закрытии пользователем. Чтобы создать соокіе, сохра¬ 
няющийся между сеансами броузера, необходимо указать срок его хранения 
(в секундах) с помощью атрибута тах-аде. Это можно сделать, присвоив свойству 
соокіе строку следующего формата: 

имя=значение ; шах-аде=число_ секунд 

Следующая функция устанавливает соокіе с дополнительным атрибутом тах-аде: 

// Сохраняет пару имя/значение в виде соокіе, кодируя значение с помощью 
// епсосІеІЖІСотропепіС ), чтобы экранировать точки с запятой, запятые и пробелы. 

// Если в параметре сІаузТоІ-іѵе передается число, атрибут тах-аде 
// устанавливается так, что срок хранения соокіе истекает через 
// указанное число дней. Если передать значение 0, соокіе будет удален. 

І'ипсііоп зеіСоокіе(пате, ѵаіііе, сІаузТоІ_іѵе) { 

ѵаг соокіе = пате + "=" + епсобеІЖІСотропепІ:(ѵаіііе); 
іі (іуреоі 1 сІаузТоІ_іѵе === "питЬег") 

соокіе += тах-аде=” + (сіау5ТоІ_іѵе*60*60*24); 
босіітепі:. соокіе = соокіе; 

} 
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Аналогичным образом можно установить атрибуты ра1:Іп, сіотаіп и зесиге, дописав 
к значению соокіе строки следующего формата перед его записью в свойство 

соокіе: 

; раі Ь=путь 
; 6отіг)=домен 
; зесиге 

Чтобы изменить значение соокіе, установите его значение снова, указав то же 
имя, путь, домен и новое значение. При изменении значения соокіе можно также 
переопределить срок его хранения, указав новое значение в атрибуте тах-аде. 

Чтобы удалить соокіе, установите его снова, указав то же имя, путь, домен и лю¬ 
бое произвольное (возможно пустое) значение, а в атрибут тах-аде запишите 0. 

20.2.3. Чтение соокіез 

Когда свойство соокіе используется в ЛаѵаЗсгірІ-выражении, возвращаемое им 
значение содержит все соокіез, относящиеся к текущему документу. Эта строка 
представляет собой список пар имя = значение , разделенных точками с запятой 
и пробелами. Значение не включает какие-либо атрибуты, которые могли быть 
установлены для соокіе. При работе со свойством сіоситепі:.соокіе обычно прихо¬ 
дится использовать метод 5рШ( ), чтобы разбить его значение на отдельные пары 
имя/значение. 

После извлечения значения соокіе из свойства соокіе его требуется интерпретиро¬ 
вать, основываясь на том формате или кодировке, которые были указаны созда¬ 
телем соокіе. Например, соокіе можно передать функции сіесос!еІІРІСотропеггІ:( ), 
а затем функции ^(ЖрагзеО. 

В примере 20.1 определяется функция деіСоокіе( ), которая анализирует свойство 
сіоситепі:.соокіе и возвращает объект, свойства которого соответствуют парам 
имя/значение всех соокіез в документе. 

Пример 20.1. Анализ свойства йоситепі.соокіе 

// Возвращает соокіез документа в виде объекта с парами имя/значение. 

// Предполагается, что значения соокіе кодируются с помощью 
// функции епсосІеІШСотропепК ). 

^ипсііоп деіСоокіез( ) { 

ѵаг соокіез = {}; // Возвращаемый объект 

ѵаг аіі = сіоситепі:.соокіе; // Получить все соокіез в одной строке 
і^ (аіі === "") // Если получена пустая строка, 

геіигп соокіез; // вернуть пустой объект 

ѵаг Нзі = аіі.зрІііС; ”); // Разбить на пары имя/значение 
^ог(ѵаг і = 0; і < Іізі.ІепдіП; і++) { // Для каждого соокіе 
ѵаг соокіе = 1ізі[і]; 

ѵаг р = соокіе. іпсіехОГ( "="); // Отыскать первый знак = 

ѵаг пате = соокіе.зиЬзігіпдСО,р); // Получить имя соокіе 

ѵаг ѵаіие = соокіе.зиЬзІ:гіпд(р+1); // Получить значение соокіе 
ѵаіие = сіесосіеиПІСотропепКѵаіие); // Декодировать значение 
соокіез[пате] = ѵаіие; // Сохранить имя и значение в объекте 

} 

геіигп соокіез; 


} 
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20.2.4. Ограничения соокіеб 

Соокіез предназначены для сохранения небольших объемов данных серверными 
сценариями, которые должны передаваться на сервер при обращении к каждому 
соответствующему ІЖЬ-адресу. Стандарт, определяющий соокіез, рекомендует 
производителям броузеров не ограничивать количество и размеры сохраняемых 
соокіез, но броузеры не обязаны сохранять в сумме более 300 соокіев, 20 соокіев 
на один веб-сервер или по 4 Кбайт данных на один соокіе (в этом ограничении 
учитываются и значение соокіе, и его имя). На практике броузеры позволяют со¬ 
хранять гораздо больше 300 соокіев, но ограничение на размер 4 Кбайт для одно¬ 
го соокіе в некоторых броузерах по-прежнему соблюдается. 

20.2.5. Реализация хранилища на основе соокіез 

Пример 20.2 демонстрирует, как поверх соокіев можно реализовать методы, ими¬ 
тирующие прикладной интерфейс объекта З^огаде. Передайте конструктору Со- 
окіеЗі:огаде() желаемые значения атрибутов тах-а§е и раіН и используйте полу¬ 
чившийся объект подобно тому, как вы использовали бы ІосаІЗііогаде или зеззіоп- 
Зііогаде. Однако имейте в виду, что этот пример не реализует событие «зіога^е» 
и не выполняет автоматическое сохранение или извлечение значений при записи 
или чтении свойств объекта СоокіеЗііогаде. 

Пример 20.2. Реализация интерфейса объекта Зіога^е на основе соокіез 
/* 

* СоокіеЗііогаде. із 

* Этот класс реализует прикладной интерфейс объекта Зіогаде, на который ссылаются 

* свойства ІосаІЗііогаде и зеззіопЗііогаде, но поверх НИР Соокіез. 

*/ 

^ііпсіііоп СоокіеЗііогадеСтахаде, раіН) { // Аргументы определяют срок хранения 

// и область видимости 

// Получить объект, хранящий все соокіез 

ѵаг соокіез = ( І'ипсіііоп() { // Функция деіСоокіез(), реализованная выше 

ѵаг соокіез = {}; // Возвращаемый объект 

ѵаг аіі = сіоситепіі. соокіе; // Получить все соокіез в одной строке 

Н (аіі === "") // Если получена пустая строка 

геіііігп соокіез; // вернуть пустой объект 

ѵаг Іізі = аіі.зр1іІ("; ”); // Разбить на пары имя/значение 

1"ог(ѵаг і = 0; і < Іізі.ІепдіН; і++) { // Для каждого соокіе 
ѵаг соокіе = 1із1і[і]; 

ѵаг р = соокіе. іпсІехОІЧ// Отыскать первый знак = 
ѵаг пате = соокіе. зцЬз1ігіпд(0, р); // Получить имя соокіе 

ѵаг ѵаіііе = соокіе.зцЬз1ігіпд(р+1); // Получить значение соокіе 
ѵаіце = сіесосіеІЖІСотропепІі(ѵаІие); // Декодировать значение 
соокіез[пате] = ѵаіие; // Сохранить имя и значение 

} 

геііігп соокіез; 

}()); 

// Собрать имена соокіез в массиве 
ѵаг кеуз = []; 

І'огСѵаг кеу іп соокіез) кеуз.ризН(кеу); 
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// Определить общедоступные свойства и методы Зіогаде АРІ 

// Количество хранящихся соокіез 
ТНіз.ІепдТН = кеуз.ІепдТН; * 

// Возвращает имя п-го соокіе или пиіі, если п вышло за диапазон индексов 
ТПіз.кеу = Типсііоп(п) { 

ІТ (п < О || п >= кеуз. ІепдТП) геТигп пьП; 
геТигп кеуз[п]; 

}; 


// Возвращает значение указанного соокіе или пиіі. 

Шз.деШет = ТипсТіоп(пате) { геіигп соокіез[пате] || пиіі; }; 

// Сохраняет значение 
Шз.зеШет = ТипсТіоп(кеу, ѵаіие) { 

іТ (!(кеу іп соокіез)) { // Если соокіе с таким именем не существует 
кеуз.ризП(кеу); // Добавить ключ в массив ключей 

ТНіз. 1епдТН++; // И увеличить значение ІепдТП 

} 

// Сохранить пару имя/значение в множестве соокіез. 
соокіез[кеу] = ѵаіие; 

// Установить соокіе. 

// Предварительно декодировать значение и создать строку 
// имя=кодированное-значение 

ѵаг соокіе = кеу + "=" + епсосІеипІСотропепКѵаІие); 

// Добавить в строку атрибуты соокіе 
іТ (тахаде) соокіе += тах-аде=" + тахаде; 
іТ (раій) соокіе += раі^=" + раі^; 

// Установить соокіе с помощью свойства сіоситепі:. соокіе 
сіоситепі:. соокіе = соокіе; 


// Удаляет указанный соокіе 
Шз. гешоѵеііет = Типсііоп(кеу) { 

ІТ (!(кеу іп соокіез)) геіигп; // Если не существует, ничего не делать 


// Удалить соокіе из внутреннего множества соокіез 
беІеТе соокіез[кеу]; 


// И удалить ключ из массива имен. 

// Это легко можно было бы сделать с 
// определяемого стандартом Е85. 
Тог(ѵаг і = 0; і < кеуз.ІепдТИ; і++) 
іТ (кеуз[і] === кеу) { 
кеуз.зр1ісе(і,1); 

Ьгеак; 

} 

} 

Тйіз.ІепдТИ--; 


помощью метода іпбехОТО массивов, 

{ // Цикл по всем ключам 
// При обнаружении ключа 
// Удалить его из массива. 


// Уменьшить значение ІепдТй 


// Наконец фактически удалить соокіе, присвоив ему пустое значение 

// и истекший срок хранения. 

сіоситепі:.соокіе = кеу + "=; тах-аде=0"; 
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// Удаляет все соокіез 
ТИіз.сІеаг = ТьпсііопО { 

// Обойти все ключи и удалить соокіез 
1"ог(ѵаг і = 0; і < кеуз.ІепдіИ; і++) 

сіоситепі.соокіе = кеуз[і] + ”=; тах-аде=0"; 

// Установить внутренние переменные в начальное состояние 
соокіез = {}; 
кеуз = []; 

Шз. ІепдіИ = 0; 

}; 

} 

20.3. Механизм сохранения изегРаіа в ІЕ 

В ІЕ версии 5 и ниже поддерживается механизм сохранения данных на стороне 
клиента, доступный в виде нестандартного свойства ЬеОаѵіог элемента докумен¬ 
та. Использовать его можно следующим образом: 

ѵаг тетогу = с!оситепі.сгеаіеЕ1етепі("сІіѵ"); // Создать элемент 

тетогу.ісі = "_тетогу”; // Дать ему имя 

тетогу. зіуіе.сіізріау = "попе"; // Не отображать его 

тетогу. зіуіе.ЬеНаѵіо г = "ьгІС "йсіеІ'аиІійизегОаіа" )"; // Присоединить свойство 
сіоситепі:.Ьосіу.аррепсІСИіІсКтетогу); // Добавить в документ 

После того как для элемента будет определено поведение «изегБаіа», он получает 
новые методы 1оай() и заѵе(). Вызов метода 1оасІ( ) загружает сохраненные данные. 
Этому методу можно передать строку, напоминающую имя файла и идентифици¬ 
рующую конкретный пакет хранящихся данных. После загрузки данных пары 
имя/значение становятся доступны в виде атрибутов элемента, получить которые 
можно с помощью метода де1:А1:1:гіЬи1:е( ). Чтобы сохранить новые данные, необходи¬ 
мо установить атрибуты вызовом метода зе{АИгіЬи*е( ) и затем вызвать метод заѵе( ). 
Удалить значение можно с помощью методов гетоѵеА**гіЬи*е( ) и заѵе( ). Ниже при¬ 
водится пример использования элемента тетогу, инициализированного выше: 

тетогу. ІоасіС’туЗіогесіОаіа" ); // Загрузить сохраненные данные 

ѵаг пате = тетогу. деіАіігіЬиіеС’изегпате"); // Получить элемент данных 
іТ (!пате) { // Если он не был определен, 

пате = рготр{("Как вас зовут?); // запросить у пользователя 

тетогу. зеіАШігіЬиіеС'іізегпате", пате); // Установить как атрибут 
тетогу. заѵеС'туЗіогесЮаіа" ); // И сохранить до следующего раза 

} 

По умолчанию данные, сохраняемые с помощью механизма изегПаіа, имеют не¬ 
ограниченный срок хранения и сохраняются до тех пор, пока явно не будут уда¬ 
лены. Однако с помощью свойства ехрігез можно определить дату, когда истечет 
срок хранения данных. Например, в предыдущий фрагмент можно было бы доба¬ 
вить следующие строки, чтобы указать, что срок хранения данных истечет через 
100 дней: 

ѵаг пом = (пем Оаі:е( )). де1;Т іте( ); // Текущее время в миллисекундах 

ѵаг ехрігез = пом + 100 * 24 * 60 * 60 * 1000; // + 100 дней в миллисекундах 
ехрігез = пем 0а1;е(ехрі гез). ІюІЛСЗі;гіпд (); // Преобразовать в строку 

тетогу. ехрігез = ехрігез; // Установить срок хранения 
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Данные, сохраняемые с помощью механизма изегБаіа в ІЕ, доступны только для 
документов, хранящихся в том же каталоге, что и оригинальный документ, со¬ 
хранивший их. Это более ограниченная область видимости, чем у соокіез, кото* 
рые также доступны документам в подкаталогах оригинального каталога. В ме¬ 
ханизме изегБаіа отсутствует какой-либо эквивалент атрибутов раік и йотаіп 
в соокіез, позволяющий расширить область видимости данных. 

Механизм изегБаіа позволяет сохранять гораздо большие объемы данных, чем 
соокіез, но меньшие, чем объекты ІосаІЗііогаде и зеззіопЗііогаде. 

Пример 20.3 реализует методы деШетО, зеШетО и гетоѵеІ1:ет() интерфейса 3*о- 
гаде поверх механизма изегБаіа в ІЕ. (Он не реализует такие методы, как кеу() 
и с1еаг(), потому что механизм изегБаіа не предоставляет возможность выпол¬ 
нять итерации по всем хранящимся элементам.) 

Пример 20.3. Частичная реализация интерфейса 8іога§е 

на основе механизма изегИаіа в ІЕ 

Гііпсііоп изег0аіа8і:огаде(тахаде) { 

// Создать элемент документа и установить в нем специальное 
// свойство Ьеііаѵіог механизма іізегОаІа, чтобы получить доступ 
// к методам заѵе() и 1оасІ(). 

ѵаг тетогу = сіосіітепі:. сгеаіеЕІетепіС'сІіѵ"); // Создать элемент 

тетогу. зіуіе. сіізріау = ''попе"; // Не отображать его 

тетогу. зіуіе.ЬеНаѵіог = "цг1( 'йсІеІ'аііІІйіізегОаІа' )"; // Присоединить свойство ЬеНаѵіог 
сіосіітепі:.ЬоРу.аррепРСІііІсІ(тетогу); // Добавить в документ 

// Если указано значение параметра тахаде, хранить данные тахаде секунд 
іГ (тахаде) { 

ѵаг по\л/ = пе\л/ ОаІеО.деІТітеО: // Текущее время 

ѵаг ехрігез = по\л/ + тахаде * 1000: // тахаде секунд от текущего времени 

тетогу. ехрігез = пе\л/ Оаіе(ехрігез). 1оІЯС8і:гіпд( ); 

} 

// Инициализировать хранилище, загрузив сохраненные значения. 

// Значение аргумента выбирается произвольно, но оно должно совпадать 
// со значением, переданным методу заѵе() 

тетогу. ХоаРСизегОаТаатогаде”): // Загрузить сохраненные данные 

ІІііз.деіііет = 1 : ііпс1:іоп(кеу) { // Загрузить значения атрибутов 

геііігп тетогу. деі АН гіЬи1:е( кеу) || піііі; 

>: 

Шз. зеіііет = Гііпс1:іоп(кеу, ѵаіііе) { 

тетогу. зеІАІІ:гі Ьи1е( кеу,ѵаіііе); // Сохранить значения как атрибуты 
тетогу.заѵеС'ОзегОаІаЗіогаде"): // Сохранять после любых изменений 

>: 

ІІііз. гетоѵеііет = Гііпс1:іоп(кеу) { 

тетогу. гетоѵеАІІгіЬіі1:е(кеу); // Удалить сохраненные значения 

тетогу.заѵеС'изегОаІаЗіогаде"); // Сохранить новое состояние 

>: 

} 

Поскольку программный код из примера 20.3 будет работать только в ІЕ, можно 
воспользоваться условными комментариями ІЕ, чтобы предотвратить его загруз¬ 
ку в броузерах, отличных от ІЕ: 
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<\—Ш ІЕ]> 

<зсгірі 5гс="изег0а1:а81:огаде. І5"х/5сгірі:> 

<! [епсіі1 = ]--> 

20.4. Хранилище приложений 
и автономные веб-приложения 

Стандарт НТМЬб определяет новую особенность «кэш приложений» (арріісаііоп 
сасЬе), которая может использоваться веб-приложениями для сохранения самих 
себя локально в броузере пользователя. Объекты ІосаІЗІіогаде и зеззіопЗііогаде по¬ 
зволяют сохранять данные веб-приложений, тогда как кэш приложений позво¬ 
ляет сохранять сами приложения - все файлы (НТМЬ, С88, ^ѵа8сгірі, изобра¬ 
жения и т. д.), необходимые для работы приложения. Кэш приложений отличает¬ 
ся от обычного кэша веб-броузера: он не очищается, когда пользователь очищает 
обычный кэш. И кэшированные приложения не очищаются по признаку ЫШ 
(Іеазі-гесепііу изесі - давно не используемые), как это может происходить в обыч¬ 
ном кэше фиксированного размера. Приложения сохраняются в кэше не времен¬ 
но: они устанавливаются и могут оставаться в нем, пока не удалят себя сами или 
не будут удалены пользователем. В действительности, кэш приложений вообще 
не является кэшем - для него больше подошло бы название «хранилище прило¬ 
жений» (арріісаііоп зіога&е). 

Основная причина необходимости установки веб-приложений локально заключа¬ 
ется в обеспечении их доступности при работе в автономном режиме (например, 
в самолете или когда сотовый телефон находится вне доступа к сети). Веб-прило- 
жения, способные работать автономно, устанавливают себя в кэш приложений, 
используют ІосаІЗІіогаде для сохранения своих данных и реализуют механизм 
синхронизации для передачи сохраненных данных при подключении к сети. При¬ 
мер автономного веб-приложения мы увидим в разделе 20.4.3, но сначала нам не¬ 
обходимо узнать, как приложение может установить себя в кэш приложений. 

20.4.1. Объявление кэшируемого приложения 

Чтобы установить приложение в кэш приложений, необходимо создать файл объ¬ 
явления: файл, перечисляющий ІШЬ всех ресурсов, необходимых приложению. 
Затем нужно просто добавить ссылку на файл объявления в основную НТМЬ- 
страницу приложения, определив атрибут тапгРезІ: в теге <И1:т1>: 

<Ю0СТУРЕ НТМІ_> 

<Іі1:т1 тапі1 : ез1:="туарр. аррсасІпе"> 

<ІіеасІ>. .. </ІіеасІ> 

<ЬосІу>. .. </ЬосІу> 

Файлы объявлений должны начинаться со строки «САСНЕ МАЫІГЕ8Т». В сле¬ 
дующих строках должны перечисляться ІШЬ-адреса кэшируемых ресурсов. От¬ 
носительные ІШЬ-адреса откладываются относительно ІШЬ-адреса файла объ¬ 
явления. Пустые строки игнорируются. Строки, начинающиеся с символа #, яв¬ 
ляются комментариями и также игнорируются. Перед комментариями могут 
быть пробелы, но они не могут следовать в строке за какими-либо непробельными 
символами. Ниже приводится пример простого файла объявления: 
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САСНЕ МАМІЕЕ8Т 

# Строка выше определяет тип файла. Данная строка является комментарием 

# Следующие строки определяют ресурсы, необходимые для работы приложения 

туарр. ІтЕтІ 

туарр. 

туарр.С35 

ітадез/ЬаскдгоііпсІ. рпд 

Этот файл объявления служит признаком приложения, устанавливаемого в кэш. 
Если веб-приложение содержит более одной веб-страницы (более одного НТМЬ- 
файла, которые могут быть открыты пользователем), в каждой из этих страниц 
должен быть определен атрибут <Іті:т1 тапіГез1:=>, ссылающийся на файл объявле¬ 
ния. Факт наличия во всех страницах ссылок на один и тот же файл объявления 
недвусмысленно говорит о том, что все они должны кэшироваться вместе как час¬ 
ти одного и того же веб-приложения. Если в приложении имеется всего несколько 
НТМЬ-страниц, их обычно перечисляют непосредственно в файле объявления. 
Однако это совершенно необязательно: все файлы, ссылающиеся на файл объяв¬ 
ления, будут считаться частью веб-приложения и вместе с ним будут установлены 
в кэш. 

Простой файл объявления, подобный тому, что показан выше, должен перечис¬ 
лять все ресурсы, необходимые веб-приложению. После загрузки веб-приложе¬ 
ния в первый раз и установки его в кэш при последующих обращениях к нему оно 
будет загружаться из кэша. Когда приложение загружается из кэша, все необхо¬ 
димые ему ресурсы должны быть перечислены в файле объявления. Ресурсы, ко¬ 
торые не были перечислены, не загружаются. Эта политика имитирует работу 
в автономном режиме. Если простое кэшированное приложение сможет запус¬ 
каться из кэша, оно точно так же сможет запускаться, когда броузер работает в ав¬ 
тономном режиме. Более сложные веб-приложения в общем случае не могут кэ¬ 
шировать каждый необходимый им ресурс отдельно. Но они тем не менее могут 
использовать кэш приложений, если они имеют более сложные объявления. 


МІМЕ-тип объявления кэшируемого приложения 

По соглашению файлам объявлений кэшируемых приложений даются име¬ 
на с расширением .аррсаске. Однако это всего лишь соглашение, а для фак¬ 
тической идентификации типа файла веб-сервер должен отправлять файл 
объявления с МІМЕ-типом «іехі/сасЬе-тапИезі». Если при отправке файла 
объявления сервер установит в заголовке «Сопіепі-Туре» любой другой 
МІМЕ-тип, приложение не будет установлено в кэш. Вам может потребовать¬ 
ся специально настроить свой веб-сервер на использование нужного МІМЕ- 
типа, например, создав в АрасЬе файл .кіассезз в каталоге веб-приложения. 


20.4.1.1. Сложные объявления 

При запуске приложения из кэша загружаются только ресурсы, перечисленные 
в файле объявления. В примере файла объявления, представленном выше, ТШЬ- 
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адреса ресурсов перечисляются по одному. В действительности, файлы объявле¬ 
ний имеют более сложный синтаксис, чем было показано в этом примере, и суще¬ 
ствует еще два способа перечисления ресурсов в файлах объявлений. Для идентиг 
фикации типов записей в объявлении используются специальные строки-заго¬ 
ловки разделов. Простые записи, как те, что были показаны выше, помещаются 
в раздел «САСНЕ:», который является разделом по умолчанию. Два других разде¬ 
ла начинаются с заголовков «ЫЕТАѴОКК:» и «ЕАЬЬВАСК:». (В файле объявления 
может быть любое количество разделов, и они могут следовать в любом порядке.) 

Раздел «ЫЕТАѴОКК:» определяет ресурсы, которые никогда не должны кэширо¬ 
ваться и всегда должны загружаться из сети. Здесь можно перечислить, напри¬ 
мер, ІІКЬ-адреса серверных сценариев. ІІКЬ-адреса в разделе «ЫЕТАѴОКК:» в дей¬ 
ствительности являются префиксами ІІКЬ-адресов. Все ресурсы, ІІКЬ-адреса ко¬ 
торых начинаются с этих префиксов, будут загружаться только из сети. Если бро¬ 
узер работает в автономном режиме, то попытки обратиться к таким ресурсам 
будут оканчиваться неудачей. В разделе «ЫЕТАѴОКК:» допускается использовать 
шаблонный ЬГКЬ-адрес «*». В этом случае броузер будет пытаться загружать из 
сети все ресурсы, не упомянутые в объявлении. Это фактически отменяет прави¬ 
ло, которое требует явно перечислять в файле объявления все ресурсы, необходи¬ 
мые кэшируемому приложению. 

Записи в разделе «ЕАЬЬВАСК:» включают два ІІКЬ-адреса в каждой строке. Ре¬ 
сурс, указанный во втором ІІКЬ, загружается и сохраняется в кэше. Первый ІІКЬ 
используется как префикс. Все ІІКЬ-адреса, соответствующие этому префиксу, 
не кэшируются и при возможности загружаются из сети. Если попытка загру¬ 
зить ресурс с таким ІІКЬ-адресом терпит неудачу, вместо него будет использо¬ 
ваться кэшированный ресурс, определяемый вторым ІІКЬ-адресом. Представьте 
веб-приложение, включающее несколько видеоруководств. Поскольку видеоро¬ 
лики имеют большой объем, они не подходят для сохранения в локальном кэше. 
Для работы в автономном режиме файл объявления мог бы предусматривать ото¬ 
бражение вместо них текстовой справки. 

Ниже приводится более сложный файл объявления кэшируемого приложения: 

САСНЕ МАМІЕЕЗТ 

САСНЕ: 
туарр. Ніті 
туарр.сзз 
туарр. із 

ЕАІ_І_ВАСК: 

ѵісіеоз/ оН1іпе_Ііе1р. Ніті 

ЫЕТІлЮРК: 

сді/ 

20.4.2. Обновление кэша 

При запуске кэшированного веб-приложения все его файлы загружаются непо¬ 
средственно из кэша. Если броузер подключен к сети, он также асинхронно про¬ 
верит наличие изменений в файле объявления. Если он изменился, будут загру¬ 
жены и установлены в кэш приложения новый файл объявления и все файлы, на 
которые он ссылается. Обратите внимание, что броузер не проверяет наличие 
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изменений в кэшированных файлах - проверяется только файл объявления. На¬ 
пример, если вы изменили файл сценария на языке ЛѵаЗсгірі и вам необходимо, 
чтобы ваше веб-приложение обновило свой кэш, вам следует обновить файл объ¬ 
явления. Поскольку список файлов, необходимых приложению, при этом не из¬ 
меняется, проще всего добиться требуемого результата, изменив номер версии: 

САСНЕ МАМІЕЕ8Т 

# МуАрр версия 1 (изменяйте этот номер, чтобы заставить броузеры повторно 

# загрузить следующие файлы) 

МуАрр. М:т1 

МуАрр.]3 

Аналогично, если потребуется, чтобы веб-приложение удалило себя из кэша при¬ 
ложений, следует удалить файл объявления на сервере, чтобы на запрос этого 
файла возвращался бы НТТР-ответ 404 «N 0 ! Гоипб», и изменить НТМЬ-файл или 
файлы, удалив из них ссылки на файл объявления. 

Обратите внимание, что броузеры проверяют файл объявления и обновляют кэш 
асинхронно, после (или во время) загрузки копии приложения из кэша. Для про¬ 
стых веб-приложений это означает, что после обновления файла объявления 
пользователь должен дважды загрузить приложение, чтобы получить обновлен¬ 
ную версию: в первый раз будет загружена старая версия из кэша, после чего про¬ 
изойдет обновление файлов в кэше, а во второй раз из кэша будет загружена но¬ 
вая версия. 

В ходе обновления кэша броузер запускает множество событий, что дает возмож¬ 
ность зарегистрировать их обработчики и извещать пользователя. Например: 

аррІісаІіопСасИе. опцрсіаіегеасіу = ^ьпсііопО { 

ѵаг геіоасі = сопГігт("Доступна новая версия приложения, которая\п” + 

"будет использована при следующем запуске. \п" + 

"Хотите ли перезапустить ее сейчас?"); 
іГ (геіоасі) Іосаііоп. геІоасК): 

} 

Обратите внимание, что этот обработчик событий регистрируется в объекте Арріі- 
саІііопСасИе, на который ссылается свойство аррІісаІііопСасИе объекта Міпсісм. Бро¬ 
узеры, поддерживающие кэш приложений, определяют это свойство. Помимо со¬ 
бытия «ирсіаіегеасіу», показанного выше, существует еще семь различных собы¬ 
тий, имеющих отношение к кэшу приложений. В примере 20.4 демонстрируются 
простые обработчики, которые выводят сообщения, информирующие пользова¬ 
теля о ходе обновления кэша и о его текущем состоянии. 

Пример 20.4. Обработка событий кэша приложений 

// Эту функцию используют все обработчики событий, реализованные ниже, и выводят 
// с ее помощью сообщения, информирующие о состоянии кэша приложений. 

// Поскольку все обработчики отображают сообщения таким способом, они 
// возвращают Гаізе, чтобы отменить дальнейшее распространение события 
// и предотвратить вывод сообщений самим броузером. 

Гііпсііоп з{а1:и5(т5д) { 

// Вывести сообщение в элементе документа с ісІ="8'Ьа'Ьііз1іпе" 
сІоситепІ.деІЕІетепІіВуІсІС'зІаІизІіпе"). іппегНТМІ. = тзд; 
сопзоіе.Іод(тзд) ; // А также в консоли для отладки 

} 
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// Каждый раз, когда приложение загружается, броузер проверяет файл объявления. 
// В начале этого процесса первым всегда генерируется событие "сііескіпд". 
ѵ/іпсІоѵѵ.аррІісаІіопСасПе.опсІіескіпд = ^ітсЬіопО { 

5Іа1:ііз( "Проверка наличия новой версии."); 
геііігп Шзе; 

}; 


// Если файл объявления не изменился и приложение уже имеется в кэше, 

// генерируется событие "поіірсіаіе" и процедура проверки заканчивается, 
ѵѵіпбом.аррІісаІіопСасПе. оппоцрсіаіе = ■РііпсііопО { 
зіаііі^ "Версия приложения не изменилась.") 
геТіігп Шзе; 

}; 

// Если приложение отсутствует в кэше или если изменился файл объявления, 

// броузер загрузит и поместит в кэш все, что перечислено в файле объявления. 
// Событие "сіоѵу/піоасііпд" свидетельствует о начале этой процедуры загрузки. 
ѵѵіпсІоѵ/.аррІісаТіопСасІіе.опсІоѵ/пІоасІіпд = ^ипсІіопО { 

5Іа1:іі5( "Загружается новая версия"); 

ѵііпвоѵі. ргодгеззсоііпі: = 0; // Используется в обработчике "ргодгезз" ниже 

геііігп Шзе; 

}; 


// В ходе загрузки периодически генерируются события "ргодгезз”, 

// обычно после загрузки каждого файла. 

\л/іпсіо\л/. аррІісаІіопСасМе. опргодгезз = ^ііпсЬіоп(ё) { 

// Объект события должен соответствовать событию "ргодгезз" (подобному тому, 
// что используется ХНВ2), что позволяет вычислять процент выполнения, 

// но на всякий случай мы заведем счетчик количества вызовов, 
ѵаг ргодгезз = ""; 

(е && е. ІепдІІіСотріііаЫе) // Событие "ргодгезз": вычислить процент 
ргодгезз = " " + Матіі. гоцпсІ(100*е. Іоасіесі/е.ііоіаі) + "%” 
еізе // Иначе сообщить кол-во вызовов 

ргодгезз = " (" + ++ргодгеззсоцп1: + ")" 

зіаііиз ("Загружается новая версия" + ргодгезз); 
геТіігп ^аізе ; 

}; 

// Когда приложение впервые загружается в кэш, по окончании загрузки 
// броузер сгенерирует событие "сасЬесГ. 
ѵѵіпсіом. аррІісаТіопСасИе. опсасИесІ = -Гцпс1:іоп() { 

5Іа1:іі5( "Приложение загружено и установлено локально"); 
геТигп І^аізе; 

}; 


// Когда обновляется приложение, находящееся в кэше, то по завершении загрузки 
// броузер сгенерирует событие "црсіаіегеасіу". Обратите внимание, что при этом 
// пользователь по-прежнему будет работать со старой версией приложения. 
ѵ/іпсІоѵл/.аррІісаТіопСасІіе. опіірсіаіегеасіу = ^ипсИоп () { 

з1:а1:из("Была загружена новая версия приложения. Перезапустите его."); 
геііігп Шзе; 

}; 


// Если броузер выполняется в автономном режиме и файл объявления не может 
// быть проверен, генерируется событие "еггог". Это же событие генерируется, 
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// когда некэшированное приложение ссылается на отсутствующий файл объявления. 

\л/іпсіоѵ\/. аррІісаІіопСасИе .опеггог = ГітсГіопО { 

зГаГіі5( "Невозможно загрузить файл объявления " + 

"или сохранить приложение в кэш"); 
геііігп Гаізе; 

}; 

// Если кэшированное приложение ссылается на несуществующий файл объявления, 

// генерируется событие "оЬзоІеГе" и приложение удаляется из кэша. 

// В следующий раз приложение будет целиком загружаться из сети, а не из кэша. 
ѵ/іпсІом.аррІісаГіопСасІіе.опоЬзоІеГе = ГітсГіопО { 
зГаГііз( "Это приложение больше не кэшируется. " + 

"Перезапустите его, чтобы получить последнюю версию из сети."); 
геГіігп Гаізе; 

}; 

Всякий раз, когда загружается НТМЬ-файл с атрибутом тапіГезГ, броузер генери¬ 
рует событие «сЬескіп^» и загружает из сети файл объявления. Вслед за событи¬ 
ем «сЬескіп^» в разных ситуациях генерируются разные события: 

Нет обновлений 

Если приложение уже находится в кэше и файл объявления не изменился, 
броузер генерирует событие «поирсіаіе». 

Есть обновления 

Если приложение находится в кэше и обнаружено изменение файла объявле¬ 
ния, броузер генерирует событие «сіолѵпіоасііп^» и приступает к загрузке и кэ¬ 
шированию всех файлов, перечисленных в файле объявления. С началом про¬ 
цесса загрузки начинают генерироваться события «рго^гезз». А по окончании 
загрузки генерируется событие «ирсіаіегеасіу». 

Первая загрузка нового приложения 

Если приложение отсутствует в кэше, события «склѵпІоасИщг» и «рго^гезз» ге¬ 
нерируются, как и для случая обновления кэше, описанного выше. Однако по 
окончании первой загрузки броузер генерирует событие «сасЬеб», а не «ирба- 
іегеабу». 

Броузер работает в автономном режиме 

Если броузер работает в автономном режиме, он не имеет возможности прове¬ 
рить файл объявления и генерирует событие «еггог». Это же событие генери¬ 
руется, когда приложение, отсутствующее в кэше, ссылается на отсутствую¬ 
щий файл объявления. 

Файл объявления отсутствует 

Если броузер подключен к сети и приложение уже установлено в кэш, но при 
попытке получить файл объявления сервер возвращает ошибку 404 «N 0 ! Ео- 
ипсі», генерируется событие «оЬзоІеІе» и приложение удаляется из кэша. 

Обратите внимание, что все эти события можно отменить. Обработчики в приме¬ 
ре 20.4 возвращают значение Гаізе, чтобы отменить действия, предусмотренные 
для событий по умолчанию. Это предотвращает вывод броузером своих собствен¬ 
ных сообщений. (На момент написания этих строк ни один броузер не выводил 
никаких сообщений.) 
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В качестве альтернативы обработчикам событий, приложение может также ис¬ 
пользовать свойство арр1іса1:іопСасИе.з1:а1:из и с его помощью определять состоя¬ 
ние кэша. Это свойство может иметь шесть разных значений: 

АррІісаІііопСасИе.ІЖАСНЕО (0) 

Это приложение не имеет атрибута тапі^ез*: оно не кэшируется. 
Арр1іса1:іопСасИе.І0І_Е (1) 

Файл объявления проверен, и в кэше находится последняя версия приложе¬ 
ния. 

АррІісаІііопСасИе.СНЕСКІМС (2) 

Броузер проверяет файл объявления. 

АррІісаІііопСасІпе. 00ЫМЮА0ІМ0 (3) 

Броузер загружает и сохраняет в кэше файлы, указанные в файле объявле¬ 
ния. 

АррІісаІііопСасКіе.ІІРОАТЕРЕАОУ (4) 

Была загружена и установлена в кэш новая версия приложения. 

Арр1іса1:іопСасИе.0В50І-ЕТЕ (5) 

Файл объявления отсутствует, и приложение будет удалено из кэша. 

Объект АррІісаІііопСасИе также определяет два метода. Метод ирс!а1:е() явно запус¬ 
кает процедуру проверки наличия новой версии приложения. Он заставляет бро¬ 
узер выполнить проверку файла объявления (и сгенерировать сопутствующие 
события), как если бы приложение загружалось в первый раз. 

Метод з\л/арСасІпе() немного сложнее. Напомню, что, когда броузер загрузит и со¬ 
хранит в кэше обновленную версию приложения, пользователь по-прежнему бу¬ 
дет работать со старой версией. Он увидит новую версию, только когда перезагру¬ 
зит приложение. Если пользователь не сделает этого, старая версия должна рабо¬ 
тать вполне корректно. И отметьте, что старая версия может по-прежнему загру¬ 
жать ресурсы из кэша: она, например, может использовать объект ХМЫНІіІірРедиезІ: 
для загрузки файлов, и эти файлы будут извлекаться из старой версии кэша. То 
есть, вообще говоря, броузер должен сохранять старую версию кэша, пока поль¬ 
зователь не перезагрузит приложение. 

Метод змарСасИеО сообщает броузеру, что он может удалить старый кэш и удовле¬ 
творять все последующие запросы из нового кэша. Имейте в виду, что это не при¬ 
водит к перезагрузке приложения: НТМЬ-файлы, изображения, сценарии и дру¬ 
гие ресурсы, которые уже были загружены, останутся старыми. Но на все после¬ 
дующие запросы будут возвращаться ресурсы из нового кэша. Это может вызвать 
конфликт между версиями, и в общем случае использовать этот метод не рекомен¬ 
дуется, если только вы специально не предусмотрели такую возможность. Пред¬ 
ставьте, например, приложение, которое не делает ничего и отображает экранную 
заставку, пока броузер проверяет файл объявления. Когда приложение получает 
событие «поирбаіе», оно продолжает работу и загружает начальную страницу. Ес¬ 
ли приложение получает событие «сіолѵпіоасііп^», оно отображает соответствую¬ 
щий индикатор хода выполнения операции, пока обновляется кэш. И когда при¬ 
ложение получает событие «ирбаіегеасіу», оно вызывает метод змарСасІпеО и затем 
загружает обновленную начальную страницу из свежей версии в кэше. 
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Обратите внимание, что вызывать метод змарСасИеО имеет смысл, только когда 
свойство зііаііиз имеет значение АррІісаІііопСасИе.иРОАТЕРЕАОѴ или АррІісаІііопСасІіе. 
0В501-ЕТЕ. (Вызов метода з\л/арСасИе(), когда свойство зііаііиз имеет значение 0В50І.ЕТЕ* 
сразу же удалит старую версию кэша, и все ресурсы будут загружаться из сети.) 
Если вызвать метод 5\л/арСасРе(), когда свойство зііаііиз имеет любое другое значе¬ 
ние, это приведет к исключению. 

20.4.3. Автономные веб-приложения 

Автономными называют веб-приложения, которые устанавливаются в кэш при¬ 
ложений и благодаря этому остаются доступными всегда, даже когда броузер ра¬ 
ботает в автономном режиме. В простейших случаях - таких как часы или гене¬ 
раторы фракталов - приложение уже имеет все, что ему необходимо для автоном¬ 
ной работы. Но в более сложных веб-приложениях бывает необходимо выгружать 
данные на сервер: даже простейшим игровым приложениям может потребовать¬ 
ся выгружать на сервер высшие достижения игрока. Приложения, которым необ¬ 
ходимо выгружать данные на сервер, также могут быть автономными, если для 
сохранения своих данных они будут использовать объект ІосаІЗІіогаде и затем вы¬ 
гружать данные, как только сеть будет доступна. Реализация синхронизации 
данных между локальным хранилищем и сервером может оказаться самым 
сложным этапом подготовки веб-приложения к работе в автономном режиме, осо¬ 
бенно когда пользователь может обращаться к нескольким источникам данных. 

Чтобы выполняться в автономном режиме, веб-приложение должно иметь воз¬ 
можность выяснить, работает ли оно в автономном режиме, и определять момен¬ 
ты подключения и отключения от сети. Проверить режим работы броузера можно 
с помощью свойства паѵіда1іог.опІ_іпе. А определить изменение состояния подклю¬ 
чения можно, зарегистрировав обработчики событий «опііпе» и «оШіпе» в объек¬ 
те Міпсісм. 

Эта глава завершается простым примером автономного веб-приложения, демон¬ 
стрирующим использование этих приемов. Приложение называется РегтаЫоіе - 
это простое приложение управления заметками, которое сохраняет текст, вве¬ 
денный пользователем, в объекте ІосаІЗІіогаде и выгружает его на сервер, когда 
соединение с Интернетом будет доступно. 1 Приложение РегтаЫоіе дает пользо¬ 
вателю создать единственную заметку и игнорирует проблемы аутентификации 
и авторизации - предполагается, что сервер обладает некоторым механизмом, 
позволяющим ему отличать одного пользователя от другого без использования 
какой-либо страницы входа. Реализация приложения РегтаЫоіе состоит из трех 
файлов. В примере 20.5 приводится содержимое файла объявления. В нем пере¬ 
числены остальные два файла и указывается, что ТШЬ «поіе» не должен кэширо¬ 
ваться: этот ІІКЬ-адрес используется для чтения и записи заметки на сервере. 

Пример 20.5. регтапоіе.аррсаске 

САСНЕ МАМІРЕЗТ 

# РегтаМоІе ѵ8 

регтапоіе. Шті 


1 Идея этого примера была подсказана приложением НаШюіе, написанным Аароном 
Будманом (Аагоп Воойтап). Приложение Наііпоіе было одним из первых автономных 
веб-приложений. 
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регтапоіе.із 

МЕТІЛІОИК: 

поіе 

В примере 20.6 приводится второй файл приложения РегтаЫоіе: это НТМЬ-файл, 
который реализует пользовательский интерфейс простого редактора. Он отобра¬ 
жает элемент <1ех1:агеа> с панелью инструментов вдоль верхнего края и строкой 
состояния для сообщений вдоль нижнего края. Обратите внимание, что тег <ІтЬт1> 
имеет атрибут тапі^езі:. 

Пример 20.6. регтапоіе.кіті 

<! РОСТУРЕ НТМІ_> 

<ІтІ:т1 тапі1 : езІ= ,, регтапо1:е. аррсасИе"> 

<ІіеасІ> 

<ІШе> Редактор РегтаМо1е</1:і1:1е> 

<зсгірі: згс=''регтапо1:е.із"></зсгірт> 

<зТу1е> 

йесіііог { місІІІі: 100%; ИеідИТ: 250рх; } 
йзіаііізііпе { місіііі: 100%; } 

</5Іу1е> 

</ІіеасІ> 

<ЬосІу> 

<сііѵ ісІ=”1:оо1Ьаг”> 

<Ьіі1:1:оп ісІ="5аѵеЬііТТоп" опс1іск="заѵе( )">Сохранить</ЬиТТоп> 

<Ьіі1:1:оп опс1іск="зупс()">Синхронизировать</Ьіі1:1:оп> 

<ЬігИоп опс1іск=”арр1ісаТіопСасІіе.ирсІа1:е()”>0бновить приложение</Ьіі1:1:оп> 

</сііѵ> 

<ТехТагеа ісІ="есІіТог"></ТехТагеа> 

<сііѵ Ір=''з1а1из1іпе''></с1іѵ> 

</ЬосІу> 

</Шт1> 

Наконец, в примере 20.7 приводится сценарий на языке ЛѵаЗсгірі, который обес¬ 
печивает работу веб-приложения РегтаЫоІе. Он определяет функцию 5І:а1:из() 
для отображения сообщений в строке состояния, функцию заѵе() - для сохране¬ 
ния текущей версии заметки на сервере и функцию зупс() - для синхронизации 
серверной и локальной копии заметки. Функции заѵе( ) и зупс( ) используют прие¬ 
мы управления протоколом НТТР, описанные в главе 18. (Интересно отметить, 
что функция заѵе() использует НТТР-метод «РЦТ» вместо более типичного для 
таких случаев метода «Р08Т».) 

Помимо этих трех основных функций в примере 20.7 определяются также обра¬ 
ботчики событий. Чтобы обеспечить синхронизацию локальной и серверной ко¬ 
пий заметки, приложению требуется довольно много обработчиков событий: 

опіоасі 

Пытается загрузить заметку с сервера, если там хранится более новая ее вер¬ 
сия, и по завершении синхронизации разрешает доступ к окну редактора. 
Функции заѵе() и зупс() выполняют НТТР-запросы и регистрируют обработ¬ 
чик события «опіоасі» в объекте ХМЫНІіІірРедиезІ:, чтобы определить момент, ко¬ 
гда выгрузка или загрузка будут завершены. 
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опЬеІ'огеипІоасІ 

Сохраняет текущую версию заметки на сервере, если она еще не была выгру¬ 
жена. 

опіприі: 

Всякий раз, когда текст в элементе <1:ех1:агеа> изменяется, он сохраняется в объ¬ 
екте ІосаІЗііогаде, и запускается таймер. Если пользователь не продолжит ре¬ 
дактирование в течение 5 секунд, заметка будет выгружена на сервер. 

опо^ііпе 

Когда броузер переключается в автономный режим, в строке состояния выво¬ 
дится сообщение. 

опопііпе 

Когда броузер подключается к сети, выполняется проверка наличия на серве¬ 
ре более новой версии заметки и выполняется сохранение текущей версии. 

опирсіаііегеасіу 

Если появилась новая версия приложения, выводится сообщение в строке со¬ 
стояния, сообщающее об этом пользователю. 

оппоирсіаііе 

Если приложение не изменилось, сообщает пользователю, что он или она ра¬ 
ботает с текущей версией. 

А теперь, после краткого обзора логики работы приложения РегтаКоіе, в приме¬ 
ре 20.7 приводится ее реализация. 

Пример 20.7'. регтапо1е.]8 

// Некоторые необходимые переменные 

ѵаг есііііог, зііаііизііпе, заѵеЬиІіІіоп, ісііеііітег; 

// При первой загрузке приложения 
міпсіом.опіоасі = 'ГипсІііопО { 

// Инициализировать локальное хранилище, если это первый запуск 
і? (ІосаІЗііогаде. поіе == пиіі) ІосаІЗііогаде. поіе = 
і? (ІосаІЗііогаде.ІазІіМосІі^іесІ == пиіі) ІосаІЗііогаде.ІазІМосІі^іесІ = 0; 
і? (ІосаІЗііогаде. ІазіЗаѵесІ == пиіі) ІосаІЗііогаде. ІазіЗаѵесІ = 0; 

// Отыскать элементы, которые составляют пользовательский интерфейс редактора. 

// Инициализировать глобальные переменные, 
есііііог = сіоситепіі. деіЕІетепІіВуІсК "есііііог"); 
зііаііизііпе = сіоситепіі. деІіЕІетепІіВуІсІ (" зііаііизііпе"); 
заѵеЬиІіІіоп = сіоситепіі. деіЕІетепІі ВуІс1(" заѵеЬиІіІіоп"); 

есііііог.ѵаіие = ІосаІЗііогаде. поіе; // Восстановить сохраненную заметку 
есііііог.сІізаЫес! = Ігие; // Но запретить редактирование до синхр. 

// При вводе нового текста в элемент іехіагеа 
есііііог. асІсІЕѵепІі Іізііепе г( "іприіі", 

І'ипсіііоп (е) { 

// Сохранить новую заметку в ІосаІЗііогаде 
ІосаІЗііогаде. поіе = есііііог. ѵаіие; 

ІосаІЗііогаде. ІазііМосІіГіесІ = Оаііе. по\м(); 

// Переустановить таймер ожидания 
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ІТ (ісііеііітег) с1еагТітеоиТ( ісііеііітег); 
ісНеІіітег = 5еТТітеои1і(5аѵе, 5000); 

// Разрешить кнопку сохранения 
заѵеЬиТТоп.сІізаЫесІ = Таізе; 


}, 

Таізе); 


// При каждой загрузке приложения пытаться синхронизироваться с сервером 
зупс(); 


// Сохраняет заметку на сервере перед уходом со страницы 
міпсіом.опЬеТогеипІоас! = ТипсТіопО { 

ІТ (ІосаІЗТогаде. ІазТМосІіТіесІ > ІосаІЗТогаде. ІазТЗаѵесІ) 
заѵе(); 

}; 


// Сообщить пользователю перед переходом в автономный режим 
ѵѵіпсіом.опоТТІіпе = ТипсТіопО { зТаТиз("Автономный режим"); } 

// При подключении к сети выполнить синхронизацию, 
міпсіоѵі/.опопііпе = ТипсТіопО { зупс(); }; 

// Сообщить пользователю, если доступна новая версия приложения. 

// Здесь можно было бы выполнить перезагрузку принудительно, вызвав 
// метод ІосаТіоп.геІоасК) 

міпсіоѵі/.аррІісаТіопСасНе.опирбаТегеасІу = ТипсТіопО { 
зТаТиз ("Доступна новая версия приложения. " + 

"Чтобы использовать ее, необходимо перезагрузить приложение ”); 

}; 

// Также сообщить пользователю, если он использует последнюю версию приложения. 
міпбом.аррІісаТіопСасНе.оппоирбаТе = ТипсТіопО { 

зТаТизС'Вы используете последнюю версию приложения."); 

}; 


// Функция отображения сообщения в строке состояния 
ТипсТіоп зТаТиз^зд) { зТаТизІіпе. іппегНТМІ. = тзд; } 

// Выгружает текст заметки на сервер (если сеть подключена). 

// Автоматически вызывается через 5 секунд простоя после изменения текста заметки. 
ТипсТіоп заѵе() { 

ІТ (ісІІеТітег) с1еагТітеои1:(ісііеііітег); 
ісііеііітег = пиіі; 

ІТ (паѵідаТог.опііпе) { 

ѵаг хНг = пеѵѵ ХМІНТТрПедиезТ(); 
хНг.ореп("РІГП, "/поТе"); 
хПг. зепс!(есІіТог. ѵаіие); 
хПг.опІоас! = ТипсТіоп() { 

ІосаІЗТогаде. ІазТЗаѵесІ = ОаТе.поѵѵО; 
заѵеЬиТТоп.сІізаЫесІ = Тгие; 

}; 

} 

} 

// Проверяет наличие новой версии заметки на сервере. Если она отсутствует, 

// сохраняет текущую версию на сервере. 
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ГипсГіоп зупс() { 

ІГ (паѵідаГог.опІЛпе) { 

ѵаг хИ г = пем ХМШІгІірРедиезІ:(); 
х!іг.ореп("6ЕТ", "/поГе"); 
хНг. зепс1(); 

хНг.опІоасІ = ГипсГіоп() { 
ѵаг гетоГеМосІТіте = 0; 

ІГ (хНг. зГаГііз == 200) { 

ѵаг гетоГеМосІТіте = хНг. деГРезропзеНеасІег("І_а5Г-МосІіГіесГ); 
гетоГеМосІТіте = пем 0аГе( гетоГеМосІТіте). деГТіте(); 

} 

ІГ (гетоТеМосІТіте > ІосаІЗГогаде. ІазГМосІіГіесІ) { 

зГаГиз("На сервере найдена более новая заметка."); 
ѵаг изеіГ = 

сопГігт("На сервере имеется более новая версия\п” + 
"заметки. Щелкните на кнопке 0к, чтобы\п" + 
"использовать эту версию, или на кнопке\п"+ 
"Отмена, чтобы продолжить редактировать\п"+ 
"текущую версию и затереть версию на сервере "); 
ѵаг пом = ОаГе.пом(); 

ІГ (іізеіі:) { 

ебіГог. ѵаіие = ІосаІЗГогаде. поГе = хііг. гезропзеТехГ; 

ІосаІЗГогаде. ІазГЗаѵесІ = пом; 

зГаГиз("Загружена более новая версия."); 

} 

еізе 

зГаГиз("Игнорируется более новая версия заметки."); 
ІосаІЗГогаде. ІазГМосІіГіесІ = пом; 

} 

еізе 

зГаГиз("Редактируется последняя версия заметки."); 

ІГ (ІосаІЗГогаде.ІазГМосІіГіесІ > ІосаІЗГогаде. ІазГЗаѵесІ) { 
заѵе(); 

} 

ебіГог.сІізаЫесІ = Гаізе; // Разрешить доступ к редактору 
есІіГог. Госиз(); // И поместить в него курсор ввода 

} 

} 

еізе { // В автономном режиме мы не можем синхронизироваться 
зГаГиз("Невозможно синхронизироваться в автономном режиме"); 
ебіГог. сІізаЫесІ = Гаізе; 
ебіГог. Госиз(); 


} 






21 

Работа с графикой 
и медиафайлами на стороне клиента 


В этой главе рассказывается о том, как манипулировать изображениями, управ¬ 
лять аудио- и видеопотоками и рисовать графику. В разделе 21.1 описываются тра¬ 
диционные приемы реализации визуальных эффектов на языке Лѵабсгірі, таких 
как смена изображений, когда одно статическое изображение сменяется другим 
при наведении указателя мыши. В разделе 21.2 описываются элементы <аис1іо> 
и <ѵіс!ео>, определяемые стандартом НТМЬб, и их прикладные интерфейсы в язы¬ 
ке ^ѵаЗсгірі. 

После первых двух разделов, посвященных работе с изображениями, аудио- и ви¬ 
деопотоками, будет рассказано о двух мощных технологиях рисования графиче¬ 
ских изображений на стороне клиента. Способность воспроизводить на стороне 
клиента сложные графические изображения имеет важное значение по несколь¬ 
ким причинам: 

• Объем программного кода, создающего изображение на стороне клиента, обыч¬ 
но много меньше, чем объем самого изображения, что позволяет сберечь суще¬ 
ственную долю полосы пропускания. 

• Динамическое создание графических изображений потребляет существенные 
ресурсы центрального процессора. Переложив эту задачу на клиента, можно 
существенно снизить нагрузку на сервер и немного сэкономить на стоимости 
аппаратных средств для него. 

• Создание графики на стороне клиента прекрасно согласуется с положениями 
современной архитектуры веб-приложений, в которой серверы поставляют 
данные, а клиенты управляют представлением этих данных. 

В разделе 21.3 описывается 8са1аЫе Ѵесіог СгарЫсз, или 8ѴС. 8ѴС - это язык раз¬ 
метки, основанный на языке ХМЬ, предназначенный для описания графических 
изображений. Изображения на языке 8ѴС можно создавать и изменять в сцена¬ 
риях на языке ^ѵабсгірі с использованием модели БОМ. В заключение в разде¬ 
ле 21.4 мы познакомимся с элементом <сапѵаз>, определяемым стандартом НТМЬб, 
и его обширным прикладным интерфейсом на языке Лѵабсгірі, обеспечивающим 
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возможность создания графических изображений. Элемент <сапѵаз> является ре¬ 
волюционной технологией, и он подробно описан в этом разделе. 

4 

21.1. Работа с готовыми изображениями 

Готовые изображения могут включаться в веб-страницы с помощью тега <ітд>. 
Подобно любому НТМЬ-элементу, элементом <ітд> можно управлять: присваива¬ 
ние нового ШІЬ-адреса свойству 8 гс заставляет броузер загрузить (если необходи¬ 
мо) и отобразить новое изображение. (Кроме того, можно изменять ширину и вы¬ 
соту изображения, заставляя броузер увеличивать или уменьшать его, но этот 
прием здесь не рассматривается.) 

Возможность динамической замены одного изображения другим в НТМЬ-доку- 
менте открывает доступ к некоторым специальным эффектам. На практике чаще 
всего прием смены изображений привязывается к наведению указателя мыши на 
изображение. Когда изображение размещается внутри гиперссылки, смена изо¬ 
бражения становится приглашением пользователю щелкнуть на изображении. 
(Аналогичный эффект можно получить с помощью псевдокласса С88 :Иоѵег, по¬ 
зволяющего изменять фоновое изображение элемента.) Следующий фрагмент 
разметки НТМЬ выводит изображение, которое изменяется при наведении на не¬ 
го указателя мыши: 

<ітд згс="ітадез/Ие1р.діГ" 

оптоіі5еоѵег="1:Ііі5. згс=' ітадез/Ие1р_го11оѵег. діГ " 
оптоизеоіі1:="1:Иі5. згс=' ітадез/ііеір. діГ' "> 

Обработчики событий в элементе <ітд> изменяют значение свойства 8 г с, когда 
указатель мыши наводится на изображение или покидает его границы. Эффект 
смены изображений отчетливо связывается с возможностью щелкнуть на изобра¬ 
жении, поэтому такие элементы <ітд> следует заключать в элементы <а> или пе¬ 
редавать обработчику события опсііск. 

Чтобы радовать глаз, эффект смены изображений (и родственные ему эффекты) 
должен иметь минимальное время отклика. Это означает, что необходим некото¬ 
рый способ, гарантирующий предварительную загрузку всех необходимых изо¬ 
бражений в кэш броузера. Для этой цели в клиентском ^ѵабсгірі имеется специ¬ 
альный прикладной интерфейс: чтобы принудительно поместить изображение 
в кэш, нужно сначала создать объект Ітаде с помощью конструктора Ітаде(). За¬ 
тем, записав в свойство 8гс требуемый ШІЬ-адрес, загрузить изображение. Это 
изображение не будет добавлено в документ, поэтому, хотя изображение будет не¬ 
видимо, броузер загрузит его и поместит в свой кэш. Позднее, когда тот же ІЖЬ- 
адрес будет использоваться для изменения изображения, находящегося на экра¬ 
не, изображение быстро загрузится из кэша броузера. 

Приведенный выше фрагмент разметки, воспроизводящий эффект смены изо¬ 
бражений, не выполняет предварительную загрузку изображений, поэтому поль¬ 
зователь может заметить задержку при смене изображения, когда первый раз на¬ 
ведет на него указатель мыши. Чтобы исправить ситуацию, необходимо немного 
изменить разметку: 

<зсгір1:>(пем Ітаде()).згс = ''ітадез/Ие1р_го11оѵег.діГ';</зсгір1:> 

<ітд згс="ітадез/Ііе1р. діГ’ 
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оптоизеоѵег="1:Ні5. згс=' ітадез/Ие1р_го11оѵег. діГ" 
оптоизеои1:="1:Ні5.згс=’ Ітадез/Неір. діГ”> 

21.1.1. Ненавязчивая реализация смены изображений 

Только что продемонстрированный фрагмент содержит один элемент <8сгір1:> 
и два атрибута обработчиков событий с Лѵа8сгірі-кодом для реализации единст¬ 
венного эффекта смены изображений. Это прекрасный пример навязчивого Лѵа- 
8сгірі-кода: объем программного кода достаточно велик, чтобы осложнить чтение 
разметки НТМЬ. В примере 21.1 приводится ненавязчивая альтернатива, позво¬ 
ляющая выполнять смену изображений простым добавлением атрибута сіаіа- 
гоііоѵег (раздел 15.4.3) к любому элементу <ітд>. Обратите внимание, что в этом 
примере используется функция опІ_оас!() из примера 13.5. В нем также использу¬ 
ется массив сіоситепі:.ітадез[ ] (раздел 15.2.3), в котором хранятся ссылки на все 
элементы <ітд> в документе. 

Пример 21 Л. Ненавязчивая реализация эффекта смены изображений 
I * * 

* гоііоѵег.із: Ненавязчивая реализация эффекта смены изображений. 

* 

* Для создания эффекта смены изображений подключите этот модуль к своему НТМІ_-файлу 

* и используйте атрибут сіаііа-гоііоѵег в элементах <ітд> . чтобы определить 0П1_-адрес 

* сменного изображения. Например: 

* 

* <ітд згс="погта1_ітаде. рпд" ба1:а-го11оѵег="го11оѵег_ітаде. рпд"> 

* 

* Обратите внимание, что для работы этого модуля необходимо подключить оп1_оас1.]5 
*/ 

опЬоас!( "Гипсіііоп () { // Все в одной анонимной функции: не определяет имен 
// Цикл по всем изображениям, отыскивает атрибут сіаііа-гоііоѵег 
Гог(ѵаг і = 0; і < сіоситепі:.ітадез.ІепдіН; і++) { 
ѵаг ітд = сіоситепі:. ітадез[і]; 
ѵаг гоііоѵег = ітд. де1:А1:1:гіЬи1:е( 'сіаіа-гоііоѵег"); 
і? (!гоііоѵег) сопііпие; // Пропустить изображения без баіа-гоііоѵег 

// Обеспечить загрузку сменного изображения в кэш 
(пем Ітаде( )).зге = гоііоѵег; 

// Определить атрибут для сохранения ІІВІ_-адреса 

// изображения по умолчанию 

ітд.зеІАПгіЬиІеС'сІаІа-гоІІоиІ:" , ітд. зге); 

// Зарегистрировать обработчики событий, 

// создающие эффект смены изображений 
ітд.оптоизеоѵег = 1 = ипс1:іоп( ) { 

іНіз.згс = ІНіз. деіАПгіЬиіеС'сІаіа- гоііоѵег"); 

}; 

ітд.оптоцзеоці: = ГипсііопО { 

іНіз.згс = іПіз. деіАіігіЬиіеС'сІаіа-гоІІоиІ:"); 

}; 

} 


}); 
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21.2. Работа с аудио- и видеопотоками 

Стандарт НТМЬб определяет новые элементы <аис!іо> и <ѵіс!ео>, которые теорети* 
чески так же просты в использовании, как элемент <ітд>. В броузерах с поддерж¬ 
кой стандарта НТМЬб больше не нужно использовать дополнительные расшире¬ 
ния (такие как ПазЬ), чтобы внедрить в свои НТМЬ-документы аудио- и видео¬ 
клипы: 

<аис!іо згс="Ьаскдгоипс1_тіізіс. трЗ"/> 

<ѵіс!ео згс="пе\мз. тоѵ" \міс!1:И=320 ИеідІгІ:=240/> 

Однако на практике работать с этими элементами несколько сложнее, чем было 
показано выше. Производители броузеров не смогли прийти к соглашению о стан¬ 
дарте на аудио- и видеокодеки, которые поддерживались бы всеми броузерами, 
вследствие чего обычно приходится использовать элементы <зоигсе>, чтобы ука¬ 
зать несколько источников мультимедийных данных в различных форматах: 

<аис1іо іс!="тизіс"> 

<5оигсе згс="тіі5іс.трЗ" 1уре="аисІі о/тред "> 

<5оигсе 5гс="тіі5іс.одд" 1:уре='аисііо/одд; сосіес="ѵогЬіз"’> 

</аис!іо> 

Обратите внимание, что элементы <зоигсе> не имеют содержимого: они не имеют 
закрывающего тега </зоигсе>, и от вас не требуется завершать их последователь¬ 
ностью символов />. 

Броузеры, поддерживающие элементы <аис!іо> и <ѵіс!ео>, не будут отображать их 
содержимое. Тогда как броузеры, не поддерживающие их, отобразят это содер¬ 
жимое. Чтобы решить эту проблему, можно вставить внутрь содержимое для об¬ 
ратной совместимости (например, элемент <оЬ]ес1:>, который вызывает расшире¬ 
ние ИазЬ): 

<ѵіс!ео іс1="пеѵі/5" \міс!1:1і=640 ІіеідМ:=480 сопіігоіз рге1оас!> 

<!-- В формате Ѵ\/еЬМ для Рігеі'ох и СИготе --> 

<5оигсе згс="пемз.меЬт" 1:уре='ѵісІео/ѵѵ/еЬт; сосіес5="ѵр8 І ѵогЬіз'"> 

<!-- В формате Н.264 для ІЕ и Заі'агі --> 

<5оигсе згс="пемз.тр4" 1:уре='ѵіс!ео/тр4; сос1ес5="аѵс1.42Е01Е, тр4а.40.2'"> 

<!-- Для совместимости с расширением ЕІазЬ --> 

<оЬ]ес1: ѵѵ/ісИ:Іт=640 ИеідМ:=480 1:уре="арр1іса1:іоп/х-5Ііоскѵѵаѵе-1 : 1азЬ" 
сІа1а=''ИазІі_тоѵіе_р1ауег. змГ'> 

<!-- Здесь можно указать параметры настройки проигрывателя РІазИ --> 

<!-- Текстовое содержимое, используемое в самом худшем случае --> 

<с!іѵ>Элемент ѵісіео не поддерживается и расширение ЕІазИ не установлено.</с!іѵ> 
</оЬ]ес1:> 

</ѵіс!ео> 

Элементы <аисІіо> и <ѵісІео> поддерживают атрибут сопіігоіз. Если он присутствует 
(или соответствующее Лѵа8сгірі-свойство имеет значение Тгие), они будут отобра¬ 
жать элементы управления, включая кнопки запуска на воспроизведение и пау¬ 
зы, регулятор громкости и т. д. Но кроме этого, элементы <аис!іо> и <ѵіс!ео> предос¬ 
тавляют прикладной интерфейс, обеспечивающий широкие возможности управ¬ 
ления воспроизведением, с помощью которого вы можете добавлять простые зву¬ 
ковые эффекты в свои веб-приложения или создавать собственные панели 
управления воспроизведением. Несмотря на различия во внешнем виде, элементы 
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<аис!іо> и <ѵіс!ео> предоставляют практически один и тот же прикладной интер¬ 
фейс (единственное отличие между которыми состоит в том, что элемент <ѵісІео> 
имеет свойства ѵѵісіііИ и ИеідИІ:), поэтому большая часть того, что рассказывается 
далее в этом разделе, в равной степени относится к обоим элементам. 

Несмотря на раздражающую необходимость определять мультимедийные дан¬ 
ные в нескольких форматах, возможность воспроизводить звук и видеоизображе¬ 
ние родными средствами броузера без использования дополнительных расшире¬ 
ний является новой мощной особенностью, добавленной стандартом НТМЬб. Об¬ 
ратите внимание, что обсуждение проблемы поддержки кодеков и совместимости 
броузеров выходит далеко за рамки этой книги. В следующих подразделах мы 
сосредоточимся исключительно на методах ^ѵа8сгірі, предназначенных для ра¬ 
боты с аудио- и видеопотоками. 


Конструктор Аис1іо() 

Элементы <аис!іо> не имеют визуального представления в документе, если 
не установить атрибут сопіігоіз. И так же, как имеется возможность созда¬ 
вать неотображаемые изображения с помощью конструктора Ітаде( ), меха¬ 
низм поддержки мультимедиа, определяемый стандартом НТМЬб, позво¬ 
ляет создавать аудиоэлементы с помощью конструктора АисІіоО, передавая 
ему аргумент с ЬГКЬ-адресом источника данных: 

пем АисИо("сИіте.маѵ")-р1ауО; // Загрузить и проиграть звуковой эффект 

Конструктор АисІіоО возвращает тот же объект, который будет получен при 
обращении к элементу <аисІіо> в документе или при создании нового аудио¬ 
элемента вызовом сІоситепІі.сгеаІіеЕІетепІіГаисІіо"). Обратите внимание, что 
все вышесказанное относится только к аудиоэлементам: механизм поддерж¬ 
ки мультимедиа не имеет соответствующего конструктора ѴісІео( ). 


21.2.1. Выбор типа и загрузка 

Если вам потребуется проверить, способен ли мультимедийный элемент воспро¬ 
изводить мультмедийные данные в определенном формате, передайте МІМЕ-тип 
этих данных (при необходимости с параметром сосіес) методу сапР1ауТуре(). Эле¬ 
мент вернет пустую строку (ложное значение), если он не способен проигрывать 
мультимедийные данные в этом формате. В противном случае он вернет строку 
«шауЬе» (возможно) или «ргоЬаЫу» (вероятно). Из-за сложной природы аудио- 
и видеокодеков проигрыватель в общем случае не может сообщить ничего более 
определенного, чем «ргоЬаЫу» (вероятно), не предприняв фактическую попытку 
загрузить и воспроизвести данные указанного типа: 

ѵаг а = пем АисІіоО; 
іі (а. сапР1ауТуре("аисІіо/\маѵ")) { 
а. зге = " зоипсіе^і'есі: . ѵуаѵ" ; 
а.рІауО; 

} 
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Когда свойству зге мультимедийного элемента присваивается значение, он начи¬ 
нает процесс загрузки мультимедийных данных. (Этот процесс не продвинется 
слишком далеко, если не установить в свойстве ргеіоасі значение «аиіо».) При¬ 
сваивание нового значения свойству зге во время загрузки или воспроизведения 
других мультимедийных данных прервет загрузку или воспроизведение старых 
данных. Если вместо настройки атрибута зге вы будете добавлять в мультиме¬ 
дийный элемент элементы <зоигсе>, то он не сможет приступить к выбору нужно¬ 
го элемента, так как не будет знать, когда закончится формирование полного 
комплекта элементов <зоигсе>, и не сможет начать загрузку данных, пока явно не 
будет вызван метод 1оас1(). 

21.2.2. Управление воспроизведением 

Самыми важными методами элементов <аис!іо> и <ѵіс!ео> являются методы р1ау() 
и раизе(), которые запускают и останавливают воспроизведение: 

// Когда документ будет загружен, запустить фоновое проигрывание мелодии 
\ѵіпс!оѵѵ.ас1с1Еѵеп1:Ііз1:епе г( "Іоасі" , Гипс1ііоп() { 

сіоситепі:. деі: ЕІетепІіВуІсІ ("тизіе"). р1ау(); 

}, Шзе); 

Помимо возможности запустить и остановить проигрывание звука или видео име¬ 
ется возможность выполнить переход к требуемому месту в мультимедийных дан¬ 
ных установкой свойства сиггепШте. Это свойство определяет время в секундах, 
к которому должен быть выполнен переход, и его можно устанавливать в процессе 
проигрывания данных или во время паузы. (Свойства іпіІііаІТіте и сіигаіііоп огра¬ 
ничивают диапазон допустимых значений свойства сиггепШте; подробнее об этих 
свойствах рассказывается ниже.) 

Свойство ѵоіите определяет уровень громкости как числовое значение в диапазо¬ 
не от 0 (минимальная громкость) до 1 (максимальная громкость). Свойству гтшііесі 
может быть присвоено значение Іігие, чтобы выключить звук, или 1"а1зе, чтобы 
продолжить воспроизведение с установленным уровнем громкости. 

Свойство рІауЬаскРаІіе определяет скорость проигрывания. Значение 1,0 соответ¬ 
ствует нормальной скорости. Значения выше 1 соответствуют «ускоренному вос¬ 
произведению вперед», а значения от 0 до 1 - «замедленному воспроизведению 
вперед». Отрицательные значения предполагают проигрывание звука или видео 
в обратном направлении, но на момент написания этих строк броузеры не поддер¬ 
живали такую возможность. Элементы <аисІіо> и <ѵісІео> также имеют свойство 
с!е1 = аи11:Р1ауЬаскЯа1:е. Всякий раз, когда вызывается метод р1ау(), значение свойства 
сіе1 : аиГІіР1ауЬаскРа1іе присваивается свойству рІауЬаскРаІіе. 

Обратите внимание, что свойства сиггепШте, ѵоіите, тиіесі и рІауЬаскВаІіе не явля¬ 
ются единственными средствами управления воспроизведением. Если элемент 
<аисІіо> или <ѵісІео> имеет атрибут сопіігоіз, он отображает элементы управления 
проигрывателем, давая пользователю возможность управлять воспроизведением. 
В этом случае сценарий может читать значения таких свойств, как тиіесі и сиггепіі- 
Тіте, чтобы определить, как протекает воспроизведение мультимедийных данных. 

НТМЬ-атрибуты сопіігоіз, Іоор, ргеіоасі и аиіоріау оказывают влияние на воспроиз¬ 
ведение аудио и видео, а также доступны для чтения и записи как ^ѵа8сгірі-свой- 
ства. Атрибут сопіігоіз определяет, должны ли отображаться элементы управления 
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проигрывателем. Присвойте этому свойству значение Іігие, чтобы отобразить эле¬ 
менты управления, или ^аіае, чтобы скрыть их. Логическое свойство Іоор опреде¬ 
ляет, должно ли воспроизведение начинаться сначала по достижении конца (Іігие) 
или нет (1"аІ8е). Свойство ргеіоасі определяет, какой объем мультимедийных дан¬ 
ных должен быть загружен прежде, чем пользователь сможет запустить проигры¬ 
вание. Значение «попе» означает, что предварительная загрузка данных не требу¬ 
ется. Значение «теіасіаіа» означает, что предварительно должны быть загружены 
такие метаданные, как продолжительность, битрейт и размер кадра, но предвари¬ 
тельная загрузка самих данных не требуется. При отсутствии атрибута ргеіоасі 
броузеры обычно загружают только метаданные. Значение «аиіо» означает, что 
броузер должен предварительно загрузить такой объем данных, какой он сочтет 
нужным. Наконец, свойство аиііоріау определяет, должно ли начаться воспроизве¬ 
дение автоматически, после загрузки достаточного объема данных. Присваива¬ 
ние свойству аиііоріау значения ігие подразумевает, что броузер должен предвари¬ 
тельно загрузить некоторый объем данных. 

21.2.3. Определение состояния 
мультимедийных элементов 

Элементы <аисііо> и <ѵісіео> имеют несколько свойств, доступных только для чте¬ 
ния, которые описывают текущее состояние данных и проигрывателя. Свойство 
раиоесі имеет значение Іігие, если проигрывание было приостановлено. Свойство 
оеекіпд имеет значение Іігие, если проигрыватель выполняет переход к новой по¬ 
зиции в проигрываемых данных. Свойство епсіесі имеет значение Іігие, если проиг¬ 
рыватель достиг конца и остановился. (Свойство епсіесі никогда не приобретет зна¬ 
чение ігие, если свойству Іоор было присвоено значение Іігие.) 

Свойство сіигаіііоп определяет продолжительность проигрываемых данных в се¬ 
кундах. Если прочитать это свойство до того, как будут получены метаданные, 
оно вернет значение №М. Для потоковых данных с неопределенной продолжитель¬ 
ностью, например, при прослушивании Интернет-радио, это свойство возвращает 
значение Іпі'іпіііу. 

Свойство іпШаІТіте определяет начальное время в проигрываемых данных в се¬ 
кундах. Для мультимедийных клипов с фиксированной продолжительностью 
это свойство обычно имеет значение 0. Для потоковых данных это свойство воз¬ 
вращает самое раннее время данных в буфере, к которому еще можно вернуться. 
Свойство сиггепІТіте не может быть установлено в значение меньше чем значение 
свойства іпіІіаІТіте. 

Три других свойства позволяют получить более точное представление о времен¬ 
ной шкале для проигрываемых данных и состоянии механизма буферизации. 
Свойство ріауесі возвращает диапазон или диапазоны времени, проигрываемые 
в настоящее время. Свойство Ьиі^егесі возвращает диапазон или диапазоны вре¬ 
мени, которые в настоящее время находятся в буфере, а свойство аеекаЫе возвра¬ 
щает диапазон или диапазоны времени, куда проигрыватель может выполнить 
переход. (Эти свойства можно использовать для реализации индикатора, иллю¬ 
стрирующего свойства сиггепШте и сіигаіііоп, а также продолжительность воспро¬ 
изведенных данных и объем данных в буфере.) 

Свойства ріауесі, Ьиі^егесі и аеекаЫе являются объектами ТітеПапдеа. Каждый объ¬ 
ект имеет свойство ІепдіР, определяющее количество представляемых им диапа- 
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зонов, и методы з*аг*() и епс!(), возвращающие начало и конец (в секундах) диапа¬ 
зона с указанным номером. В наиболее типичном случае, когда имеется всего 
один непрерывный диапазон, эти методы вызываются, как 5Ііаг1і(0) и епс1(0). Если ѵ 
к примеру, предположить, что переходы не выполнялись и данные буферизованы 
с самого начала, то можно использовать следующий прием, чтобы определить, 
какая доля ресурса в процентах была загружена в буфер: 

ѵаг регсепШоасІес! = МаТМ. Иоог(5опд. ЬиГГегесІ.епсІ(О) / зопд. сіигаііоп * 100); 

Наконец, имеются еще три свойства, геасІуЗііаІіе, пеІімогкЗІіаІіе и еггог, позволяющие 
получить низкоуровневую информацию о состоянии элементов <аис!іо> и <ѵіс!ео>. 
Все эти свойства имеют числовые значения, и для каждого допустимого значения 
определена константа. Обратите внимание, что эти константы определены непо¬ 
средственно в мультимедийном объекте (или в объекте ошибки). Эти константы 
можно использовать, как показано ниже: 

іГ (зопд. геасІуЗііаІіе === зопд. НАѴЕ_ЕМ01ЮН_0АТА) зопд.рІауО; 


Свойство геасІуЗііаІіе определяет, как много мультимедийных данных было загру¬ 
жено, и, соответственно, готов ли элемент начать воспроизведение этих данных. 
Допустимые значения этих свойств и их смысл перечислены ниже: 


Константа 

Значение 

Описание 

НАѴЕ_М0ТШ6 

0 

Мультимедийные данные и метаданные еще не были загру¬ 
жены. 

НАѴЕ_МЕТА0АТА 

1 

Метаданные были загружены, но мультимедийные данные 
для текущей позиции воспроизведения еще не были загру¬ 
жены. Это означает, что имеется возможность узнать про¬ 
должительность воспроизведения или размеры кадра видео¬ 
клипа, а также выполнить переход к другой позиции, уста¬ 
новив свойство сиггепШте, но броузер в настоящий момент 
не может воспроизводить в позиции сиггепШте. 

НАѴЕ_СІШПЕ[ГГ_ОАТА 

2 

Мультимедийные данные для позиции сиггепШте были за¬ 
гружены, но объем загруженных данных еще недостаточен, 
чтобы начать воспроизведение. Для видеоклипов это обычно 
означает, что текущий кадр был загружен, а следующий еще 
нет. Это состояние возникает в конце аудио- или видеоклипа. 

НАѴЕ_РІІТІЖЕ_ОАТА 

3 

Был загружен достаточный объем данных, чтобы начать 
воспроизведение, но их недостаточно, чтобы воспроизвести 
клип до конца без приостановки на загрузку дополнитель¬ 
ных данных. 

НАѴЕ.ЕШОН.ОАТА 

4 

Был загружен достаточный объем данных, чтобы их, скорее 
всего, можно было воспроизвести до конца, без приостановки. 


Свойство пеІіѵѵ/огкЗііаІіе определяет, использует ли (и если нет, то почему) сеть муль¬ 
тимедийный элемент: 


Константа 

Значение 

Описание 

ЫЕТѴл/ОВК_ЕМРТУ 

0 

Элемент еще не приступил к использованию сети. Это со¬ 
стояние возникает, например, перед установкой атрибута 



5ГС. 
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Константа 

Значение 

Описание 

ЫЕТ\л/ОВК_ЮЬЕ 

1 

В настоящее время элемент не загружает данные из сети. 
Возможно, он загрузил ресурс полностью или сохранил 
в буфере достаточный объем требуемых данных. Или, воз¬ 
можно, свойству ргеіоасі было присвоено значение «попе» 
и элементу еще не была дана команда загружать или вос¬ 
производить клип. 

№ТІ/\ЮПК_І_0А0І[^0 

2 

В настоящее время элемент загружает данные из сети. 

ЫЕТЫ0ВК_Ы0_ЗО11ВСЕ 

3 

Элемент не может отыскать источник данных, которые 
требуется воспроизвести. 


Когда при загрузке или воспроизведении возникает ошибка, броузер записывает 
определенное значение в свойство еггог элемента <аис!іо> или <ѵіс!ео>. При отсутст¬ 
вии ошибок свойство еггог имеет значение пиіі. Иначе оно ссылается на объект 
с числовым свойством с о сіе, описывающим ошибку. Объект ошибки также опре¬ 
деляет константы для возможных кодов ошибок: 


Константа 

Значение 

Описание 

МЕ01А_ЕВВ_АВ0ВТЕ0 

1 

Пользователь потребовал остановить загрузку 
клипа. 

МЕОІ А_ЕВВ_ЫЕТ1л/0ВК 

2 

Мультимедийные данные имеют верный тип, но 
их загрузке препятствуют ошибки в сети. 

МЕ01А_ЕВВ_0ЕССЮЕ 

3 

Мультимедийные данные имеют верный тип, но 
их декодированию и воспроизведению препятст¬ 
вуют ошибки кодирования. 

МЕОІ А_ЕВВ_ЗВС_Ы0Т_31)РР0ВТЕ0 

4 

Мультимедийные данные, на которые ссылается 
атрибут 5 гс, имеют тип, который не может вос¬ 
производиться броузером. 


Свойство еггог можно использовать, как показано ниже: 

іТ (зопд. еггог. сосіе == зопд.еггог.МЕ01А_ЕПП_0ЕССЮЕ) 

а1ег1:("Невозможно воспроизвести песню: повреждены аудиоданные."): 

21.2.4 События мультимедийных элементов 

Элементы <аис!іо> и <ѵіс!ео> являются довольно сложными элементами - они долж¬ 
ны откликаться на взаимодействие пользователя с их элементами управления, 
выполнять сетевые операции и даже, в процессе воспроизведения, реагировать на 
простое течение времени. Мы только что видели, что эти элементы имеют доволь¬ 
но много свойств, определяющих их состояние. Подобно большинству НТМЬ-эле- 
ментов, элементы <аис!іо> и <ѵіс!ео> генерируют события при изменении своего со¬ 
стояния. Поскольку состояние этих элементов описывается множеством харак¬ 
теристик, они могут генерировать довольно много различных событий. 

В таблице ниже перечислены 22 события мультимедийных элементов, примерно 
в том порядке, в каком они обычно возникают. Элементы не имеют свойств обра¬ 
ботчиков этих событий, поэтому для регистрации функций обработчиков в эле¬ 
ментах <аис1іо> и <ѵіс!ео> следует использовать метод асісіЕѵеп1:І_із1:епег(). 
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Тип события 

Іоасізііагіі 

ргодгезз 

Іоасіесітеііасіаііа 

Іоасіесісіаііа 

сапріау 

сапріауіііігоидіі 

зизрепсі 

зіаПесІ 

ріау 

ѵу/аіііпд 

ріауіпд 

1:ітеирсІа1:е 

раизе 

зеекіпд 

зеекесі 

епсіесі 

сіигаіііопсііапде 

ѵоіитесйапде 

гаТесМапде 

аЬогІ 

еггог 

етрііесі 


Описание _ 

Возбуждается, когда элемент отправляет запрос на получение мультиме¬ 
дийных данных.Свойство пе1:\ѵогк31;а1:е имеет значение ЫЕТ\л/ОВК_ЬОАОІЫО. 

Загрузка мультимедийных данных продолжается. Свойство пеіѵюгкзіаіе 
имеет значение МЕТІ/\ЮПК_І_0А0І№. Это событие обычно возбуждается от 2 до 
8 раз в секунду. 

Метаданные загружены, и доступна информация о продолжительности 
клипа и размерах кадра. Свойство геасІуЗіаІіе в первый раз получает зна¬ 
чение НАѴЕ_МЕТАОАТА. 

Данные для текущей позиции воспроизведения загружены, а свойство 
геасІуЗііаІіе получает значение НАѴЕ_СІШЕМТ_ОАТА. 

Загружен достаточный объем данных, чтобы начать воспроизведение, но, 
скорее всего, необходимо загрузить в буфер дополнительный объем дан¬ 
ных. Свойство геасІуЗііаІіе имеет значение НАѴЕ_РІЛІЖЕ_ОАТА. 

Загружен достаточный объем данных, чтобы наверняка воспроизвести 
клип до конца без дополнительных пауз для буферизации дополнитель¬ 
ных данных. Свойство геасІуЗііаІіе имеет значение НАѴЕ_ЕМ01ЮН_0АТА. 

Элемент загрузил в буфер достаточный объем данных и временно приос¬ 
тановил загрузку. Свойство пеІіѵюгкЗІіаІіе получает значение МЕТІ/\ЮВК_ЮІ_Е. 

Элемент пытается загрузить данные, но данные не поступают из сети. 
Свойство пеІѵѵогкЗііаііе остается в состоянии ЫЕТІ/\ЮПК_І_0А0ІЫ6. 

Был вызван метод р1ау() или воспроизведение было автоматически запу¬ 
щено из-за наличия атрибута аиііоріау. Если был загружен достаточный 
объем данных, вслед за этим событием последует событие «ріауіпд». Ина¬ 
че последует событие «лѵаіііп&». 

Воспроизведение не может быть начато или оно было приостановлено из-за 
недостатка данных в буфере. Когда будет загружен достаточный объем 
данных, последует событие «ріауіпд». 

Начато воспроизведение клипа. 

Изменилось значение свойства сиггепііТіте. В процессе воспроизведения 
это событие генерируется от 4 до 60 раз в секунду в зависимости от на¬ 
грузки на систему и скорости выполнения обработчиков событий. 

Был вызван метод раизе(), и воспроизведение было приостановлено. 

Сценарий или пользователь потребовал перейти к участку клипа, отсут¬ 
ствующему в буфере, и воспроизведение было остановлено до загрузки 
данных. Свойство зеекіпд получает значение Ігие. 

Свойство зеекіпд получает значение Гаізе. 

Воспроизведение было остановлено по достижении конца клипа. 

Изменилось значение свойства Ригаііоп. 

Изменилось значение свойства ѵоіите или тиіесі. 

Изменилось значение свойства рІауЬаскПаІіе или РеГаиІІіРІауЬаскПаІіе. 

Элемент прекратил загрузку данных. Обычно это происходит по требова¬ 
нию пользователя. Свойство еггог. сосіе получает значение МЕ01А_ЕПП_АВ0ПТЕ0. 

Сетевая или какая-либо другая ошибка не дает возможности загрузить 
данные. Свойство еггог. сосіе получает любое другое значение, отличное от 
МЕ01А_ЕПП_АВ0ПТЕ0. 

В результате события «еггог» или «аЪогі» свойство пеІіѵюгкЗііаІіе получило 
значение ЫЕТ1л/0ВК_ЕМРТУ. 
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21.3.5Ѵ0 - масштабируемая векторная графика 

Масштабируемая векторная графика (8ѴС) - это грамматика языка ХМЬ для опи¬ 
сания графических изображений. Слово «векторная» в названии указывает на 
фундаментальное отличие от таких форматов растровой графики, как СІГ, ^ЕС 
и РЫС, где изображение задается матрицей пикселов. Формат 8ѴС представляет 
собой точное, не зависящее от разрешения (отсюда слово «масштабируемая») опи¬ 
сание шагов, которые необходимо выполнить, чтобы нарисовать требуемый рису¬ 
нок. Вот пример простого 8ѴС-изображения в текстовом формате: 

<!-- Начало рисунка и объявление пространства имен --> 

<зѵд хт1пз="Н11р://шм.мЗ. огд/2000/зѵд'' 

ѵіе\л/Вох="0 0 1000 1000"> <!-- Система координат рисунка --> 

<сіе1 = з> <!-- Настройка некоторых определений --> 

<1 іпеа гС гасііепі: ісІ=' , '( : асІе"> <!-- Цветовой градиент с именем ” ^асіе" --> 

<5Іор о^5е*="0%" 5І:ор-со1ог="#008"/> <!-- Начинаем с темно-синего --> 

<5Іор о^5е*="100%" 5Іор-со1ог="#ссГУ><! --Заканчиваем светло-синим--> 
</1іпеаг0гасІіеп1:> 

</йе^з> 

<!-- 

Нарисовать прямоугольник с тонкой черной рамкой и заполнить его градиентом 

--> 

<гес1 х=" 100” у="200" мі(Ші="800" ІтеідИ1:=” 600" 
з1:гоке="Ыаск'' зігоке-ѵі/ісІ1:Ь="25" - ГШ=''иг1(#1 : асІе)"/> 

</зѵд> 

На рис. 21.1 показано графическое представление этого 8ѴС-файла. 



Рис . 21.1. Простое изображение в формате 8Ѵ0 


8ѴО - это довольно обширная грамматика умеренной сложности. Помимо про¬ 
стых примитивов рисования она позволяет воспроизводить произвольные кривые, 
текст и анимацию. Рисунки в формате 8ѴС могут даже содержать ^ѵа8сгірі-сце- 
нарии и таблицы С88-стилей, что позволяет наделить их информацией о поведе- 
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нии и представлении. В этом разделе показано, как с помощью клиентского Лѵа- 
8сгірі-кода (встроенного в НТМЬ-, а не в 8ѴС-документ) можно динамически соз¬ 
давать графические изображения средствами 8ѴС. Приводимые здесь примерь; 
8ѴО-изображений позволяют лишь отчасти оценить возможности формата 8ѴО. 
Полное описание этого формата доступно в виде обширной, но вполне понятной 
спецификации, которая поддерживается консорциумом АѴЗС и находится по адре¬ 
су кіір://іѵипѵ.іѵ3.ог8/ТВ/8ѴО/. Обратите внимание: эта спецификация включает 
в себя полное описание объектной модели документа (БОМ) для 8ѴО-документов. 
В данном разделе рассматриваются приемы манипулирования 8ѴО-графикой 
с помощью стандартной модели ХМЬ БОМ, а модель 8ѴО БОМ не затрагивается. 

К моменту написания этих строк все текущие веб-броузеры, кроме ІЕ, имели 
встроенную поддержку формата 8ѴО (она также будет включена в ІЕ9). В послед¬ 
них версиях броузеров отображать 8ѴС-изображения можно с помощью обычно¬ 
го элемента <ітд>. Некоторые немного устаревшие броузеры (такие как Еігеіох 3.6) 
не поддерживают такую возможность и требуют использовать для этих целей 
элемент <оЬ]ес1:>: 

<оЬ^ есі: с!а1:а=" затріе . зѵд" Іуре="ітаде/зѵд+хт1" ѵѵіс!1:Гі='' 100" ііеідШ="100"/> 

При использовании в элементе <ітд> или <оЬ]ес1:> 8ѴС можно рассматривать как 
еще один формат представления графических изображений, который, с точки 
зрения программиста на языке ЛаѵаЗсгірі;, ничем особенным не выделяется. Го¬ 
раздо больший интерес представляет сама возможность встраивания 8ѴО-изобра- 
жений непосредственно в документы и выполнения операций над ними. Посколь¬ 
ку формат 8ѴС является грамматикой языка ХМЬ, изображения в этом формате 
можно встраивать непосредственно в ХНТМЬ-документы, как показано ниже: 

<?хт1 ѵегзіоп="1 .0"?> 

<!-- Объявить НТМЬ как пространство имен по умолчанию, а ЗѴС - с префиксом ''зѵд:" --> 
<Шт1 хт1пз=''Н11р://мш.мЗ. о гд/1999/хМ:т1" 

хт1пз:зѵд="ІгЫ:р://ѵлл/ѵ/. м3. огд/2000/зѵд"> 

<ЬосІу> 

Это красный квадрат: <зѵд:зѵд місІ1:Н="10" НеідШ="10"> 

<зѵд:гес1: х="0" у="0” місІ1:Н="10" ГіеідГі1:=" 10” Гі11="гесІ"/> 

</зѵд:зѵд> 

Это голубой круг: <зѵд:зѵд місІ1:Н="10" НеідІтЬ="10"> 

<зѵд:сігс1е сх="5" су="5" г="5" Гі11="Ыие"/> 

</зѵд:зѵд> 

</ЬосІу> 

</Шт1> 

Этот прием можно использовать во всех текущих броузерах, кроме ІЕ. На рис. 21.2 
показано, как Еігеіох отображает этот ХНТМЬ-документ. 


Файл Правка Вид Переход Закладки Инструменты Справка •$ 
\?* ' V* А в ІІІ ('*' [б Н Ш: Перейти Ш _ 


Это красный квадрат: ш Это голубой круг: * 



Рис. 21.2. ЗѴО-графика в ХНТМЬ-документпе 
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Стандарт НТМЬб сокращает количество различий между ХМЬ и НТМЬ и позво¬ 
ляет вставлять разметку на языке 8ѴС (и МаіЬМЬ) непосредственно в НТМЬ- 
файлы, без объявления пространств имен или префиксов тегов: 

<! РОСТУ РЕ Ыт1> 

<М1:т1> 

<ЬосІу> 

Это красный квадрат: <зѵд \ѵісІ1:И=" 10" ИеідМ1:=" 10"> 

<гес1: х="0" у="0" \л/ісІ1:И=" 10" ИеідИ1:=" 10" Ті11="гесІ"/> 

</зѵд> 

Это голубой круг: <зѵд \ѵісІ1:Н="10" МеідІтІ:= , '10"> 

<сігс1е сх="5" су="5" г="5" Ш1="Ыце"/ > 

</зѵд> 

</ЬосІу> 

</Іп1:т1> 

На момент написания этих строк непосредственное встраивание 8ѴО-изображе- 
ний в разметку НТМЬ поддерживали только самые последние версии броузеров. 

Так как формат 8ѴС - это грамматика языка ХМЬ, рисование 8ѴС-изображений 
заключается просто в использовании модели БОМ для создания соответствую¬ 
щих ХМЬ-элементов. В примере 21.2 приводится реализация функции ріеСИаг1:( ), 
которая создает 8ѴС-элементы для воспроизведения круговой диаграммы, по¬ 
добной той, что показана на рис. 21.3. 



Шшт 

ш ш ш 

жшям 


Шщтж Ш|у 


Щайл^ГОраРка %ід 


Журнал Йнструнантьі 


ѴІѴІѴІѴІѴІ"ІѴЛ , ІѴІ>Ѵ.ѴІѴІѴІ-ЛЧѴІ*.ѴІѴІѴІ*ЛѴІѴѴѴІѴѴІ-І 


Щ Север 
«Юг 
□ Восток 
ШЗапад 




Рис, 21,3, Круговая диаграмма в формате 8ѴО, построенная ^аѵа8с^ір^-сценарием 

Пример 21,2, Рисование круговой диаграммы средствами № ѵа8сгірі и 8ѴО 

I * * 

* Создает элемент <зѵд> и рисует в нем круговую диаграмму. 

* Аргументы: 

* сіаіа: массив чисел для диаграммы, по одному для каждого сектора. 

* ѵуісіііИ, ИеідЫ: : размеры $Ѵ6-изображения в пикселах 

* сх, су, г: координаты центра и радиус круга 

* соіогз: массив цветов в формате НТМЬ, по одному для каждого сектора 

* ІаЬеІз: массив меток для легенды, по одной для каждого сектора 
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* 1х, 1у: координаты левого верхнего угла легенды диаграммы 

* Возвращает: 

* Элемент <зѵд>, хранящий круговую диаграмму. 

* Вызывающая программа должна вставить возвращаемый элемент в документ. 

*/ 

Гипсііоп ріеСГіагІ:(сіаііа, \л/іРІЬ, ЬеідЫ:, сх, су, г, соіогз, ІаЬеІз, 1х, 1у) { 

// Пространство имен ХМЬ для элементов зѵд 
ѵаг зѵдпз = "Ь11р://ш\ѵ.\л/3. огд/2000/зѵд"; 

// Создать элемент <зѵд>, указать размеры в пикселах и координаты 
ѵаг сЬаП = Роситет. сгеаІеЕІетепІіМЗСзѵдпз, "зѵд:зѵд"); 
сЬагі. зеТАТТгіЬиТеС'ѵ/іРТІі", ѵѵісИіИ); 
сЬаП . зеТАТТ гіЬыТеС"ЬеідГіІ:’’, ЬеідЫ:); 

сЬаП. зе1:А1:1:гіЬц1:е("ѵіе\л/Вох", "0 0 " + ѵаРІЬ + " " + ГіеідИІ:); 

// Сложить вместе все значения, чтобы получить общую сумму всей диаграммы 
ѵаг тотаі = 0; 

Гог(ѵаг і = 0; і < Раіа.ІепдіЬ; і++) іоіаі += Раіа[і]; 

// Определить величину каждого сектора. Углы измеряются в радианах, 
ѵаг апдіез = [] 

Гог(ѵаг і = 0; і < Раіа.ІепдіЬ; і++) апд1ез[і] = РаТа[і]Доі:а1*МаТІі.РІ.*2: 

// Цикл по всем секторам диаграммы, 
зіагіапдіе = 0: 

Гог(ѵаг і = 0; і < Раіа.ІепдІЬ; і++) { 

// Точка, где заканчивается сектор 
ѵаг епрапдіе = зііагііапдіе + апд1ез[і]; 

// Вычислить координаты точек пересечения радиусов, образующих сектор, 
// с окружностью. В соответствии с выбранными формулами углу 0 радиан 
// соответствует точка в самой верхней части окружности, 

// а положительные значения откладываются от нее по часовой стрелке. 

ѵаг хі = сх + г * МаІЬ.зіп(зііагііапдіе ); 

ѵаг уі = су - г * МаІЬ. соз( зііагііапдіе ); 

ѵаг х2 = сх + г * МаТП. зіп(епрапдіе ); 

ѵаг у2 = су - г * МаТП. соз(епрапдіе); 


// Это флаг для углов, больших половины окружности. 

// Он необходим 8Ѵ0-механизму рисования дуг 
ѵаг Ыд = 0; 

іТ (епрапдіе - зіагіапдіе > МаІП.РІ) Ьід = 1; 

// Мы описываем сектор с помощью элемента <зѵд :раІІі>. 

// Обратите внимание, что он создается вызовом сгеа1:еЕ1етеп1;МЗ() 
ѵаг раІП = Росіітепі:.сгеаІеЕ1етеп1:МЗ(зѵдпз, "раІН"); 


// Эта строка хранит информацию о контуре, 
ѵаг Р = "М " + сх + + су + // Начало 


•• •• 

+ хі + "," + уі + 

// 

.. Д .. 

+ г + "," + г + 

// 

.. 0 .. 

+ Ьід + ” і - + 

// 

х2 + 

V + у2 + 

// 

.. г . 


и 


образующем сектор 
в центре окружности 
Нарисовать линию к точке (хі.уі) 
Нарисовать дугу с радиусом г 
Информация о дуге... 

Дуга заканчивается в точке (х2,у2) 
Закончить рисование в точке (сх.су) 


// Теперь установить атрибуты элемента <зѵд:ра1:Н> 

раІН. зе1;А1:1: гіЬи1:е("Р", Р); // Установить описание контура 

раіііт.зе1:А1:1:гіЬи1:е("Тііі”, со1огз[і]); // Установить цвет сектора 

ра*Н.5е*А«гіЬи*е("5*гоке", "Ыаск”); // Рамка сектора - черная 
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раІЬ. зеІАІігіЬиІе("зІгоке-\л/ісІ1:Ь", "2"); // 2 единицы толщиной 
сЬаП. аррепсІСЬіІсКраіЬ); // Вставить сектор в диаграмму 

т 

// Следующий сектор начинается в точке, где закончился предыдущий 
зіагііапдіе = епсіапдіе; 

// Нарисовать маленький квадрат для идентификации сектора в легенде 
ѵаг ісоп = Роситеп1:.сгеаІеЕ1етеп1:Н$(5ѵдп5, " гесі"); 
ісоп.зеіАІігіЬціеС'х", 1х); // Координаты квадрата 

ісоп. зеіАіігіЬціеС'у", 1у + 30*і); 

ісоп. зе1:А1:1: гіЬи1:е( ”\л/ісІ1:И". 20); // Размер квадрата 

ісоп. зеІАПгіЬиІеС'НеідНІ:'', 20); 

ісоп.зе1:А1:1:гіЬи1:е("іі1Г', со1огз[і]); // Тем же цветом, что и сектор 
ісоп.зеІАІІігіЬиІеС'зІігоке", "Ыаск"); // Такая же рамка, 
ісоп.зе1:А1:1:гіЬи1:е("зТгоке-хѵісНИ". "2"); 

сЬаП. аррепсІСЬіІсІ(ісоп); // Добавить в диаграмму 

// Добавить метку правее квадрата 

ѵаг ІаЬеІ = Роситепі.сгеаІеЕІетепІНЗСзѵдпз, "Іехі"); 

ІаЬеІ. зеІіАІіІ:гіЬи1:е("х", 1х + 30); // Координаты текста 

ІаЬеІ. зе1:А1:1: гіЬи1:е( "у", 1у + 30*і + 18); 

// Стиль текста можно также определить посредством таблицы С5$-стилей 
ІаЬеІ.зеІАІІгіЬиіе("іоп1:-іаті1у", "запз-зегіі"); 

ІаЬеІ.зе1:А1:1:гіЬи1:е(”^опіі-зіге", "16"); 

// Добавить текстовый ООМ-узел в элемент <зѵд:1:ех1:> 

ІаЬеІ. аррепсІСЬі1сІ(сІоситеп1:. сгеаТеТехіИосІеС 1аЬе1з[ і ])); 

сЬаП. аррепсІСЬіІсІ(ІаЬеІ); // Добавить текст в диаграмму 

} 

геіигп сЬагі; 

} 

Программный код в примере 21.2 относительно прост. Здесь выполняются неко¬ 
торые математические расчеты для преобразования исходных данных в углы 
секторов круговой диаграммы. Однако основную часть примера составляет про¬ 
граммный код, создающий 8ѴО-элементы и выполняющий настройку их атрибу¬ 
тов. Чтобы этот пример мог работать в броузерах, не полностью поддерживаю¬ 
щих стандарт НТМЬб, здесь формат 8ѴО интерпретируется как грамматика ХМЬ 
и вместо метода сгеа1:еЕ1етеп1:() используются пространство имен 8ѴО и метод 
сгеа1:еЕ1етеп1:Ы8(). 

Самая малопонятная часть этого примера - программный код, выполняющий ри¬ 
сование сектора диаграммы. Для отображения каждого сектора используется тег 
<зѵд:ра1:Ь>. Этот 8ѴС-элемент описывает рисование произвольных фигур, состоя¬ 
щих из линий и кривых. Описание фигуры определяется атрибутом сі элемента 
<зѵд:ра1:Ь>. Основу описания составляет компактная грамматика символьных ко¬ 
дов и чисел, определяющих координаты, углы и прочие значения. Например, 
символ М означает «тоѵе Іо» (переместиться в точку), и вслед за ним должны сле¬ 
довать координаты X и У точки. Символ Ь означает «Ипе іо» (рисовать линию до 
точки); он рисует линию от текущей точки до точки с координатами, которые сле¬ 
дуют далее. Кроме того, в этом примере используется символьный код А, кото¬ 
рый рисует дугу (агс). Вслед за этим символом следуют семь чисел, описывающих 
дугу. Точное описание нас здесь не интересует, но вы можете найти его в специ¬ 
фикации по адресу Мір://іѵіѵіѵ.іѵ3.огё/ТН/8ѴО/. 
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Обратите внимание, что функция ріеСііаг1:() возвращает элемент <зѵд>, содержа¬ 
щий описание круговой диаграммы, но она не вставляет этот элемент в документ. 
Предполагается, что это будет делать вызывающая программа. Диаграмма, изо¬ 
браженная на рис. 21.3, была создана с помощью следующего файла: 

<И1:т1> 

<ИеасІ> 

<зс гірі: згс="РіеСІіаг1:.]5"></5сг.ірі:> 

</ИеасІ> 

<ЬосІу оп1оасІ="сІоситеп1:. Ьосіу. аррепсІСШсК 

ріеСИагИ([12. 23, 34, 45], 640, 400, 200, 200, 150, 

['красный','синий’,'желтый', 'зеленый'], 

['Север','Юг', 'Восток', 'Запад'], 400, 100)); 

"> 

</ЬосІу> 

</Шт1> 

В примере 21.3 демонстрируется создание еще одного 8 ѴС -изображения: в нем 
формат 8ѴС используется для отображения аналоговых часов (рис. 21.4). Однако 
вместо создания дерева 8ѴО-элементов с самого начала, в нем используется ста¬ 
тическое 8ѴО-изображение циферблата, встроенное в НТМЬ-страницу. Это ста¬ 
тическое изображение включает два 8ѴО-элемента <1іпе>, представляющих часо¬ 
вую и минутную стрелки. Обе линии направлены вверх, в результате чего стати¬ 
ческое изображение часов показывает время 12:00. Чтобы превратить это изобра¬ 
жение в действующие часы, в примере используется сценарий на языке ^ѵа8сгірі, 
устанавливающий атрибут ІгапзГогт каждого элемента <1іпе> и поворачивающий 
их на углы, соответствующие текущему времени. 



Рис. 21.4. ЗѴО-часы 

Обратите внимание, что в примере 21.3 разметка 8ѴО встроена непосредственно 
в файл НТМЬб и в ней не используются пространства имен ХМЬ, как в ХНТМЬ- 
файле выше. Это означает, что данный пример будет работать только в броузерах, 
поддерживающих возможность непосредственного встраивания разметки 8ѴО. 
Однако если преобразовать НТМЬ-файл в ХНТМЬ, тот же самый прием будет ра¬ 
ботать и в старых броузерах с поддержкой 8ѴО. 

Пример 21.3. Отображение времени посредством манипулирования 

ЗѴО-изображением 

<! Э0СТУРЕ НТМІ_> 

<Шт1> 

<ИеасІ> 

<1Ше>Апа1од С1оск<ДіЛ1е> 




21.3. 5ѴС - масштабируемая векторная графика 


671 


<зсгірі:> 

^ипсііоп ырсІаІіеТіте() { // Обновляет ЗѴ0- изображение часов 

// в соответствии с текущим временем 
ѵаг пом = пем 0а1е(); // Текущее время 

ѵаг тіп = по\ѵ. деТМіпи1:ез( ); // Минуты 

ѵаг Ноцг = (пом. деіНоигз( ) % 12) + тіп/60; // Часы с дробной частью 
ѵаг тіпапдіе = тіп*6; // 6 градусов на минуту 

ѵаг Ноигапдіе = Иоиг*30; // 30 градусов на час 

// Получить ЗѴС-элементы стрелок часов 

ѵаг тіпНапсі = сіоситепі: . де1:Е1етеп1;ВуІсІ("тіпиІіеМапсІ”); 

ѵаг НоигНапсІ = сіоситепі:.де1:Е1етеп1:ВуІсІ("Ігои гИапс!” ); 

// Установить в них ЗѴС-атрибут для перемещения по циферблату 
тіпНапсІ.зеШІігіЬцІіеС'Іігапз^огт", "гоТаТеС' + тіпапдіе + ”,50,50)"); 
ІюигНапсІ.зеІАІІігіЬиІіеС'Іігапз^опп", "гоТаТе(" + Ноигапдіе + ”,50,50)"); 

// Обновлять показания часов 1 раз в минуту 
зе1:Т ітеоиі: ( ирсІаІіеТіте, 60000); 

} 

</зсгірТ> 

<5Іу1е> 

/* Все следующие СЗЗ-стили применяются к ЗѴО-элементам, объявленным ниже */ 
йсіоск { /* общие стили для всех элементов часов */ 

зТгоке: Ыаск; /* черные линии */ 

зігоке-ііпесар: гоііпсі; /* с закругленными концами */ 

НееТ; /* на светлом, голубовато-сером фоне */ 

} 

НТ асе { зІгоке-місІІіП: Зрх;} /* рамка циферблата часов */ 

#Тіскз { зТгоке-мійТІі: 2; } /* метки часов на циферблате */ 

йНоигІіапсІ {зІгоке-місПіІ'і: 5рх;} /* широкая часовая стрелка */ 

йтіпцІеНапсІ {зігоке-місІІіП: Зрх;} /* узкая минутная стрелка */ 

йпцтЬегз { /* стиль отображения цифр на циферблате */ 

^опТ-'РатіІу: запз-зегіі 1 ; ^опі-зііе: 7рТ; ^опі-меідігі: : Ьоісі; 

ІехІ-апсПог: тісісііе; зігоке: попе; Ш1: Ыаск; 

} 

</з1:у1е> 

</ПеасІ> 

<ЬосІу оп1оасІ="ирсІа1;еТіте( )"> 

<!-- ѵіемВох - система координат, місИН и НеідЫ - экранные размеры --> 
<зѵд ісІ="с1оск" ѵіемВох="0 0 100 100” місІ1:Н="500" ПеідІтІ:="500"> 

<сІе^з> <!-- Определить фильтр для рисования теней --> 

<Ш1:ег ісІ="5ПасІом" х="-50%" у=”-50%" місІ1:П="200%" НеідЫ="200%"> 
^ебаиззіапВІиг іп="ЗоигсеА1рПа" 5І:сІ0еѵіа1:іоп="1" гези11:="Ыцг" /> 
<'ГеО^'Гзе1; іп="Ыиг" с!х="1" с!у="1" гезц11:="зПасІом" /> 

<І : еМегде> 

<^еМегдеЫос!е іп="5оцгсе6гарЫс"/><І : еМегдеМосІе іп="зПасІом"/> 
</І : еМегде> 

</Ш*ег> 

</сІе^5> 

<сігс1е ісІ="^асе" сх="50" су="50" г="45"/> <!-- циферблат --> 

<д ісІ="1:іскз"> <!-- 12 часовых меток --> 

<1іпе х1 = '50* у1 = '5.000’ х2='50.00' у2='10.00'/> 

<1іпе х1='72.50' у1=’11.03' х2=’70.00' у2='15.36'/> 

<1іпе х1 = '88.97' у1='27.50' х2='84.64' у2='30.00'/> 

<1іпе хі='95.00' у1='50.00' х2='90.00' у2='50.00'/> 
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<1іпе х1='88.97' у1='72.50' х2='84.64' у2='70.00/> 

<1іпе х1='72.50' у1='88.97' х2='70.00' у2='84.64'/> 

<1іпе х1='50.00' уі='95.00' х2='50.00' у2='90.00'/> 

<1іпе х1='27.50' у1='88.97' х2='30.00' у2='84.64'/> 

<1іпе хі='11.03' уі='72.50' х2='15.36' у2='70.00'/> 

<1іпе х1='5.000' уі=’50.00’ х2='10.00' у2='50.00'/> 

<1іпе хі='11.03' у1='27.50' х2='15.36' у2='30.00'/> 

<1іпе х1='27.50' у1='11.03' х2='30.00' у2='15.36'/> 

</д> 

<д 10="пшпЬегз"> <!— Числа в основных направлениях —> 

<ТехТ х=''50'' у="18">12</Тех1:><1:ех1: х=''85" у=''53”>3</1:ех1:> 

<ТехТ х="50" у= "88 ">6<Дех1:><1:ех1: х=”15" у=''53 ">9</Тех1:> 

</9> 

<!-- Нарисовать стрелки, указывающие вверх. Они вращаются сценарием. —> 

<д ісК'Ьапсіз" ГіІТег="иг1(І(бІіасІом)"> <!-- Добавить тени к стрелкам —> 

<1іпе І0=” (той гііапсі" х1="50" у1="50" х2="50" у2="24"/> 

<1іпе ісІ="тіпи1:еІіап(Г х1=''50" у1="50" х2="50" у2="20"/> 

</д> 

</зѵд> 

</Ьо0у> 

</Н1:т1> 

21.4. Создание графики с помощью 
элемента <сапѵа$> 

Элемент <сапѵаз> не имеет собственного визуального представления, но он создает 
поверхность для рисования внутри документа и предоставляет сценариям на 
языке ^ѵа8сгір1 мощные средства рисования. Элемент <сапѵаз> стандартизован 
спецификацией НТМЬ.5, но существует дольше его. Впервые он был реализован 
компанией Арріе в броузере 8а1агі 1.3 и поддерживался броузерами Еігеіох, на¬ 
чиная с версии 1.5, и Орега, начиная с версии 9. Он также поддерживается всеми 
версиями СЬготе. Элемент <сапѵаз> не поддерживался броузером ІЕ до версии 
ІЕ9, но он с успехом имитировался в ІЕ6, 7 и 8 с помощью свободно распростра¬ 
няемого проекта ЕхрІогегСапѵаз, домашняя страница которого находится по ад¬ 
ресу Мір://со(Іе.ёооёІе.сот/р/ехрІогегсапѵа8/. 

Существенное отличие между элементом <сапѵаз> и технологией 8ѴС заключает¬ 
ся в том, что при использовании элемента <сапѵаз> изображения формируются 
вызовами методов, в то время как при использовании формата 8ѴС изображения 
описываются в виде дерева ХМЬ-элементов. Функционально эти два подхода эк¬ 
вивалентны: любой из них может моделироваться с использованием другого. Од¬ 
нако внешне они совершенно отличаются, и каждый из них имеет свои сильные 
и слабые стороны. Например, из 8ѴС-рисунков легко можно удалять элементы. 
Чтобы удалить элемент из аналогичного рисунка, созданного в элементе <сапѵаз>, 
обычно требуется полностью ликвидировать рисунок, а затем создать его заново. 
Поскольку прикладной интерфейс Сапѵаз основан на синтаксисе Лѵа8сгірі, а реа¬ 
лизация рисунков с его помощью получается более компактной (чем при исполь¬ 
зовании формата 8ѴС), я решил описать его в этой книге. Подробные сведения вы 
найдете в части IV книги в справочных статьях Сапѵаз, СапѵазРепсІегіпдСоп1:ех1:20 
и родственных им. 
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Трехмерная графика в элементе <сапѵа5> 

На момент написания этих строк производители броузеров уже приступи¬ 
ли к реализации прикладного интерфейса рисования трехмерной графики 
в элементе <сапѵаз>. Этот прикладной интерфейс называется ДѴеЬОЬ и явля¬ 
ется связующим звеном между 6аѵа8сгірі и стандартным прикладным ин¬ 
терфейсом ОрепСЬ. Чтобы получить объект контекста для рисования трех¬ 
мерной графики, методу де1Соп1ех{() элемента <сапѵаз> следует передать 
строку «лѵеЬ^І». АѴеЬОЬ - это обширный, сложный и низкоуровневый при¬ 
кладной интерфейс, и он не описывается в этой книге: веб-разработчики, 
скорее всего, предпочтут использовать вспомогательные библиотеки, осно¬ 
ванные на ДѴеЬОЬ, чем непосредственно сам прикладной интерфейс ДУеЪСЬ. 


Большая часть прикладного интерфейса Сапѵаз определена не в элементе <сапѵаз>, 
а в объекте «контекста рисования», получить который можно методом де!Соп1ех{( ) 
элемента, играющего роль «холста». Вызов метода деІСопІехШ с аргументом «26» 
возвращает объект СапѵазРіепсІегіпдСоп1:ех1:20, который можно использовать для 
рисования двухмерной графики. Важно понимать, что элемент <сапѵаз> и объект 
контекста рисования - это два совершенно разных объекта. Поскольку класс объ¬ 
екта контекста имеет такое длинное имя, я редко буду ссылаться на объект Сап- 
ѵазВепс!егіпдСоп1:ех1:20 по имени, а буду просто называть его «объектом контекста». 
Аналогично, когда я буду употреблять термин «прикладной интерфейс Сапѵаз», 
я буду подразумевать «методы объекта СапѵазВепсІегіпдСоп1:ех1:20». 

Ниже приводится НТМЬ-страница, которая может служить простым примером 
использования прикладного интерфейса Сапѵаз. Сценарий в ней рисует красный 
квадрат и голубой круг в элементе <сапѵаз>, как показано на рис. 21.2: 


<Ьос1у> 

Это красный квадрат: <сапѵаз іс1="5диаге" ѵѵ/іс!1:М=10 МеідЫ:=10></сапѵаз>. 

Это голубой круг: <сапѵаз Іс1="сігс1е" ѵѵ/іс!1:М=10 МеідЫ:=10></сапѵаз>. 

<зсгірі:> 

ѵаг сапѵаз = боситепі:. де1:Е1етепі:ВуІс1("5диаге"); // Найти первый элемент сапѵаз 


ѵаг сопіехі: = сапѵаз.деіСопіехІ(”2<Г); 
сопіехі. ■РіІІЗіуІе = 
сопіехі. НПРесКО, 0,10,10); 

сапѵаз = сіоситепі:. де1:Е1етепі:ВуІс1( ”сі гсіе”) 
сопіехі: = сапѵаз. де*СопіехІ("2<Г); 
сопіехі:. ЬедіпРаі:П(): 

сопіехІ.агсСб, 5, 5, 0, 2*Маі:П.РІ, ігие); 
сопіехі. ШІЗііуІе = "Я00Г'; 
сопіехі. НПО; 

</зсгірі> 

</Ьос1у> 


// Получить 2-мерный контекст 
// Цвет заливки - красный 
// Залить квадрат 

// Второй элемент сапѵаз 
// Получить его контекст 
// Начать новый "контур" 

// Добавить круг 
// Цвет заливки - синий 
// Залить круг 


Мы видели, что грамматика 8ѴС позволяет описывать сложные фигуры из пря¬ 
мых отрезков и кривых линий, которые могут быть нарисованы или залиты цве¬ 
том. В прикладном интерфейсе объекта Сапѵаз тоже используется понятие контура. 
Однако контур в данном случае описывается не как строка из символов и чисел, 
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а как последовательность вызовов методов, таких как ЬедіпРа1:И() и агс(), исполь¬ 
зованных в примере выше. После того как контур будет определен, к нему можно 
применять различные операции, выполняемые такими методами, как Ш1(). Осо¬ 
бенности выполнения операций определяются различными свойствами объекта 
контекста, такими как ГіІІЗііуІе. В следующих подразделах рассказывается: 

• Как определять фигуры, как рисовать контуры фигур и как выполнять залив¬ 
ку внутренней области фигур. 

• Как устанавливать и читать значение графических атрибутов объекта контек¬ 
ста элемента <сапѵаз> и как сохранять и восстанавливать текущие значения 
этих атрибутов. 

• О размерах холста, системе координат по умолчанию элемента <сапѵаз> и о том, 
как выполнять трансформации этой системы координат. 

• О различных методах рисования кривых объекта Сапѵаз. 

• О некоторых специализированных вспомогательных методах рисования пря¬ 
моугольников. 

• Как определять цвета, как работать с прозрачностью и как рисовать градиен¬ 
ты и выполнять заливку шаблонными изображениями. 

• Об атрибутах, определяющих толщину линий и внешний вид концов линий 
и вершин многоугольников. 

• Как рисовать текст в элементе <сапѵаз>. 

• Как ограничивать область холста, чтобы рисование не выполнялось за преде¬ 
лами указанной области. 

• Как добавлять тени к фигурам. 

• Как рисовать (и при необходимости масштабировать) изображения в элементе 
<сапѵаз> и как извлекать содержимое этого элемента в виде графического изо¬ 
бражения. 

• Как управлять созданием составных изображений, когда вновь добавляемые 
(просвечивающие) пикселы объединяются с существующими пикселами. 

• Как получать и записывать красную, зеленую, синюю составляющие цвета 
и степень прозрачности пикселов в элементе <сапѵаз>. 

• Как определить, возникло ли событие мыши, когда ее указатель находился 
над нарисованным изображением в элементе <сапѵаз>. 

В конце этого раздела будет представлен практический пример, в котором эле¬ 
менты <сапѵаз> будут использоваться для отображения небольших внутристроч- 
ных диаграмм (зрагкііпез). 

Во многих примерах работы с элементом <сапѵаз>, которые следуют ниже, исполь¬ 
зуется переменная с. Эта переменная хранит объект СапѵазРепс1егіпдСоп1:ех1:20 эле¬ 
мента <сапѵаз>, но инициализация этой переменной в самих примерах обычно не 
показана. Если у вас появится желание опробовать эти примеры, добавьте размет¬ 
ку НТМЬ, определяющую элемент <сапѵаз> с соответствующими атрибутами місіііП 
и НеідПІ:, и следующий программный код, инициализирующий переменную с: 

ѵаг сапѵаз = сіоситепі: . де1:Е1етепі:ВуІс1("ту_сапѵаз_іс1"); 
ѵаг с = сапѵаз.деіСопіехК '2сГ ); 
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Рисунки, которые встретятся вам далее, были созданы сценариями 5аѵа8сгірі, 
использующими элемент <сапѵаз> - обычно с очень большими размерами, чтобы 
создать изображения с высоким разрешением, пригодные для печати. 

21.4.1. Рисование линий и заливка многоугольников 

Чтобы нарисовать прямые линии в элементе <сапѵаз> и залить внутреннюю об¬ 
ласть замкнутой фигуры, образуемой этими линиями, необходимо сначала опре¬ 
делить контур (раіЬ). Контур - это последовательность из одного или более фраг¬ 
ментов контура. Фрагмент контура - это последовательность из двух или более 
точек, соединенных прямыми линиями (или, как будет показано ниже, кривы¬ 
ми). Создается новый контур с помощью метода ЬедіпРаЩ ). А фрагмент контура - 
с помощью метода тоѵеТо( ). После установки начальной точки фрагмента контура 
вызовом метода тоѵеТо( ) можно соединить эту точку с новой точкой прямой лини¬ 
ей, вызвав метод 1іпеТо(). Следующий фрагмент определяет контур, состоящий 
из двух прямых линий: 

с. ЬедіпРа1:И( ); // Новый контур 

с. тоѵеТо(100, 100); // Новый фрагмент контура с начальной точкой (100,100) 
с. 1іпеТо( 200, 200); // Добавить линию, соединяющую точки (100,100) и (200,200) 

с.1 іпеТо( 100, 200); // Добавить линию, соединяющую точки (200,200) и (100,200) 

Фрагмент выше просто определяет контур - он ничего не рисует. Чтобы фактиче¬ 
ски нарисовать две линии, следует вызвать метод з1:гоке(), а чтобы залить об¬ 
ласть, ограниченную этими линиями, следует вызвать метод 1"і11( ): 

с.ГіІІО; // Залить область треугольника 

с.зІгокеО; // Нарисовать две стороны треугольника 

Фрагмент выше (плюс некоторый дополнительный программный код, устанав¬ 
ливающий толщину линий и цвет заливки) воспроизводит рисунок, изображен¬ 
ный на рис. 21.5. 



Рис . 21.5. Простой путь, нарисованный и залитый 


Обратите внимание, что фрагмент контура, определяемый выше, является «от¬ 
крытым». Он содержит всего две прямые линии, и его конечная точка не совпада¬ 
ет с начальной точкой. То есть он образует незамкнутую область. Метод Ш1() 
выполняет заливку открытых фрагментов контуров, как если бы конечная и на¬ 
чальная точка фрагмента контура были соединены прямой линией. Именно по¬ 
этому пример выше выполняет заливку треугольной области, но рисует только 
две стороны этого треугольника. 

Если бы потребовалось нарисовать все три стороны треугольника выше, можно 
было бы вызвать метод сІозеРаЩ), чтобы соединить конечную и начальную точ¬ 
ки фрагмента контура. (Можно было бы также вызвать метод 1іпеТо(100,100), но 
в этом случае получились бы три прямые линии с общей начальной и конечной 
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точками, не образующие в действительности замкнутый фрагмент контура. При 
рисовании толстыми линиями результат визуально выглядит лучше, если ис¬ 
пользуется метод сІозеРаІНО.) 

* 

Следует сделать еще два важных замечания, касающиеся методов зІгоке()иШ1(). 
Во-первых, оба метода оперируют всеми элементами в текущем контуре. Допус¬ 
тим, что в примере выше был добавлен еще один фрагмент контура: 

с. тоѵеТо(300, 100); // Новый фрагмент контура с начальной точкой (300,100); 
с. 1іпеТо( 300,200); // Нарисовать вертикальную линию вниз до точки (300,200); 

Если затем вызвать метод з1:гоке( ), получились бы две соединенные вместе сторо¬ 
ны треугольника и не связанная с ними вертикальная линия. 

Во-вторых, обратите внимание, что методы з1гоке() и ■Гі11( ) никогда не изменяют 
текущий контур: можно вызвать метод Гі11(), и от этого контур никуда не денет¬ 
ся, когда вслед за этим будет вызван метод з1:гоке(). Когда вы закончили работу 
с текущим контуром и приступаете к работе с новым контуром, нужно не забыть 
вызывать метод ЬедіпРа1:И( ). В противном случае вы просто добавите новый фраг¬ 
мент контура в существующий контур, и старые фрагменты контура будут рисо¬ 
ваться снова и снова. 

Пример 21.4 содержит определение функции рисования правильных многоуголь¬ 
ников и демонстрирует использование методов тоѵеТо(), 1іпеТо() и сІозеРаІНО для 
определения фрагментов контура и методов 1 = і11( ) и з1гоке() для рисования кон¬ 
туров. Он воспроизводит рисунок, изображенный на рис. 21.6. 



Рис. 21.6. Правильные многоугольники 


Пример 21.4. Рисование правильных многоугольников с помощью 

методов тоѵеТо( ), ІіпеТо( ) и сІозеРаіЩ ) 

// Определяет правильный многоугольник с п сторонами, вписанный в окружность с центром 
// в точке (х,у) и радиусом г. Вершины многоугольника находятся на окружности, 

// на равном удалении друг от друга. Первая вершина помещается в верхнюю точку 
// окружности или со смещением на указанный угол апдіе. Поворот выполняется 
// по часовой стрелке, если в последнем аргументе не передать значение ігііе. 

Гипсіііоп ро1удоп(с, п, х, у, г, апдіе, соипііегсіоскмізе) { 
апдіе = апдіе || 0; 

соипііегсіоскмізе = соипііегсіоскмізе 11 Гаізе; 
с.тоѵеТо(х + г*Маі:П.зіп(апдіе), // Новый фрагмент контура 

у - г*Маі:П.соз(апдіе)); // Исп. тригонометрию для выч. координат 
ѵаг сІеПа = 2*Маі:П. РІ/п; // Угловое расстояние между вершинами 

Гог(ѵаг і = 1; і < п; і++) { // Для каждой из оставшихся вершин 

апдіе += соипііегсіоскмізе?-сІеНа:сІеПа; // Скорректировать угол 
с.1іпеТо(х + г*Маі:П.зіп(апдіе), // Линия к след, вершине 

у - г*Маі:П.соз(апдіе)); 

} 
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с. сІозеРаНіС ); // Соединить первую вершину с последней 


} 

// Создать новый контур и добавить фрагменты 

с. ЬедіпРаІІі( ); 

ро1удоп(с, 3, 50, 70, 50); 

ро1удоп(с, 4, 150, 60, 50, МаТИ. РІ/4); 

ро1удоп(с, 5, 255, 55, 50); 

ро1удоп(с, 6, 365, 53, 50, МаііітРІ/6); 

ро1удоп(с, 4, 365, 53, 20, МаІІі.РІ/4, Тгие); 


контура, соответствующие многоугольникам- 

// Треугольник 
// Квадрат 
// Пятиугольник 
// Шестиугольник 
// Квадрат в шестиугольнике 


// Установить некоторые свойства, определяющие внешний вид рисунка 
с.ГіІІЗІіуІе = "Иссс"; // Светло-серый фон внутренних областей 
с. зіігокеЗТуІе = "#008"; // темно-синие контуры 
с. ІіпеМісПіН = 5; // толщиной пять пикселов. 


// Нарисовать все многоугольники (каждый создается в виде отдельного фрагмента контура) 
// следующими вызовами 
с.'РШ.О* // Залить фигуры 
с.зТгокеО; // И нарисовать контур 


Обратите внимание, что в этом примере внутри шестиугольника рисуется квад¬ 
рат. Квадрат и шестиугольник являются отдельными фрагментами контура, но 
они перекрываются. Когда это происходит (или когда один фрагмент контура пе¬ 
ресекается с самим собой), элементу <сапѵаз> приходится выяснять, какая область 
является внутренней для фрагмента контура, а какая - внешней. Для этого эле¬ 
мент <сапѵаз> использует алгоритм, известный как «правило ненулевого числа 
оборотов» («помего лѵіпсііп^ гиіе»). В данном случае внутренняя область квадра¬ 
та не заливается светло-серым цветом, потому что квадрат и шестиугольник ри¬ 
совались в противоположных направлениях: вершины шестиугольника соеди¬ 
нялись линиями в направлении по часовой стрелке, а вершины квадрата - про¬ 
тив часовой стрелки. Если бы рисование квадрата также выполнялось в направ¬ 
лении по часовой стрелке, метод 1 = і11( ) залил бы внутреннюю область квадрата. 


Правило ненулевого числа оборотов 

Чтобы определить, находится ли точка Р внутри контура, используя пра¬ 
вило правило ненулевого числа оборотов, представьте луч, исходящий из 
точки Р в любом направлении и уходящий в бесконечность (или, если гово¬ 
рить практическим языком, до некоторой точки за пределами фигуры, об¬ 
разуемой рассматриваемым контуром). Теперь инициализируйте счетчик 
нулевым значением и проследите за всеми пересечениями контура с лучом. 
Каждый раз, когда луч пересекает контур, рисуемый в направлении по ча¬ 
совой стрелке, увеличивайте счетчик на единицу. Каждый раз, когда луч 
пересекает контур, рисуемый в направлении против часовой стрелки, 
уменьшайте счетчик на единицу. Если после учета всех пересечений в счет¬ 
чике получается значение, не равное нулю, следовательно, точка Р нахо¬ 
дится внутри контура. Если счетчик оказывается равным нулю, следова¬ 
тельно, точка Р находится снаружи. 
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21.4.2. Графические атрибуты 

В примере 21.4 устанавливаются свойства ШІЗііуІе, зі:гокеЗІіуІе и Ііпеіл/ісііііі объек; 
та контекста элемента <сапѵаз>. Эти свойства являются графическими атрибута¬ 
ми, определяющими цвет, используемый методом 1"і11(); цвет, используемый ме¬ 
тодом 5І:гоке( ); и толщину линий, рисуемых методом з1:гоке( ). Обратите внимание, 
что эти параметры не передаются методам ^і11() и зІгокеО, а являются общими 
графическими свойствами элемента <сапѵаз>. Если определяется метод, рисую¬ 
щий некоторую фигуру, который не устанавливает эти свойства, программа, ис¬ 
пользующая его, сможет сама определять цвет фигуры, устанавливая свойства 
зІігокеЗііуІе и ШІЗІіуІе перед вызовом этого метода. Такое отделение графических 
свойств от команд рисования является фундаментальной особенностью приклад¬ 
ного интерфейса объекта Сапѵаз и сродни отделению представления от содержимо¬ 
го, достигаемого за счет применения таблиц стилей С88 к НТМЬ-доку ментам. 

Прикладной интерфейс объекта Сапѵаз содержит 15 свойств графических атрибу¬ 
тов в объекте СапѵазРепсІегіпдСоп1:ех1:20. Эти свойства перечислены в табл. 21.1 
и подробно описываются в соответствующих разделах ниже. 

Таблица 21.1. Графические атрибуты прикладного интерфейса объекта Сапѵаз 


Свойство 

Описание 

ШІЗНуІе 

цвет, градиент или шаблон, используемый для заливки 


определение шрифта в формате С88 для команд рисования текста 

дІоЬаІАІрРа 

уровень прозрачности, назначаемый для всех пикселов при ри¬ 
совании 

дІоЬаІСотрозіІіеОрегаіііоп 

способ объединения новых пикселов с существующими 

ІіпеСар 

форма концов линий 

Ііпе^іп 

форма вершин 

Ііпеіл/ісііііі 

толщина рисуемых линий 

тіІеПітіг 

максимальная длина острых вершин 

ІехІАІідп 

выравнивание текста по горизонтали 

1:ех1:Вазе1іпе 

выравнивание текста по вертикали 

Зііасіоѵу/Віиг 

четкость теней 

зЬасІсмСоІог 

цвет теней 

зИасІомОНзеІіХ 

горизонтальное смещение теней 

зИасІомОГГзеііѴ 

вертикальное смещение теней 

ЗІігокеЗііуІе 

цвет, градиент или шаблон, используемый для рисования линий 


Так как прикладной интерфейс объекта Сапѵаз определяет графические атрибуты 
в объекте контекста, может появиться идея вызвать метод де1:Соп1:ех1:( ) несколько 
раз, чтобы получить несколько объектов контекста. Если бы это удалось, можно 
было бы определить для каждого из них различные атрибуты и использовать их 
как различные кисти разного цвета и разной толщины. К сожалению, элемент 
<сапѵаз> нельзя использовать таким способом. Каждый элемент <сапѵаз> имеет 
только один объект контекста, и каждый вызов метода де1:Соп1:ех1:() возвращает 
один и тот же объект СапѵазРепс1егіпдСоп1:ех1:20. 
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Тем не менее, несмотря на то что прикладной интерфейс объекта Сапѵаз позволяет 
определить только один набор графических атрибутов, он предусматривает воз¬ 
можность сохранять текущие графические свойства, чтобы их можно было изме¬ 
нить и позднее легко восстановить прежние значения. Метод 5аѵе() помещает те¬ 
кущие значения графических свойств в стек. Метод гез1оге() выталкивает их со 
стека и восстанавливает самые последние сохраненные значения. В множество 
сохраняемых свойств входят все свойства, перечисленные в табл. 21.1, а также 
текущее преобразование системы координат и область отсечения (обе особенно¬ 
сти рассматриваются ниже). Важно отметить, что текущее определение контура 
и координаты текущей точки не входят в множество сохраняемых графических 
свойств и не могут сохраняться и восстанавливаться. 

Если вам потребуется больше гибкости, чем может обеспечит простой стек гра¬ 
фических свойств, вы можете определить вспомогательные методы, такие как 
в примере 21.5. 

Пример 21,5, Утилиты управления графическими свойствами 

// Восстанавливает последние сохраненные значения графических свойств, 

// но не выталкивает их со стека. 

СапѵазВепс1егіпдСоп1:ех1:20. ргоШуре. геѵегі: = Гипс1ііоп() { 

■Шз. гезііоге(); // Восстановить прежние значения графических свойств. 

1:Міз . заѵе( ); // Сохранить их снова, чтобы можно было вернуться к ним. 

геііигп ііітіз ; // Позволить составление цепочек вызовов методов. 

}; 

// Устанавливает графические атрибуты в соответствии со значениями свойств объекта о. 

// Или, при вызове без аргументов, возвращает текущие значения атрибутов в виде объекта. 

// Обратите внимание, что этот метод не обслуживает преобразование или область отсечения. 
СапѵазВепс1егіпдСоп1іех1і20. ргоШуре. аіііігз = 1"ипс1ііоп(о) { 
іГ (о) { 

Гог(ѵаг а іп о) // Для каждого свойства объекта о 

1:Ітіз[ а] = о[а]; // Установить его как графический атрибут 
геіыгп ііітіз ; // Позволить составление цепочек вызовов методов 

} 

еізе геііигп { 

НПЗІуІе: Шз. НПЗіуІе, Гоп*: Шз. Гопі:, 
дІоЬаІАІрНа: Шз.дІоЬаІАІрНа, 

дІоЬаІСотрозіІіеОрегаіііоп: Шз.дІоЬаІСотрозіІіеОрегаіііоп, 

ПпеСар: Шз.ІіпеСар, НпеШп: Шз.ПпеШп, 

ІіпеМісІІіЬ: Шз.ІіпеМісІІіЬ, ті1іегІ_іті1і: Шз. ті1іегІ_іті1і, 

ІехіАІідп: Шз. іехііАІідп, ІіехІіВазеІіпе: Шз. ІіехІіВазеІіпе, 
зЬасІомВІиг: Шз. зЬасІомВІиг, зЬасІомСоІог: Шз.зЬасІомСоІог, 
зЬасІомОГГзеІіХ: Шз.зЬасІомОІ^зеІіХ, зЬасІомОГГзеІіѴ: Шз.зЬасІомОГГзеІіѴ, 
зіігокеЗІіуІе: Шз. зіігокеЗііуІе 

}; 

}; 

21.4.3. Размеры и система координат холста 

Атрибуты місіііЬ и ЬеідЫ: элемента <сапѵаз> и соответствующие им свойства місіііЬ 
и ЬеідЫ: объекта Сапѵаз определяют размеры холста. По умолчанию начало систе¬ 
мы координат холста (0,0) находится в его левом верхнем углу. Координата X уве¬ 
личивается в направлении слева направо, а координата У - сверху вниз. Коорди- 
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наты точек на холсте могут определяться вещественными значениями, и они не 
будут автоматически округляться до целых - для имитации частично заполнен¬ 
ных пикселов объект Сапѵаз использует приемы сглаживания. 

Размеры холста являются настолько фундаментальными характеристиками, что 
они не могут изменяться без полного сброса холста в исходное состояние. Измене¬ 
ние значения свойства місіііП или ІпеідІтІ: объекта Сапѵаз (даже присваивание им те¬ 
кущих значений) вызывает очистку холста, стирание текущего контура и переус¬ 
тановку всех графических атрибутов (включая текущее преобразование и область 
отсечения) в исходное состояние. 

Несмотря на фундаментальность размеров холста, они необязательно совпадают 
с размерами холста на экране или с количеством пикселов, образующих поверх¬ 
ность для рисования. Размеры холста (а также система координат по умолчанию) 
измеряются в С88-пикселах. С88-пикселы обычно совпадают с обычными пиксе¬ 
лами. Однако на устройствах высокого разрешения реализациям разрешено ото¬ 
бражать несколько аппаратных пикселов в один С88-пиксел. Это означает, что 
размеры прямоугольной области в пикселах, отведенной для холста, могут ока¬ 
заться больше номинальных размеров холста. Об этом следует помнить при ра¬ 
боте с механизмами холста, манипулирующими пикселами (раздел 21.4.14), но 
в других случаях различия между виртуальными С88-пикселами и фактиче¬ 
ским аппаратными пикселами не оказывают влияния на программный код, вы¬ 
полняющий операции с холстом. 

По умолчанию элемент <сапѵаз> отображается на экране с размерами (в С88-пик- 
селах), указанными в его НТМЬ-атрибутах ѵ\/і(Л:И и НеідН1. Однако, подобно любым 
другим НТМЬ-элементам, элемент <сапѵаз> может иметь экранные размеры, опре¬ 
деляемые С88-атрибутами стиля мійІН и Гіеідіпі:. Если экранные размеры холста от¬ 
личаются от его фактических размеров, пикселы холста автоматически будут 
масштабироваться в соответствии с экранными размерами, указанными в 088-ат¬ 
рибутах. Экранные размеры холста никак не влияют на количество С88- или ап¬ 
паратных пикселов, зарезервированных в растровом отображении холста, а мас¬ 
штабирование выполняется как обычная операция масштабирования изображе¬ 
ний. Если экранные размеры оказываются существенно больше фактических 
размеров холста, это приводит к появлению мозаичного эффекта. Однако это про¬ 
блема скорее для художников и никак не влияет на программирование холста. 

21.4.4. Преобразование системы координат 

Как отмечалось выше, начало системы координат холста по умолчанию находит¬ 
ся в левом верхнем углу, значение координаты X увеличивается в направлении 
слева направо, а координаты У - сверху вниз. В этой системе координат по умол¬ 
чанию координаты точки отображаются непосредственно в С88-пикселы (кото¬ 
рые затем отображаются в один или более аппаратных пикселов). Некоторые опе¬ 
рации с холстом и атрибутами (такие как извлечение параметров пикселов и ус¬ 
тановка смещения теней) всегда используют систему координат по умолчанию. 
Однако помимо системы координат по умолчанию каждый холст имеет в составе 
графических свойств «текущую матрицу преобразований». Эта матрица опреде¬ 
ляет текущую систему координат холста. В большинстве операций с холстом, где 
указываются координаты точки, используется текущая система координат, а не 
система координат по умолчанию. Текущая матрица преобразований использу- 
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ется для преобразования указанных вами координат в эквивалентные им коор¬ 
динаты в системе координат по умолчанию. 

Метод зе1:Тгапз1 = огт( ) позволяет напрямую определять матрицу преобразований 
холста, но обычно преобразования системы координат проще определять как по¬ 
следовательность операций смещения, вращения и масштабирования. Влияние 
этих операций на систему координат холста иллюстрируются на рис. 21.7. Про¬ 
грамма, с помощью которой был получен этот рисунок, семь раз подряд использо¬ 
вала одно и то же изображение осей координат. Единственное, что изменялось 
каждый раз, - это текущее преобразование. Обратите внимание, что преобразо¬ 
вания оказывают влияние не только на рисование линий, но и на вывод текста. 

Метод 1:гап5ІаІе( ) просто смещает начало системы координат влево, вправо, вверх 
или вниз. Метод го1а!е( ) выполняет вращение осей координат по часовой стрелке 
на указанный угол. (Прикладной интерфейс объекта Сапѵаз всегда измеряет углы 
в радианах. Чтобы преобразовать градусы в радианы, необходимо разделить зна¬ 
чение в градусах на 180 и умножить на МаІіІі.РІ.) Метод зса1е() растягивает или 
сжимает расстояния по оси X или У. 

Передача отрицательного коэффициента масштабирования методу зса1е() пере¬ 
ворачивает соответствующую ему ось относительно начала системы координат, 
создавая зеркальное ее отражение. Именно это преобразование можно наблюдать 
внизу слева на рис. 21.7: вызов метода 1:гапз1а1:е( ) сместил начало координат в ле¬ 
вый нижний угол холста, а вызов метода зса1е() перевернул ось У так, что значе¬ 
ния координаты У стали увеличиваться в направлении снизу вверх. Такая пере¬ 
вернутая система координат должна быть знакома вам по школьному курсу ал¬ 
гебры, и она может пригодиться для рисования графиков и диаграмм. Отметьте, 
однако, что текст после такого преобразования очень трудно читать! 




Рис . 21.7. Преобразования системы координат 
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21.4.4.1. Математический смысл преобразований 

На мой взгляд, проще всего разбираться с преобразованиями, имея их геометри¬ 
ческое представление, когда действие методов 1гапз1а1:е(), го1:а*е( ) и зса1е( ) можнб 
представить в виде преобразований координатных осей, как показано на рис. 21.7. 
Преобразования можно также представить алгебраически, в виде системы урав¬ 
нений, отображающих координаты точки (х,у) в преобразованной системе коор¬ 
динат в координаты той же точки (х\у' ) в исходной системе координат. 

Вызов метода с.1:гапз1а1:е(сІх,сІу) можно описать следующими уравнениями: 

х' = х + сіх; // Значение 0 координаты X в новой системе координат 

// соответствует значению сіх в старой системе координат 

у- = у + ру; 

Операцию масштабирования также можно представить в виде простых уравне¬ 
ний. Вызов метода с.зсаіе(зх.зу) можно описать следующим образом: 

х' = зх * х; 
у- = зу * у; 

Операция вращения выглядит несколько сложнее. Вызов с. гоіаіе(а) описывается 
следующими тригонометрическими уравнениями: 

х' = х * соз(а) - у * зіп(а); 
у’ = у * соз(а) + х * зіп(а); 

Обратите внимание, что порядок выполнения преобразований имеет большое 
значение. Допустим, что изначально используется система координат холста по 
умолчанию, после чего выполняется смещение и затем масштабирование. Чтобы 
отобразить координаты точки (х,у) в текущей системе координат обратно в коор¬ 
динаты (х",у") в системе координат по умолчанию, необходимо сначала приме¬ 
нить уравнения масштабирования, чтобы отобразить координаты точки в проме¬ 
жуточные координаты (х\ у ) точки в смещенной, но не масштабированной сис¬ 
теме координат, а затем применить уравнения смещения, чтобы отобразить эти 
промежуточные координаты точки в координаты (х",у "). В результате получим 
следующую систему уравнений: 

х' ' = зх*х + сіх; 
у'' = 5у*у + сіу; 

Если же к исходной системе координат сначала применялся метод зса1е( ), а затем 
1:гапз1а1:е(), мы придем к другой системе уравнений: 

х' 1 = зх*(х + сіх); 
у' ‘ = зу*(у + сіу); 

При использовании алгебраических представлений последовательностей преоб¬ 
разований важно помнить, что в уравнениях они должны следовать в обратном 
порядке - от последнего преобразования к первому. Однако при использовании 
геометрических представлений вы работаете с последовательностями преобразо¬ 
ваний в прямом порядке, от первого к последнему. 

Преобразования, поддерживаемые холстом, известны как аффинные преобразо¬ 
вания . Аффинные преобразования могут изменять расстояния между точками 
и углы между линиями, но параллельные линии всегда остаются параллельны¬ 
ми после любых аффинных преобразований - с помощью аффинных преобразо- 
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ваний нельзя, например, создать эффект искажения типа «рыбий глаз». Любое 
аффинное преобразование можно описать с помощью шести параметров от а до 
как показано в следующих уравнениях: 

х' = ах + су + е 
у' = Ьх + сіу + Г 

К текущей системе координат можно применять любые преобразования, переда¬ 
вая эти шесть параметров методу 1тапз^огт(). На рис. 21.7 показаны два типа пре¬ 
образований - сдвиг и вращение вокруг указанной точки - которые можно реа¬ 
лизовать с помощью метода 1:гапз^огт(), как показано ниже: 

// Сдвиг: 

// х' = х + кх*у; 

//у' = у + ку*х; 

Гьпсіііоп зМеаг(с, кх, ку) { с. ІгапзГогт(1, ку, кх, 1, 0, 0); } 

// Вращение на ТМеТа радиан по часовой стрелке вокруг точки (х,у). Это преобразование 
// можно выполнить с помощью последовательности вызовов методов Тгапзіаііе, гоТаТе, ТгапзІаТе 
Гьпсіііоп гоТаТеАЬоЩСс, ТМеТа,х, у) { 

ѵаг сТ = МаТМ.созСтМеТа), зТ = МаТИ.зіпСТііеТа): 
с.Тгапз^огт(сТ, -зТ, зТ, сТ, -х*сТ-у*зТ+х, х*зТ-у*сТ+у): 

} 

Метод зе*Тгапз^огт() принимает те же аргументы, что и метод 1:гапз^огт(), но вме¬ 
сто преобразования текущей системы координат он выполняет преобразование 
системы координат по умолчанию и делает результат новой текущей системой ко¬ 
ординат. Метод зе1:Тгапз^огт() удобно использовать для временного возврата к сис¬ 
теме координат по умолчанию: 

с.заѵеО; // Сохранить текущую систему координат 

с.зе1:Тгапз'Гогт(1.0,0,1,0,0): // Вернуться к системе координат по умолчанию 
// Выполнить операции с использованием координат по умолчанию СЗЗ-пикселов 
с. гезііо ге(); // Восстановить сохраненную систему координат 

21.4.4.2. Примеры преобразований 

Пример 21.6 демонстрирует мощь, которую дает возможность преобразования 
системы координат, где за счет рекурсивного применения методов ІгапзІаІеО, 
го1:а1:е() и зса1е() реализовано рисование фракталов - снежинок Коха. Результат 
работы этого примера представлен на рис. 21.8, где показаны снежинки Коха 
с количеством уровней рекурсии О, 1, 2, 3 и 4. 




Рис. 21.8. Снежинки Коха 

Эти фигуры воспроизводятся весьма изящным программным кодом, но в нем 
используются рекурсивные преобразования системы координат, что делает его 
сложным для понимания. Даже если вы не собираетесь углубляться в изучение 
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всех тонкостей примера, обратите все же внимание, что в нем имеется всего один 
вызов метода 1іпеТо(). Каждый отдельный сегмент на рис. 21.8 рисуется следую¬ 
щим образом: • 

с. 1іпеТо(1еп, 0); 

Значение переменной Іеп не изменяется в ходе выполнения программы, поэтому 
позиция, ориентация и длина каждой линии определяется операциями смеще¬ 
ния, вращения и масштабирования. 

Пример 21.6. Рисование снежинок Коха посредством преобразований 

системы координат 

ѵаг сіед = МаІН.РІ/180; // Для преобразования градусов в радианы 

// Рисует п-уровневый фрактал снежинки Коха в контексте холста с, левый нижний угол 
// которого имеет координаты (х,у), а длина стороны равна Іеп. 

ГипсИоп зпомГ1аке(с, п, х, у, Іеп) { 

с.заѵе(); // Сохранить текущее преобразование 

с. *гап5Іа*е(х, у); // Сместить начало координат в начальную точку 

с. тоѵеТо(0, 0); // Новый фрагмент контура в новом начале координат 

1ед(п); // Нарисовать первую ветвь снежинки 

с. го1:а1:е(-120*сіед); // Поворот на 120 градусов против часовой стрелки 

1ед(п); // Нарисовать вторую ветвь 

с. го1:а1:е(-120*сіед); //Поворот 

1ед(п); // Нарисовать последнюю ветвь 

с. сІозеРаЩ ); // Замкнуть фрагмент контура 

с. гез1:оге(); // Восстановить прежнее преобразование 

// Рисует одну ветвь п-уровневой снежинки Коха. Эта функция оставляет 
// текущую позицию в конце нарисованной ветви и смещает начало координат так, 

// что текущая точка оказывается в позиции (0,0). 

// Это означает, что после рисования ветви можно вызвать го*а*е(). 

Гипс1:іоп 1ед(п) { 

с.заѵеО; // Сохранить текущее преобразование 

і Г (п == 0) { // Нерекурсивный случай: 

с. 1іпеТо(1еп, 0); // Просто нарисовать горизонтальную линию 

} // 

еізе { // Рекурсивный случай: 4 подветви вида: \/ 

с.зса1е(1/3,1/3): // Подветви в 3 раза меньше этой ветви 

Іед(п-І); // Рекурсия для первой подветви 

с. го1:а1:е(60*сІед); // Поворот на 60 градусов по часовой стрелке 

Іед(п-І); // Вторая подветвь 

с. го1:а1:е(-120*сІед); // Поворот на 120 градусов назад 
Іед(п-І); // Третья подветвь 

с. го1:а1:е(60*сІед); // Поворот обратно к началу 

Іед(п-І); // Последняя подветвь 

} 

с. гез1:оге(); // Восстановить преобразование 

с. 1:гапз1а1:е( Іеп . 0); // Но сместить в конец ветви (0,0) 

} 

} 

5помГ1аке(с,0,5,115,125); // Снежинка нулевого уровня является 

// равносторонним треугольником 

5помГ1аке(с,1,145,115,125); // Снежинка первого уровня - шестиконечная звезда 
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зпо\л/Г1аке(с, 2,285,115,125); // и так далее. 

5ПомГ1аке(с,3,425,115,125); 

зпомГ1аке(с,4,565,115,125); // Снежинка четвертого уровня выглядит как снежинка! 
с.зТгокеО; // Нарисовать этот очень сложный контур 

21.4.5. Рисование и заливка кривых 

Контур - это последовательность фрагментов контура, а фрагмент контура - это 
последовательность точек, соединенных линиями. В контурах, которые опреде¬ 
лялись в разделе 21.4.1, эти точки соединялись прямыми линиями, но это не обя¬ 
зательно должно быть так. Объект СапѵазВепсІегіпдСоп1:ех1:20 определяет несколько 
методов, которые добавляют во фрагмент контура новую точку и соединяют ее 
кривой с текущей точкой: 

агс() 

Этот метод добавляет во фрагмент контура дугу. Он соединяет текущую точку 
с началом дуги прямой линией и затем соединяет начало дуги с концом дуги 
сегментом окружности, при этом конечная точка дуги становится новой теку¬ 
щей точкой. Дуга определяется шестью параметрами: координаты X и У цен¬ 
тра окружности, радиус окружности, угол начала и конца дуги и направление 
(по часовой стрелке или против часовой стрелки) рисования дуги между эти¬ 
ми двумя углами. 

агсТо() 

Этот метод так же рисует прямую линию и круговую дугу, как и метод агс(), 
но при его использовании дуга определяется другим набором параметров. Ар¬ 
гументы метода агсТо( ) определяют точки Р1 и Р2 и радиус. Дуга, добавляемая 
в контур, имеет указанный радиус и строится так, что линии, соединяющие 
текущую точку с точкой Р1 и точку Р1 с точкой Р2, являются касательными 
к ней. Такой необычный, на первый взгляд, способ определения дуг в действи¬ 
тельности является весьма удобным при рисовании закругленных углов. Если 
указать радиус равный 0, этот метод просто нарисует прямую линию, соеди¬ 
няющую текущую точку и точку Р1. Однако если указан ненулевой радиус, он 
нарисует прямую линию от текущей точки в направлении точки Р1 до начала 
дуги, затем начнет рисовать круговую дугу, пока направление рисования не 
совпадет с направлением на точку Р2. 

ЬегіегСигѵеТоО 

Этот метод добавит во фрагмент контура новую точку Р и соединит ее с теку¬ 
щей точкой кубической кривой Безье. Форма кривой определяется двумя 
«контрольными точками» С1 и С2. В начале кривой (в текущей точке) рисова¬ 
ние начинается в направлении точки С1. В свой конец (в точке Р) кривая при¬ 
ходит в направлении из точки С2. Между этими точками кривая плавно изги¬ 
бается. Точка Р становится новой текущей точкой для фрагмента контура. 

диасІга1:ісСигѵеТо() 

Этот метод похож на метод Ье 2 іегСигѵеТо( ), но рисует квадратичные кривые Бе¬ 
зье и имеет всего одну контрольную точку. 

С помощью этих методов можно рисовать контуры, подобные тем, что изображе¬ 
ны на рис. 21.9. 
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Рис. 21.9. Контуры, состоящие из кривых 

В примере 21.7 представлен программный код, с помощью которого было создано 
изображение на рис. 21.9. Методы, используемые в этом примере, являются од¬ 
ними из самых сложных в прикладном интерфейсе объекта Сапѵаз. Полное описа¬ 
ние методов и их аргументов приводится в справочном разделе книги. 

Пример 21.7. Добавление кривых в контур 

// Вспомогательная функция для преобразования градусов в радианы 
^цпсіііоп гасіз(х) { геіь гп Ма1:И. РІ*х/180; } 

// Нарисовать окружность. Используйте масштабирование и вращение, если требуется 
// получить эллипс. Здесь не используется текущая точка, поэтому окружность рисуется 
// без прямой линии, соединяющей текущую точку с началом окружности, 
с. ЬедіпРа1:Іт(); 

с.агс(75,100,50, // Центр в точке (75,100), радиус 50 

0, гас!з(360), ^аізе); // По часовой стрелке от 0 до 360 градусов 

// Нарисовать сектор. Углы откладываются по часовой стрелке от положительной оси х. 

// Обратите внимание, что метод агс() добавляет линию от текущей точки к началу дуги. 
с.тоѵеТо(200, 100); // Перейти в центр окружности 

с.агс(200, 100, 50, // Центр окружности и радиус 

гасІз(-бО), габз(О), // Начальный угол -60 градусов, конечный 0 градусов 

І'аізе); // І'аізе означает по часовой стрелке 

с.с1озеРа1:Н(); // Добавить прямую линю к центру окружности 

// Тот же сектор, в противоположном направлении 
с.шоѵеТо(325, 100); 

с.агс(325, 100, 50, гасІзС -60). гас1з(0), 1:гье); // Против часовой стрелки 
с. с1озеРа1:Н(); 

// Использовать агсТо() для закругления углов. Здесь рисуется квадрат с верхним левым 
// углом в точке (400,50), с закруглениями углов дугами с разными радиусами, 
с. тоѵеТо(450, 50); // Середина верхней стороны, 

с.агсТо(500,50,500,150,30); // Насть верхней стороны и правый верхний угол, 

с.агсТо(500,150,400,150,20); // Добавить правую сторону и правый нижний угол, 
с.агсТо(400,150,400,50,10); // Добавить нижнюю сторону и левый нижний угол, 
с.агсТо(400,50,500,50,0); // Добавить левую сторону и левый верхний угол, 

с.с1озеРа1:П(); // Замкнуть контур, чтобы добавить остаток верхней стороны. 

// Квадратичная кривая Безье: одна контрольная точка 
с.шоѵеТо(75, 250); // Начало в точке (75,250) 

с. циас!га1:ісСигѵеТо(100, 200, 175, 250); // Соединить с точкой (175,250) 
с. ШІВесКЮО-З, 200-3,6,6); // Метка контрольной точки (100,200) 
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// Кубическая кривая Безье 

с. тоѵеТо(200, 250); // Начало в точке (200,250) 

с. Ье2іегСцгѵеТо(220, 220, 280,280,300, 250); // Соединить с точкой (300,250) 
с. Гі11Рес1:( 220-3, 220-3,6,6); // Метки контрольных точек 

с.Ш1Рес1:(280-3.280-3,6,6); 

// Определить некоторые графические атрибуты и нарисовать кривые 
с. ШІЗІуІе = "#ааа"; // Серый цвет заливки 

с. ІіпеМісІІіН = 5; // Черные (по умолчанию) линии толщиной 5 пикселов 

с. НПО; // Залить фигуры 

с.зТгокеО; // Нарисовать контуры 

21.4.6. Прямоугольники 

Объект СапѵазВепсІегіпдСоп1:ех1:20 определяет четыре метода рисования прямоуголь¬ 
ников. Один из них, РШВесШ» использовался в примере 21.7 для создания меток 
контрольных точек кривых Безье. Все четыре метода рисования прямоугольни¬ 
ков принимают два аргумента, определяющих координаты одного угла прямо¬ 
угольника, и два аргумента, определяющих ширину и высоту. Обычно указыва¬ 
ется верхний левый угол и положительные значения ширины и высоты, но мож¬ 
но также указать другие углы и передать отрицательные размеры. 

Метод 1 = і11Пес1:( ) выполняет заливку внутренней области прямоугольника в соот¬ 
ветствии со значением атрибута РШЗііуІе. Метод з1:гокеРес1:() рисует контур пря¬ 
моугольника, используя текущее значение атрибута зІгокеЗііуІе и других атрибу¬ 
тов линий. Метод с1еагВес1:() подобен методу РШВес1:(), но он игнорирует текущее 
значение стиля заливки и заполняет прямоугольник прозрачными черными пик¬ 
селами (цвет по умолчанию всех пустых холстов). Важно отметить, что все эти 
три метода не оказывают влияния ни на текущий контур, ни на текущую точку 
внутри этого контура. 

Последний метод рисования прямоугольников называется гес1(), и он изменяет 
текущий контур: он добавляет указанный прямоугольник в виде отдельного 
фрагмента контура. Подобно другим методам определения контуров, сам по себе 
он не производит ни заливку, ни рисование контура. 

21.4.7. Цвет, прозрачность, градиенты и шаблоны 

Атрибуты з1:гоке51:у1е и ШІЗіуІе определяют параметры рисования линий и за¬ 
ливки областей. Чаще всего эти атрибуты используются, чтобы определить не¬ 
прозрачный или полупрозрачный цвет, но им также можно присваивать объекты 
СапѵазРаІіІіегп и СапѵазОгасІіепІ:, чтобы рисование или заливка выполнялась с ис¬ 
пользованием повторяющегося изображения или линейного или радиального 
градиента. Кроме того, можно воспользоваться свойством дІоЬаІАІрНа, чтобы сде¬ 
лать полупрозрачным все, что будет рисоваться. 

Чтобы определить сплошной цвет, можно использовать имена цветов, определяе¬ 
мые стандартом НТМЬ.4 1 , или использовать строки в формате С88: 

соігЕехІ:. зІігокеЗііуІе = "Ыие"; // Рисовать синие линии 
сопііехі:. НПЗІіуІе = "#ааа"; // Заливку выполнять серым цветом 


1 А^иа, Ыаск, Ыие, ІисЬзіа, &гау, &гееп, Ііте, тагооп, паѵу, оііѵе, ригріе, гесі, зііѵег, іеаі, 
лѵЬііе и уеііолѵ. 
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По умолчанию свойства з1:гоке51:у1е и ГіІІЗііуІе имеют значение «#000000», соот¬ 
ветствующее непрозрачному черному цвету. Текущие броузеры поддерживают 
цвета С883 и позволяют использовать форматы КОВ, НОВА, Н8Ь и НВЬА опреде¬ 
ления цветов вдобавок к базовому формату КОВ. Например: 


ѵаг 


]; 


С0І0ГЗ = [ 

"ПШ'\ И 

"Я44ГГ44", // 

"гдЬ(60. 60, 255)", // 

"гдЬ(100%, 25%, 100%)", // 

"гдЬа(100%, 25%, 100%, 0.5)",// 

” гдЬа(0, 0,0,0)", // 

"ТгапзрагеШ:", // 

” Изі (60, 100%, 50%)", // 

"ііз1(60, 75%, 50%)", // 

"[181(60, 100%, 75%)", // 

"[181(60, 100%, 25%)", // 


" [і8Іа(60, 100%, 50%, 0.5)", // 


Шестнадцатеричное значение РОВ: красный 

Шестнадцатеричное значение ВВ00ВВ: зеленый 

ВОВ в виде целых 0-255: синий 

ВОВ в виде процентов: пурпурный 

ВОВ плюс альфа 0-1: полупрозрачный пурпурный 

Совершенно прозрачный черный 

Синоним предыдущего цвета 

Насыщенный желтый 

Менее насыщенный желтый 

Насыщенный желтый, немного светлее 

Насыщенный желтый, немного темнее 

Насыщенный желтый, прозрачный на 50% 


При использовании формата Н8Ь цвет описывается тремя числами, определяю¬ 
щими тон (Ьие), насыщенность (заіигаііоп) и яркость (Іі^Мпезз). Тон (Ьие) - это ве¬ 
личина угла в цветовом круге. Значение 0 соответствует красному цвету, 60 - жел¬ 
тому, 120 - зеленому, 180 - бирюзовому, 240 - синему, 300 - сиреневому и 360 - 
опять красному. Насыщенность описывает интенсивность цвета и определяется 
в процентах. Цвета с насыщенностью 0% являются оттенками серого. Яркость 
описывает степень яркости цвета и также определяется в процентах. Любой цвет 
в формате Н8Ь со 100-процентной яркостью является белым цветом, а любой цвет 
с яркостью 0% - черным. В формате Н8ЬА цвет описывается так же, как в форма¬ 
те Н8Ь, но с дополнительным значением альфа-канала, которое изменяется в диа¬ 
пазоне от 0.0 (прозрачный) до 1.0 (непрозрачный). 

Если необходимо использовать полупрозрачные цвета, но нежелательно явно 
указывать значение альфа-канала для каждого цвета, или если необходимо доба¬ 
вить полупрозрачность к непрозрачному изображению или шаблону (например), 
требуемое значение непрозрачности можно присвоить свойству дІоЬаІАІрНа. Зна¬ 
чение альфа-канала каждого пиксела, рисуемого вами, будет умножаться на зна¬ 
чение свойства дІоЬаІАІрНа. По умолчанию это свойство имеет значение 1 и не до¬ 
бавляет прозрачности. Если свойству дІоЬаІАІрНа присвоить значение 0, все нари¬ 
сованное вами станет полностью прозрачным и на холсте ничего не будет видно. 
Если присвоить этому свойству значение 0.5, непрозрачные пикселы станут на¬ 
половину прозрачными. А пикселы, степень непрозрачности которых была равна 
50%, станут непрозрачными на 25%. Изменение значения свойства дІоЬаІАІрНа 
оказывает влияние на степень непрозрачности всех пикселов, поэтому вам, веро¬ 
ятно, потребуется учесть, как эти пикселы объединяются (или «составляются») 
с пикселами, поверх которых они нарисованы - режимы объединения, поддер¬ 
живаемые объектом Сапѵаз, описываются в разделе 21.4.13. 

Вместо сплошного цвета (пусть и полупрозрачного), заливку и рисование конту¬ 
ров можно также выполнять с использованием градиентов и повторяющихся изо¬ 
бражений. На рис. 21.10 изображен прямоугольник, контур которого нарисован 
толстыми линиями с использованием шаблонного изображения поверх заливки 
линейным градиентом и под заливкой радиальным градиентом. Ниже описыва- 
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ется, как было реализовано рисование шаблонным изображением и заливка гра¬ 
диентами. 
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Рис. 21.10. Рисование шаблоном и заливка градиентом 


Чтобы выполнить заливку или рисование с применением шаблонного изображе¬ 
ния вместо цвета, следует присвоить свойству ііІІЗіуІе или зІігокеЗІіуІе объект 
СапѵазРаІІіегп, возвращаемый методом сгеаіеРаііегпО объекта контекста: 

ѵаг ітаде = с!оситепТ.деТЕ1етепТВуІсІ(''туітаде"); 
с.ШІЗіуІе = с.сгеаТеРаТТегпЦтаде, "гереаі:"); 

Первый аргумент метода сгеа1:еРа1:1:егп() определяет изображение, которое будет 
использовано как шаблон. Это должен быть элемент документа <ітд>, <сапѵаз> или 
<ѵіс!ео> (или объект Ітаде, созданный конструктором ІтадеО). Во втором аргумен¬ 
те обычно передается строка «гереаі», если требуется повторять изображение при 
заполнении, независимо от его размера, но можно также использовать значения 
«гереаі-х», «гереаі -у» или «по-гереаі». 

Обратите внимание, что в качестве шаблонного изображения для одного элемен¬ 
та <сапѵаз> можно использовать другой элемент <сапѵаз> (даже если он не включен 
в состав документа и невидим на экране): 

ѵаг оІГзсгееп = йосшпеп*.сгеаіеЕ1егпеп*("сапѵаз"); // Невидимый холст 
оГГзсгееп. місіІН = оГГзсгееп. НеідНГ = 10; // Установить его размеры 

оГГзсгееп. деІіСопІіехІ: ( "2сІ” ). зі:гокеПесІ: (0,0,6, 6); // Получить контекст 

// и нарисовать прямоугольник 
ѵаг раГГегп = с.сгеаГеРаГГегп(оГГзсгееп,"гереаГ");// И использовать как шаблон 
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Чтобы выполнить заливку (или нарисовать контур) градиентом, следует присво¬ 
ить свойству ГіІІЗііуІе (или зіігокеЗііуІе) объект СапѵазСгасІіепІ:, возвращаемый мето¬ 
дом сгеа1:еІ_іпеагСгасІіеп1:() или сгеаіейасІіаІСгасІіепіО объекта контекста. Создание^ 
градиентов выполняется в несколько этапов, и в использовании они несколько 
сложнее, чем шаблонные изображения. 

Первый этап - создание объекта СапѵазСгасІіепІ:. В качестве аргументов методу сге- 
а1:еІ_іпеагСгасІіеп1:( ) передаются координаты двух точек, определяющих линию (она 
необязательно должна быть горизонтальной или вертикальной), вдоль которой бу¬ 
дет изменяться цвет. Аргументы метода сгеаіеВасІіаІСгасІіепіО определяют центры 
и радиусы двух окружностей. (Они необязательно должны быть концентрически¬ 
ми, но первая окружность обычно полностью располагается внутри второй.) Об¬ 
ласти внутри малой окружности и за пределами большой окружности будут за¬ 
полняться сплошным цветом, а область между окружностями - градиентом. 

После того как объект СапѵазСгасІіепІ: создан и определены области холста для за¬ 
ливки, необходимо определить цвета градиента вызовом метода асІсІСоІо г31:ор() объ¬ 
екта СапѵазСгасІіепІ:. В первом аргументе этому методу передается число в диапазо¬ 
не от 0.0 до 1.0. Во втором - цвет в формате, поддерживаемом С88. Этот метод дол¬ 
жен вызываться как минимум два раза, чтобы определить простой градиент, но 
его можно вызвать большее число раз. Цвет, соответствующий значению 0.0, бу¬ 
дет использоваться в начале градиента, а цвет, соответствующий значению 1.0, - 
в конце. Если вы решите указать дополнительные цвета, они будут использовать¬ 
ся в промежуточных позициях градиента. В любой другой точке градиента зна¬ 
чение цвета будет вычисляться методом интерполяции. Например: 

// Линейный градиент, по диагонали холста (предполагается, что преобразования отсутствуют) 
ѵаг ЬдГаРе = с.сгеа1:еІ_іпеаг6гасІіепі:(0,0,сапѵа5.місІ1:Н,сапѵа5.НеідІтІ:); 

ЬдГасІе.асІсІСоІо г31:ор(0.0, "#88Г”); // От светло-синего вверху слева 
ЬдГасІе. асІсІСо1ог31:ор( 1.0, "#ГГГ"); // До белого внизу справа 

// Градиент между двумя концентрическими окружностями. Прозрачный в середине 
// до полупрозрачного серого и опять до прозрачного, 
ѵаг реекЬоІе = с. сгеаІіеРасІіаІСгасііепі: (300,300,100, 300,300,300); 
реекМоІе.асІсІСоІог51:ор(0.0, "Ггапзрагепі:"); // Прозрачный 

реекЬоІе.асІсІСоІо г31:ор(0. 7, "гдЬа(100,100,100, .9)"); // Полупрозрачный серый 
реекЬоІе. асІсІСоІо гЗГорО . 0, "гдЬа(0,0,0,0)"); // Опять прозрачный 


Важно понимать, что градиенты тесно связаны с местоположением в холсте. При 
создании градиента вы указываете его границы. Если после этого попытаться 
выполнить заливку области за этими границами, будет использован сплошной 
цвет, соответствующий одному или другому концу градиента. Если, к примеру, 
вы определите градиент вдоль линии, соединяющей точки (0,0) и (100, 100), этот 
градиент можно будет использовать только для заливки объектов, находящихся 
внутри прямоугольной области (0,0,100,100). 

Рисунок, изображенный на рис. 21.10, был создан с использованием шаблона 
раііегп и градиентов Ьд'ГасІе и реекЬоІе с помощью следующего программного кода: 


с. ГіІІЗГуІе = ЬдГасІе; 
с. ііІІВесКО, 0,600, 600); 
с. зігокеЗГуІе = раГГегп; 
с. ІіпеМісІІіЬ = 100; 
с. зі: гокеПес1:( 100,100,400,400); 


// Сначала использовать линейный градиент 
// Залить весь холст 

// Использовать шаблон для рисования линий 
// Очень толстые линии 
// Нарисовать большой квадрат 
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с. ГіІІЗІіуІе = реекМоІе; // Использовать радиальный градиент 

с. Гі11Рес1:(0, 0,600,600); // Покрыть холст этой полупрозрачной заливкой 

21.4.8. Атрибуты рисования линий 

Вы уже знакомы со свойством ІіпеМісНіН, которое определяет толщину линий, ри¬ 
суемых методами зігокеО и зігокеВесІіО* Кроме свойства ПпеМісИН (и конечно же, 
зІігокеЗііуІе) существует еще три графических атрибута, влияющих на рисование 
линий. 

По умолчанию свойство ІіпеМісНіН имеет значение 1, и ему можно присвоить любое 
положительное целое число, и даже дробное число меньше 1. (Линии толщиной 
менее одного пиксела рисуются полупрозрачными цветами, поэтому они выгля¬ 
дят менее темными по сравнению с линиями толщиной в 1 пиксел). Чтобы полно¬ 
стью понять действие свойства ІіпеМісНіН, представьте контур как комбинацию 
бесконечно тонких одномерных линий. Прямые линии и кривые, рисуемые мето¬ 
дом з1:гоке(), центрируются по этому контуру, выступая на половину ІіпеІл/ісІІіП 
в обе стороны. Если при рисовании замкнутого контура необходимо, чтобы види¬ 
мы были только части линий за пределами контура, нарисуйте сначала контур, 
а затем залейте его непрозрачным цветом, чтобы скрыть части линий, которые 
вторгаются внутрь контура. Или, если необходимо, чтобы видимы были только 
части линий внутри замкнутого контура, вызовите сначала методы заѵе( ) и с1ір( ) 
(раздел 21.4.10), а затем методы зігокеО и гез1:оге(). 

Из-за имеющейся возможности изменять масштаб по осям координат, как пока¬ 
зано на рис. 21.7, толщина линий зависит от текущего преобразования. Если вы¬ 
полнить вызов зса1е(2,1), чтобы изменить масштаб по оси X и оставить нетрону¬ 
тым масштаб по оси У, вертикальные линии будут получаться в два раза толще 
горизонтальных, нарисованных с одним и тем же значением свойства ІіпеІл/ісІІіН. 
Важно понимать, что толщина линий определяется значением свойства ІіпеМісІІіН 
и текущим преобразованием, имевшимися на момент вызова метода 5Ігоке( ), а не 
на момент вызова метода 1іпеТо( ) или другого метода конструирования контура. 

Три других атрибута рисования линий определяют внешний вид несоединенных 
концов контура и вершин, где соединяются два фрагмента контура. Они оказыва¬ 
ют весьма несущественное влияние на внешний вид тонких линий, но обеспечи¬ 
вают существенные отличия при рисовании толстых линий. Действие двух этих 
свойств иллюстрируется изображением на рис. 21.11. Здесь контур показан как 
тонкая черная линия, а результат рисования линий - как окружающая ее серая 
область. 


ЩШЩШШШ ЬиН 

мШШШШзц иаге 
Дішрмі гоипсі 





Рис. 21.11. Действие атрибутов ІіпеСар и Ііпе^іп 

Свойство ІіпеСар определяет, как будут выглядеть концы незамкнутых фрагмен¬ 
тов контуров. Значение «ЪиН» (по умолчанию) соответствует завершению линий 
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непосредственно в конечной точке. При значении «вдиаге» линия будет продол¬ 
жена за конечную точку на половину толщины и будет иметь квадратный конец. 
А при значении «гоипб» линия будет продолжена за конечную точку на половину 
толщины и будет иметь закругленный конец (с радиусом закругления в половину 
толщины линии). 

Свойство Ііпеиоіп определяет внешний вид вершин, соединяющих фрагменты 
контура. По умолчанию это свойство имеет значение «тііег», при котором внеш¬ 
ние края линий двух фрагментов контура будут продолжены, пока они не встре¬ 
тятся. При значении «гоипб» вершины получают закругленную форму, а при зна¬ 
чении «Ъеѵеі» вершины обрезаются прямыми линиями. 

Последнее свойство, связанное с рисованием линий, - это свойство тііегІ_ітіі, ко¬ 
торое используется, только когда свойство Ііпеиоіп имеет значение «тііег». Когда 
две линии соединяются под острым углом, сопряжение между ними может ока¬ 
заться довольно протяженным, и эти протяженные сопряжения могут нарушать 
визуальную гармонию. Свойство тііегІЛтіі определяет верхнюю границу протя¬ 
женности сопряжений. Если сопряжение в некоторой вершине оказывается длин¬ 
нее половины длины линии, умноженной на значение тііегІ_ітіі, эта вершина бу¬ 
дет нарисована с обрезанным сопряжением. 

21.4.9. Текст 

Для рисования текста в холсте обычно используется метод Гі11Техі( ), который ри¬ 
сует текст, используя цвет (градиент или шаблон), определяемый свойством 
ГіІІЗіуІе. Если необходимо использовать специальные эффекты при выводе тек¬ 
ста крупными символами, для рисования контуров отдельных символов можно 
применить метод зігокеТехі() (пример вывода контуров символов приводится на 
рис. 21.13). Оба метода принимают в первом аргументе текст, который требуется 
нарисовать, и координаты X и У вывода текста во втором и третьем аргументах. 
Ни один из этих методов не вносит изменений в текущий контур и не смещает 
текущую точку. Как видно на рис. 21.7, при выводе текста учитывается текущее 
преобразование системы координат. 

Свойство Гоп! определяет шрифт, который будет использоваться для рисования 
текста. Значение этого свойства должно быть строкой с соблюдением синтаксиса 
С88-атрибута Гопі:. Например: 

"48р1: запз-зегіГ” 

"Ьоісі 18рх Тітез Нотап" 

"іііаііс 12р1: топозрасесГ 

"Ьоісіег зтаііег зегіГ" // жирнее и меньше, чем шрифт элемента <сапѵаз> 

Свойство ГехГАІідп определяет способ выравнивания текста по горизонтали с уче¬ 
том координаты X, переданной методу ГіПТехіО или зГгокеТехГО. Свойство ГехГ- 
Вазеііпе определяет способ выравнивания текста по вертикали с учетом коорди¬ 
наты У. На рис. 21.12 показано действие всех допустимых значений этих свойств. 
Тонкая линия рядом с каждой строкой текста - это опорная линия шрифта, а ма¬ 
ленький квадратик обозначает точку (х.у), координаты которой были переданы 
методу Гі11Техі(). 

По умолчанию свойство ГехГАПдп имеет значение «зіагі». Обратите внимание, что 
для текста, который записывается слева направо, выравнивание, определяемое 
значением «зіагі», совпадает с выравниванием, определяемым значением «Іеіі», 
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аналогично совпадает и действие значений «еші» «гі&М». Однако если в элементе 
<сапѵаз> определить атрибут сііг со значением «гіі» (гі^М-іо-ІеИ - справа налево), 
действие значения «віагі» выравнивания будет совпадать с действием значения 
«гі&М», а действие значения «еші» - с действием значения «Іеіі». 


$іагі 

*ор АЬсе/§ 
Напдіпд АЬсе/§ 
шісісііе АЪсе/% 
аІрНаЬегіс Аксе/§. 
ісІеодгарИіс 
ЬоНот 


Іей 

сз- 

АЬсе/8 


сепіег гідНі 

-Й. . 

АЬсе/ё АЬсе/ё 


О . .8- -Г: 

ЛЬсе/§ ЛЬсе/§ АЬсе/§ 


АЬсе/% 

Аксе/# 

АЬсе/в 

АЬсе/в 


АЪсе/% АЪсе/$* 
АЪсе/& АЬсе/& 
АЬсе& АЬсе/д 
АЬсе/е АЬсеІе 

...^...К..О...К..Сгг, 


епсі 

АЬсе/ё 

АЬсе& 

АЬсе/§ 

АЬсе/& 

АЬсе/в 

АЬсе/з 


Рис . 21.12, Действие свойств іехіАІідп и іехіВазеІіпе 


Свойство ІіехІіВазеІіпе по умолчанию имеет значение «аІрЪаЪеІіс», которое соот¬ 
ветствует алфавиту Ьаііп и подобным ему. Значение «ібео^гарЬіс» используется 
совместно с идеографическими алфавитами, такими как китайский и японский. 
Значение «Ьап^іп^» предназначено для использования со слоговыми и подобны¬ 
ми им алфавитами (которые используются во многих языках в Индии). Значения 
«іор», «ті<1<11е» и «ЪоМот» определяют исключительно геометрическое положе¬ 
ние опорной линии шрифта, исходя из размеров «кегельной площадки» шрифта. 

Методы 1 = і11Тех1:( ) и 5ІігокеТех1і() принимают четвертый необязательный аргумент. 
Этот аргумент определяет максимальную ширину отображаемого текста. Если 
текст окажется шире указанного значения, при заданном значении свойства 'Гопі: 
будет выполнено его масштабирование или будет использован более узкий или 
более мелкий шрифт. 

Если вам потребуется узнать размеры текста до его вывода, передайте его методу 
теазигеТех1і(). Этот метод возвращает объект ТехІіМеІігісз, определяющий размеры 
для текущего значения свойства 'Гопі:. На момент написания этих строк объект 
ТехІіМеІігісз позволял определить только ширину текста. Определить ширину тек¬ 
стовой строки на экране можно следующим образом: 

ѵаг ѵу/ісіііМ = с .теази геТехІ:(Ііехі: ). ѵ\/ісІ1:Гі ; 

21.4.10. Отсечение 

После определения контура обычно вызывается метод 5ігоке( ) или Ті11( ) (или оба). 
Можно также вызвать метод с1ір(), чтобы определить область отсечения. После 
того как область отсечения будет определена, рисование будет выполняться толь¬ 
ко в ее пределах. На рис. 21.13 изображен сложный рисунок, полученный с ис¬ 
пользованием областей отсечения. Вертикальная полоса в середине и текст вдоль 
нижнего края рисунка были нарисованы до определения области отсечения, а за¬ 
ливка была выполнена после определения треугольной области отсечения. 
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Рис, 21,13, Рисование контуров выполнено до, а заливка - после определения 
области отсечения 


Изображение на рис. 21.13 было получено с помощью метода ро1удоп() из приме¬ 
ра 21.4 и следующего программного кода: 


// Определить некоторые графические атрибуты 


с.ГопІ: = "Ьоісі бОрТ запз-зегіГ'; 
с. ІіпеІл/ісІІіЬ = 2; 
с. зТгокеЗТуІе = "#000"; 

// Контур прямоугольника и текст 
с. з1:гокеВес1:(175, 25, 50, 325); 
с. 5І:гокеТех1:("<сапѵаз>”, 15, 330); 


// Большой шрифт 
// Узкие 

// и черные линии 

// Вертикальная полоса в середине 
// зі:гокеТехІ: () вместо ГШТехТО 


// Определить сложный контур, внутренняя область которого является внешней. 

ро1удоп(с,3,200,225,200); // Большой треугольник 

ро1удоп(с,3,200,225,100,0,Тгие); // Нарисовать маленький треугольник 

// в обратном направлении 

// Превратить этот контур в область отсечения. 
с.сІірО; 


// Нарисовать контур линиями толщиной 5 пикселов, внутри области отсечения, 
с. ІіпеІл/ісІІіЬ = 10; // Половина этой линии толщиной 10 пикселов окажется 

// за пределами области отсечения 

с. з1:гоке(); 

// Залить область контура прямоугольника и текста, попавшую в область отсечения 
с.ГіІІЗІіуІе = "#ааа" // Светло-серый 

с.Ш1ВесИ(175, 25, 50, 325); // Залить вертикальную полосу 

с.ГіІІЗІіуІе = "#888" // Темно-серый 

с. Гі11Тех1:("<сапѵа5>", 15, 330); // Залить текст 


Важно отметить, что при вызове метода с1ір() выполняется усечение самого те¬ 
кущего контура, и этот новый усеченный контур становится новой областью от¬ 
сечения. Это означает, что метод с1ір() может только сжимать область отсечения 
и не способен расширять ее. Метода, который позволил бы сбросить область отсе¬ 
чения, не существует, поэтому перед вызовом метода с1ір( ) следует вызвать метод 
заѵе( ), чтобы позднее можно было вернуться к неусеченному контуру вызовом ме¬ 
тода гезІогеО. 
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21.4.11. Тени 

Объект СапѵазПепс1егіпдСоп1:ех1:20 имеет четыре свойства графических атрибутов, 
управляющих рисованием теней. Если присвоить этим свойствам соответствую¬ 
щие значения, любые линии, области, текст или изображения будут отбрасывать 
тени, что создаст эффект расположения этих элементов над поверхностью холста. 
На рис. 21.14 показано, как выглядят тени, отбрасываемые закрашенным прямо¬ 
угольником, контуром прямоугольника и закрашенным текстом. 



НѳИо ѴѴогІсІ 



Рис, 21,14, Автоматически сгенерированные тени 

Свойство зИас!о\л/Со1ог определяет цвет тени. Значением по умолчанию является 
полностью прозрачный черный цвет, и тени остаются невидимыми, если только 
не присвоить этому свойству значение, соответствующее полупрозрачному или 
непрозрачному цвету. Этому свойству допускается присваивать только строковые 
значения цвета: для рисования теней не могут использоваться шаблоны и гради¬ 
енты. Использование полупрозрачных цветов дает более реалистичное изображе¬ 
ние теней из-за просвечивания фона. 

Свойства зМасІоѵл/О'Г'ГзеІіХ и зОайомОТТзеТУ определяют смещение тени по осям X и У. 
По умолчанию оба свойства имеют значение 0, что соответствует размещению те¬ 
ни непосредственно под рисунком, где она невидима. Если присвоить обоим свой¬ 
ствам положительные значения, тени будут нарисованы правее и ниже рисунка, 
как если бы источник света, освещающий холст, находился за пределами экрана 
левее и выше. Чем больше смещение, тем длиннее отбрасываемая тень и тем «вы¬ 
ше» над холстом будет казаться нарисованный объект. 

Свойство зИасІо\л/В1иг определяет, насколько размытым будет выглядеть край тени. 
По умолчанию это свойство имеет значение 0, которому соответствую четкие, не¬ 
размытые тени. Большие значения производят более сильный эффект размытия, 
до определенной степени, определяемой реализацией. Значение этого свойства 
используется как параметр Гауссовой функции размытия и не является разме¬ 
ром или длиной в пикселах. 

В примере 21.8 представлен программный код, который использовался для полу¬ 
чения изображения на рис. 21.14 и демонстрирующий использование всех четы¬ 
рех свойств, управляющих отображением теней. 

Пример 21,8. Установка параметров тени 
// Определить узкую тень 

с. зНасіомСоІог = "гдЬа(100,100,100,.4)”; // Полупрозрачный серый цвет 
с. зМасІоѵ/ОІ'ГзеІіХ = с. зІтасІоѵѵО^ГзеІіУ = 3; // Тень смещена вправо вниз 
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с. зГіасІоѵѵВІиг = 5; // Размытые границы тени 

// Нарисовать текст в синем прямоугольнике с этими параметрами тени 
с. ІіпеІл/ісіІіН = 10; 
с. зТгокеЗТуІе = "Ыце"; 

с. зі:гокеВесІ: (100, 100, 300, 200); // Нарисовать прямоугольник 

с.ГопІ: = "Воісі Збрі: НеІѵеТіса" ; 

с.ГШТехТСНеПо Іл/огісі", 115, 225); // Нарисовать текст 

// Определить более широкую тень. Большие значения смещений создают эффект более высокого 
// расположения объекта. Обратите внимание, как полупрозрачная тень смешивается 
// с синим контуром прямоугольника, 
с. зНасІо\л/0ГГзе1;Х = с. зНасІомОГГзеІіѴ = 20; 
с. зНасІомБІиг = 10; 

с. ГіІІЗііуІе = "гесі”; // Нарисовать сплошной красный прямоугольник, 

с. Гі11Вес1:(50, 25,200,65); // располагающийся выше синего прямоугольника 

Значения свойств зОасІомОГГзеІіХ и зОасІомОГГзеІіѴ всегда определяются в системе ко¬ 
ординат по умолчанию и не подвержены действию методов го1:а1е() и зса1е(). До¬ 
пустим, к примеру, что вы повернули систему координат на 90 градусов, чтобы 
нарисовать текст по вертикали и затем вернулись к прежней системе координат, 
чтобы нарисовать текст по горизонтали. Обе текстовые надписи, вертикальная 
и горизонтальная, будут отбрасывать тень в одном направлении, что обычно соот¬ 
ветствует нашим представлениям. Аналогично фигуры, нарисованные с приме¬ 
нением различных преобразований, будут иметь тени с одинаковой «высотой». 1 

21.4.12. Изображения 

Помимо векторной графики (контуры, линии и прочее), прикладной интерфейс 
объекта Сапѵаз поддерживает также растровые изображения. Метод сІгамІтадеО 
копирует в холст пикселы из исходного изображения (или из прямоугольной об¬ 
ласти исходного изображения), выполняя операции масштабирования и враще¬ 
ния, если они необходимы. 

Метод с!гаѵ\/Ітаде() может вызываться с тремя, пятью или девятью аргументами. 
Во всех случаях в первом аргументе ему передается исходное изображение. Часто 
в этом аргументе передается элемент <ітд> или неотображаемый объект Ітаде, 
созданный с помощью конструктора Ітаде(). Однако точно так же в первом аргу¬ 
менте можно передать другой элемент <сапѵаз> или даже элемент <ѵіс!ео>. Если 
методу с!гаѵ\/Ітаде() передать элемент <ітд> или <ѵіс!ео>, который к этому моменту 
еще не завершил загрузку изображения, он ничего не скопирует. 

При вызове с тремя аргументами во втором и третьем аргументах методу сігаѵѵ/- 
Ітаде() передаются координаты X и У верхнего левого угла области, в которую 
должно быть скопировано изображение. В этом случае в холст будет скопировано 
изображение целиком. Координаты X и У будут интерпретироваться как коорди¬ 
наты в текущей системе координат, поэтому при необходимости изображение бу¬ 
дет масштабировано или повернуто. 

При вызове метода с1гаі\/Ітаде() с пятью аргументами к аргументам с координата¬ 
ми X и У, описанным выше, добавляются ширина и высота. Эти четыре аргумен- 


1 На момент написания этих строк в версии 5 броузера Ооо^іе СЬготе тени были реали¬ 
зованы с ошибкой, и их смещения были подвержены действию преобразований. 
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та определяют прямоугольную область внутри холста. Верхний левый угол ис¬ 
ходного изображения будет помещен в точку (х.у), а правый нижний - в точку 
(х+ѵасіііі'і, у+ЬеідИІ:). Опять же в холст будет скопировано изображение целиком. 
Прямоугольная область назначения определяется в текущей системе координат. 
Эта версия метода выполнит масштабирование изображение, чтобы уместить его 
в отведенную область, даже если к исходной системе координат не применялось 
преобразование масштабирования. 

При вызове метода с1гаі\/Ітаде() с девятью аргументами ему передаются координа¬ 
ты и размеры области в исходном изображении и области в холсте, и он скопирует 
только указанную область исходного изображения. В аргументах со второго по 
пятый указываются координаты и размеры прямоугольной области в исходном 
изображении. Они измеряются в пикселах С88. Если исходное изображение 
представлено другим элементом <сапѵаз>, координаты и размеры исходного изо¬ 
бражения будут измеряться в системе координат по умолчанию и никакие преоб¬ 
разования, применявшиеся к системе координат исходного холста, учитываться 
не будут. В аргументах с шестого по девятый указываются координаты и разме¬ 
ры области в текущей (а не по умолчанию) системе координат, куда будет скопи¬ 
рован указанный фрагмент изображения. 

Пример 21.9 демонстрирует простой случай применения метода 6 га\л/Ітаде(). В нем 
используется версия метода с девятью аргументами, чтобы скопировать фраг¬ 
мент холста, увеличенный и повернутый, обратно в тот же самый холст. Как вид¬ 
но на рис. 21.15, изображение было увеличено достаточно, чтобы проявилась его 
растровая структура и можно было наблюдать полупрозрачные пикселы, кото¬ 
рые использованы для сглаживания краев линии. 

\ 



Рис. 21,15. Копия изображения была увеличена методом йгаюІта&е( ) 


Пример 21.9. Использование метода йгаи)Іта§е( ) 

Н Нарисовать линию в верхнем левом углу 

с. тоѵеТо(5, 5); 

с. 1іпеТо(45, 45); 

с. ІіпеМісГЫі = 8; 

с. ІіпеСар = "гоипсі"; 

с. з1:гоке(); 

// Определить преобразование системы координат 
с. 1: гапз1а1:е(50,100); 

с. гоііаііе ( -45*Ма1:Гі . РІ/180); // Разгладить линию 

с.зса1е(10,10); // Увеличить ее, чтобы были видны отдельные пикселы 

// С помощью сІгаѵЛтаде скопировать линию 
с.дгам1таде(с. сапѵаз, 

0, 0, 50, 50, // исходная область: непреобразованная 
0, 0, 50, 50); // область назначения: преобразованная 
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Помимо возможности копировать изображение в холст, имеется также возмож¬ 
ность извлекать содержимое холста в виде изображения с помощью метода ІсЮа- 
ІаиРЦ). В отличие от других методов, описанных выше, метод 1:о0а1:аІ)ПІ( ) - это 
метод самого элемента Сапѵаз, а не объекта СапѵазПепс1егіпдСоп1:ех1:20. Обычно метод 
ІсЮаІіаІІВЦ ) вызывается без аргументов и возвращает содержимое холста как РКО- 
изображение, закодированное в виде строки в формате ІШЬ сіаііа :. Возвращаемая 
строка 1ШЬ подходит для использования в элементе <ітд>, благодаря чему можно 
создать статический снимок холста, как показано ниже: 

ѵаг ітд = Роситеп1.сгеа1:еЕ1етеп1:("ітд''); // Создать элемент <ітд> 
ітд.згс = сапѵаз.ІоОаІаиВЦ); // Установить его атрибут зге 

сіоситепі:. Ьосіу. аррепсІСМіІсІ(ітд); // Добавить элемент в документ 

Все броузеры в обязательном порядке поддерживают формат РКС изображений. 
Некоторые реализации могут также поддерживать другие форматы, и вы можете 
указать желаемый МІМЕ-тип в необязательном первом аргументе в вызове мето¬ 
да ІсЮаІіаІЖО. Подробности смотрите в справочном разделе книги. 

Существует одно важное ограничение, связанное с безопасностью, о котором сле¬ 
дует знать, планируя применять метод ІюЮаІіаІІВЦ). Чтобы предотвратить утечку 
информации между доменами, метод ІсЮаІіаиВЦ ) не работает с элементами <сапѵаз>, 
имеющими «неясное происхождение». Считается, что холст имеет неясное проис¬ 
хождение, если в него вставлялось изображение (непосредственно, вызовом мето¬ 
да с!гаѵ\/Ітаде(), или косвенно, с помощью метода СапѵазРа1:1:егп), имеющее происхо¬ 
ждение, отличное от происхождения документа, содержащего элемент <сапѵаз>. 

21.4.13. Композиция 

При рисовании линий и текста, заливке областей или копировании изображений 
может получиться так, что новые пикселы будут накладываться сверху на уже 
существующие в холсте. При рисовании непрозрачных пикселов они просто бу¬ 
дут замещать уже имеющиеся пикселы. Но при рисовании полупрозрачных пик¬ 
селов новые («исходные») пикселы будут объединяться (комбинироваться) со ста¬ 
рыми («целевыми») пикселами так, что старые пикселы будут видны сквозь но¬ 
вые, с учетом степени прозрачности этих пикселов. 

Этот процесс объединения новых полупрозрачных исходных пикселов с сущест¬ 
вующими целевыми пикселами называется композицией , а процесс композиции, 
описанный выше, используется по умолчанию при объединении пикселов. Одна¬ 
ко композиция нужна не всегда. Представьте, что вы нарисовали в холсте рису¬ 
нок, использовав полупрозрачный цвет, и теперь хотите внести в холст времен¬ 
ные изменения, а позднее восстановить оригинальный рисунок. Самый простой 
способ реализовать это состоит в том, чтобы холст (или его область) скопировать 
в другой, неотображаемый холст с помощью метода сіга\л/Ітаде( ). А затем, когда 
придет время восстановить холст, можно скопировать обратно в него фрагмент, 
который был сохранен в неотображаемом холсте. Напомню, что скопированные 
пикселы были полупрозрачными. Если режим композиции будет действовать, 
они не затрут полностью временные изменения. В подобных ситуациях необходи¬ 
мо иметь способ отключать композицию: чтобы вставлять исходные пикселы, иг¬ 
норируя целевые, независимо от степени прозрачности исходных. 

Установить тип композиции можно с помощью свойства д1оЬа1Сотрозі1:е0рега1:іоп. 
По умолчанию оно имеет значение «воигее-оѵег», в соответствии с которым исход- 
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ные пикселы накладываются «поверх» («оѵег») целевых пикселов и объединяют¬ 
ся с ними, если исходные пикселы являются полупрозрачными. Если присвоить 
этому свойству значение «сору», композиция будет отключена: исходные пиксе¬ 
лы будут скопированы в холст без изменений и затрут целевые пикселы. Иногда 
может оказаться полезным еще одно значение свойства д1оЬа1Сотрозі1:е0рега1:іоп - 
«бевііпаііоп-оѵег». При использовании этого вида композиции пикселы объеди¬ 
няются так, как будто исходные пикселы добавляются под существующие целе¬ 
вые пикселы. Если целевые пикселы будут иметь прозрачный или полупрозрач¬ 
ный цвет, некоторые или все исходные пикселы будут видны сквозь этот цвет. 

«воигсе-оѵег», «сіевііпаііоп-оѵег» и «сору» - это три наиболее часто используемых 
вида композиции, однако прикладной интерфейс объекта Сапѵаз поддерживает 
11 значений для атрибута д1оЬа1Сотрозі1:е0рега1:іоп. Названия этих видов компози¬ 
ции достаточно красноречиво объясняют, что они призваны делать, и вам может 
потребоваться немало времени, чтобы разобраться в особенностях разных видов 
композиции, подставляя их названия в примеры, демонстрирующие их действие. 

На рис. 21.16 показаны все 11 видов композиции пикселов с «предельными» зна¬ 
чениями прозрачности: все пикселы являются полностью непрозрачными или 
полностью прозрачными. В каждом из 11 прямоугольников сначала рисовался 
квадрат, который представляет целевые пикселы. Затем устанавливалось свойст¬ 
во д1оЬа1Сотрозі1:е0рега1:іоп и рисовался круг, представляющий исходные пикселы. 


зоигсе-оѵег 



сІеБІіпаЬоп-оѵег 





5оигсе-аЕор 


сіе5йпа1іоп-аІ:ор 


сору ІідНКег 



5оигсе-іп 



сіезіііпаііюгнп 



хог 



зоигсе-оиі: 




Рис. 21.16. Виды композиции пикселов с предельными значениями прозрачности 

На рис. 21.17 изображен похожий пример, в котором использовались пикселы 
с «промежуточными» значениями прозрачности. В этой версии исходный круг 
и целевой квадрат были залиты градиентами, вследствие чего в рисунке присут¬ 
ствуют пикселы с различной степенью прозрачности. 

Вы можете обнаружить, что понять действие того или иного вида композиции со¬ 
всем непросто, когда в операцию вовлечены полупрозрачные пикселы, как в дан¬ 
ном примере. Если у вас есть желание более глубоко разобраться с композицией, 
в справочной статье СапѵазРепс1егіпдСоп1:ех1:20 вы найдете уравнения вычисления 


























700 


Глава 21. Работа с графикой и медиафайлами на стороне клиента 


конечного значения цвета пиксела, исходя из значений цвета исходного и целево¬ 
го пикселов для всех 11 видов композиции. 


5оигсе-оѵег Боигсе-акор зоигсе-іп Боигсе-оиі 



сору ІідЬЕег хог 



Рис, 21,17, Виды композиции пикселов с промежуточными значениями прозрачности 

На момент написания этих строк производители броузеров не смогли прийти 
к единству в реализации 5 из 11 видов композиции: «сору», «воигсе-іп», «воигсе- 
оиі», «сіевііпаііоп-аіор» и «бевііпаііоп-іп» действуют по-разному в разных броузе¬ 
рах и не могут использоваться переносимым образом. Далее приводится подроб¬ 
ное описание этих различий, но если вы не планируете использовать эти виды 
композиций, то можете сразу перейти к следующему разделу. 

При использовании пяти видов композиции, перечисленных выше, цвет целевых 
пикселов либо игнорируется при вычислении результатов, либо получающиеся 
пикселы делаются прозрачными, если прозрачными являются исходные пикселы. 
Различия в реализациях связаны с определением исходных пикселов. Броузеры 
8а1агі и СЬготе выполняют композицию «локально»: в расчетах участвуют толь¬ 
ко фактические исходные пикселы, которые выводятся методами Гі11(), зІгокеО 
и другими. ІЕ9, вероятно, последует этому примеру. Броузеры Гіге^ох и Орега вы¬ 
полняют композицию «глобально»: в расчетах участвуют все пикселы в текущей 
области отсечения при выполнении любой операции рисования. Если для данного 
целевого пиксела отсутствует исходный пиксел, считается, что исходный пиксел 
имеет черный прозрачный цвет. В Еіге^ох и Орега это означает, что пять видов ком¬ 
позиции, перечисленные выше, фактически стирают целевые пикселы внутри об¬ 
ласти отсечения там, где отсутствуют исходные пикселы. Изображения на рис. 21.16 
и рис. 21.17 были получены в броузере Гігеіох. Это объясняет, почему рамки, ок¬ 
ружающие примеры применения видов композиции «сору», «воигсе-іп», «воигсе- 
оиі», «бевііпаііоп-аіор» и «бевііпаііоп-іп», тоньше, чем рамки вокруг других при¬ 
меров: прямоугольник, окружающий каждый пример, является областью отсече¬ 
ния, и применение этих пяти видов композиции приводит к стиранию части рамки 
(половина ІіпеМісІІіН), попадающей внутрь контура. Для сравнения на рис. 21.18 по¬ 
казаны те же результаты, что и на рис. 21.17, но полученные в броузере СЬготе. 
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зоигсе-оѵег зоигсе-акор 


5оигсе-іп 


зоигсе-ои* 




сіезйпайоп-оѵег 


сіезІііпаЕіоп-аЕор 


гіеБйпайоп-іп 


сіеБІіпайоп-оиІ 








сору 




ІідЬЕег 


хог 



Рис, 21,18, Локальная композиция 


На момент написания этих строк проект стандарта НТМЬб утвердил глобальный 
подход к композиции, реализованный в броузерах Гіге^ох и Орега. Производите¬ 
ли броузеров знают об имеющейся несовместимости и не удовлетворены текущим 
состоянием спецификации. Велика вероятность, что спецификация будет пере¬ 
смотрена в пользу локальной композиции. 

Наконец, обратите внимание, что в броузерах, таких как 8а^агі и СЪготе, реали¬ 
зующих локальную композицию, существует возможность реализовать глобаль¬ 
ную композицию. Сначала нужно создать пустой неотображаемый холст с теми 
же размерами, что и отображаемый. Затем нарисовать исходное изображение на 
неотображаемом холсте и вызвать метод с!га\л/Ітаде( ), чтобы скопировать неотобра¬ 
жаемый рисунок в отображаемый холст и применить глобальную композицию 
в пределах области отсечения. В броузерах, таких как ГігеіЪх, реализующих гло¬ 
бальную композицию, нет универсального приема выполнения локальной ком¬ 
позиции, но нередко можно получить достаточно близкий эффект, определив со¬ 
ответствующую область отсечения перед выполнением операции рисования, для 
которой композиция должна выполняться локально. 

21.4.14. Манипулирование пикселами 

Метод де1:Ітаде0а1:а() возвращает объект ІтадеОаІа, представляющий массив пик¬ 
селов (в виде компонентов К, О, В и А) из прямоугольной области холста. Создать 
пустой объект ІтадеОаІа можно с помощью метода сгеа!:еІтаде0а1а(). Пикселы 
в объекте Ітадейаііа доступны для записи, благодаря чему их можно изменить как 
угодно и затем скопировать обратно в холст вызовом метода ри1:Ітаде0а1:а(). 

Эти методы манипулирования пикселами предоставляют низкоуровневый доступ 
к холсту. Координаты и размеры области, передаваемой методу де1:Ітаде0а1:а(), за¬ 
даются в системе координат по умолчанию: ее размеры измеряются в 088-пиксе¬ 
лах и без учета текущего преобразования. При вызове метода ри1:Ітаде0а1:а() коор¬ 
динаты также задаются в системе координат по умолчанию. Кроме того, метод рігЬ- 
Ітаде0а1а( ) игнорирует все графические атрибуты. Он не использует механизм ком¬ 
позиции, не умножает пикселы на значение свойства дІоЬаІАІрРа и не рисует тени. 
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Методы манипулирования пикселами могут пригодиться для реализации обра¬ 
ботки изображений. Пример 21.10 демонстрирует, как создать простейший эффект 
размытия или «смазывания» быстро движущегося объекта в элементе <сапѵаз>~ 
Пример демонстрирует применение методов де*ІтадеОа*а() и рЩІтадеОаІіаО и по¬ 
казывает, как выполнять итерации по пикселам в объекте ІтадеОаІіа и изменять 
их значения, но без подробного описания. Полная информация о методах деііта- 
де0а1а() и ри1:Ітаде0а1:а() приводится в справочной статье СапѵазРепс1егіпдСоп1;ехі;20, 
а подробное описание объекта ІтадеОаІіа - в его собственной справочной статье. 


Пример 21.10. Создание эффекта размытия быстродвижущегося объекта 

с помощью объекта Іта§еБаіа 

// "Смазать" пикселы прямоугольной области вправо, чтобы воспроизвести эффект быстрого 
// движения объекта справа налево. Значение п должно быть равно или больше 2. Нем больше 
// значение, тем сильнее эффект смазывания. Координаты и размеры прямоугольной области 
// задаются в системе координат по умолчанию. 

Гііпсіііоп зтеаг(с, п, х, у, ѵі, б) { 

// Получить объект ІтадеОаІіа, представляющий пикселы области эффекта 
ѵаг ріхеіз = с. де1іІтаде0а1іа(х, у, ѵі, П); 

// Смазывание выполняется на месте, и потому требуется получить только 
// исходный объект ІтадеОаІіа. Некоторые алгоритмы обработки изображений требуют 
// использования дополнительного объекта ІтадеОаІіа для сохранения трансформированных 
// значений пикселов. Если бы потребовался промежуточный буфер вывода, можно было бы 
// создать новый объект ІтадеОаІіа с теми же размерами следующим способом: 

// ѵаг оіі1іріі1і_ріхе1$ = с. сгеа1іеІтаде0а1іа(ріхеіз): 

// Эти размеры могут отличаться от значений аргументов ѵі и П: на каждый 
// СЗЗ-пиксел может приходиться несколько аппаратных пикселов, 
ѵаг ул/ісіііб = ріхеіз. місііііі, Пеідітіі = ріхеіз.Пеідітіі; 

// Это массив байтов, хранящий информацию о пикселах, слева направо и сверху вниз. 

// Для каждого пиксела отводится 4 последовательных байта, в порядке В,6,В,А. 
ѵаг баііа = ріхеіз. баііа; 


// Смазать каждый пиксел после первого в каждой строке, заменив его суммой 
// 1/п-й доли его собственного значения и т/п-й доли значения предыдущего пиксела 
ѵаг т = п-1; 


Гог(ѵаг го ѵі = 0; го ѵі < ПеідНІі; го ѵі++) { 

ѵаг і = го\л/*\л/іс11іП*4 + 4; // 

^ог(ѵаг соі = 1; соі < мібІіП; со1++, і += 4) 
ба1іа[і] = (ба1іа[і] + ба1іа[і-4]*т)/п; 
ба1іа[і+1] = (сІаііа[і+1] + ба1іа[і-3]*т)/п; 
ба1іа[і+2] = (баііа[і+2] + баііа[і-2]*т)/п; 
ба1іа[і+3] = (сІа1іа[і+3] + ба1іа[і-1 ]*т)/п; 

} 

} 


// Для каждой строки 
Индекс второго пиксела в строке 
{ //Для каждого столбца 
// Красная составляющая 
// Зеленая 
// Синяя 

// Альфа-составляющая 


// Скопировать смазанное изображение обратно в ту же позицию в холсте 
с. ріі1іІтаде0а1іа(ріхеіз, х, у): 


Обратите внимание, что на метод де1:Ітаде0а1:а( ) накладываются те же ограничения 
политики общего происхождения, что и на метод ІюОаІаУРЦ ): он не будет работать 
с холстами, в которые вставлялись изображения (непосредственно, вызовом ме¬ 
тода с!гаѵѵІтаде( ), или косвенно, с помощью метода СапѵазРаІіІіегп), имеющие проис¬ 
хождение, отличное от происхождения документа, содержащего элемент <сапѵаз>. 
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21.4.15. Определение попадания 

Метод ізРоіпІІпРаІНО позволяет узнать, находится ли указанная точка внутри 
(или на границе) текущего контура, и возвращает Ігие, если это так, и ^аізе- 
в противном случае. Метод принимает координаты точки в не преобразованной 
системе координат по умолчанию. Это позволяет использовать метод для опреде¬ 
ления попадания : определения принадлежности точки, где был выполнен щел¬ 
чок мышью, некоторой определенной фигуре. 

Однако значения свойств сІіепІіХ и сІіепІіУ объекта МоизеЕѵепІ нельзя передать не¬ 
посредственно методу ізРоіпІІпРа1:Н(). Во-первых, координаты события мыши 
следует преобразовать из координат объекта ілііпсіоѵѵ в относительные координаты 
элемента <сапѵаз>. Во-вторых, если экранные размеры холста отличаются от его 
фактических размеров, координаты мыши необходимо перевести в соответст¬ 
вующий масштаб. В примере 21.11 показана вспомогательная функция, исполь¬ 
зуемая для определения попадания точки события МоизеЕѵепІ; в текущий контур. 

Пример 21.11. Проверка попадания точки события мыши в текущий контур 

// Возвращает ігііе, если указанное событие мыши возникло в текущем контуре 
// в указанном объекте СапѵазВепс]егіпдСопіехі20. 

Іьпсііоп !-)іІраіІі(сопіехІ, еѵепі) { 

// Получить элемент <сапѵа$> из объекта контекста 
ѵаг сапѵаз = сопіехі. сапѵаз; 

// Получить координаты и размеры холста 
ѵаг ЬЬ = сапѵаз.деіВоьпсІіпдСІіепІНесК); 

// Преобразовать и масштабировать координаты события мыши в координаты холста 
ѵаг х = (еѵепі:.сІіепІХ-Ыэ.ІеІЧ)*(сапѵаз.мібІП/ЬЬ.мібІП); 
ѵаг у = (еѵепі:. сІіепіУ-Ыэ. Іор)*(сапѵаз. ПеідПІ/Ыэ. ПеідПІ); 

// Вызвать ізРоіпіІпРаІМ с преобразованными координатами 
геіьгп сопіехі. ізРоіпІІпРаІІ'Кх,у); 

} 

Эту функцию НіІраІНО можно использовать в обработчиках событий, как показа¬ 
но ниже: 

сапѵаз.опсііск = ІипсІіоп(еѵепі:) { 

іі (МіІраЩіМіз.деіСопіехіС^сГ), еѵепі) { 

а1егі("Есть попадание!"); // Щелчок в пределах текущего контура 

} 

}; 

Вместо проверки попадания в текущий контур с помощью метода деІІтаде0а1:а() 
можно определить, окрашен ли пиксел в точке события мыши. Если пиксел (или 
пикселы) под указателем мыши оказался полностью прозрачным, следователь¬ 
но, под указателем мыши ничего не было нарисовано и щелчок был выполнен за 
пределами какой-либо фигуры. Пример 21.12 демонстрирует, как реализовать 
подобную проверку попадания. 

Пример 21.12. Проверка наличия окрашенного пиксела в точке события мыши 

II Возвращает ігііе, если указанное событие мыши возникло в точке, 

// где находится непрозрачный пиксел. 

Іііпсііоп Мііраіпі^сопіехі:, еѵепі) { 
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// Преобразовать и масштабировать координаты события мыши в координаты холста 

ѵаг сапѵаз = сопіехі. сапѵаз; 

ѵаг ЬЬ = сапѵаз. деІВоііпбіпдСІіепіВесК); 

ѵаг х = (еѵепі.сІіепіХ-Ыэ.ІеГТ)*(сапѵаз.мібіб/Ыэ.мібІб); 

ѵаг у = (еѵепі.сІіепТУ-ЬЬ. іор)*(сапѵаз.НеідШ/ЬЬ.ЬеідМ:); 

// Получить пиксел (или пикселы, если одному 055-пикселу соответствует 
// несколько аппаратных пикселов) 
ѵаг ріхеіз = с. деіІтадеОа1:а(х, у, 1,1); 

// Если хотя бы один пиксел имеет ненулевое значение альфа-канала, 

// вернуть Тгііе (попадание) 

Гог(ѵаг і = 3; і < ріхеіз.баіа.ІепдІіГі; і+=4) { 
іГ (ріхеіз.6а1:а[і] !== 0) геТіігп ігііе; 

} 

// Иначе это был промах. 
геТіігп Гаізе; 

} 

21.4.16. Пример использования элемента <сапѵаз>: 
внутристрочные диаграммы 

Закончим главу практическим примером рисования внутристрочных диаграмм. 
Внутристрочная диаграмма (, зрагкііпе )- это маленькое изображение (обычно 
некий график) предназначенное для отображения в потоке текста, например: 
Зегѵег Іоасі: 8. Термин «зрагкііпе» был введен их автором Эдвардом Таф- 

ти (Ес1\ѵаг(1 Тиііе), который описывает внутристрочные диаграммы так: «Ма¬ 
ленькие графические изображения с высоким разрешением, встроенные в кон¬ 
текст окружающих их слов, чисел, изображений. Внутристрочная диаграмма - 
это простой в создании, тесно связанный с данными график, размер которого со¬ 
поставим с размером слова». (Подробнее о создании внутристрочных диаграмм 
см. в книге Эдварда Тафти «ВеаиШЧіІ Еѵісіепсе» [СгарЬісз Ргезз].) 

В примере 21.13 приводится относительно простой модуль на языке ЛаѵаЗсгірі, 
позволяющий вставлять в веб-страницы внутристрочные диаграммы. Порядок 
работы модуля описывается в комментариях. Обратите внимание, что в нем ис¬ 
пользуется функция опІ_оасіО из примера 13.5. 

Пример 21.13. Реализация внутристрочных диаграмм с помощью элемента <сапѵаз> 
/* 

* Отыскивает все элементы с 055-классом "зрагкііпе", анализирует их содержимое 

* как последовательность чисел и замещает их графическим представлением. 

* 

* Определить внутристрочную диаграмму в разметке можно так: 

* <зрап с1азз="5рагк1іпе">3 5 7 6 6 9 11 15</зрап> 

* 

* Определить визуальное оформление диаграмм средствами С55 можно так: 

* .зрагкііпе { Ьаскдгоііпб-соіог: #666; соіог: геб; } 

* 

* - Цвет кривой графика определяется 055-свойством соіог вычисленного стиля. 

* - Сами диаграммы являются прозрачными, поэтому сквозь них просвечивает фон страницы. 

* - Высота диаграммы определяется атрибутом баІа-МеідІтІ:, если он указан, 

* или свойством Гопі-зііе вычисленного стиля в противном случае. 

* - Ширина диаграммы определяется атрибутом баіа-ѵ/ібііі, если он указан, 
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* или числом точек данных, умноженным на значение атрибута баіа-бх, если он 

* указан, или числом точек данных, умноженным на высоту, деленную на 6 

* - Минимальное и максимальное значение по оси у извлекаются из атрибутов 

* баіа-утіп и баіа-утах, если они указаны, иначе отыскиваются минимальное 

* и максимальное значение в данных. 

*/ 

опІ_оасЦГііпс1:іоп( ) { // Когда документ будет загружен 
//Отыскать все элементы с классом "зрагкііпе" 
ѵаг еііз = босіітепі:. деіЕІетепІзВуСІаззНатеС"зрагкііпе"); 
таіп: Гог(ѵаг е = 0; е < еПз. ІепдІП; е++) { // Для каждого элемента 
ѵаг еіі = е11:з[е]; 


// Получить содержимое элемента и преобразовать его в массив чисел. 
// Если преобразование не удалось, пропустить этот элемент, 
ѵаг сопіепі: = еИ.ІехТСопІепі: || еИ. іппегТехІ:; // Содержимое 
ѵаг сопіепі: = сопіепі:. гер1асе(/''\з+|\з+$/д, // Удалить пробелы 


ѵаг ТехТ = сопіепі:. гер1асе(/#. *$/дт, 
Техі: = ТехТ. гер1асе(/[\п\г\і:\ѵ\Г]/д, 
ѵаг баіа = ТехТ.зр1і1:(/\5+1\з*,\з*/); 
^ог(ѵаг і = 0; і < баіа. ІепдІІі; і++) { 
баіа[і] = МіітЬег(баі:а[і]); 
іГ (ізЫаМ(ба1:а[і])) сопііпііе таіп; 


); // Удалить комментарии 
");// Преобр. \п и др. в пробел 
// По пробелам и запятым 
// Каждый фрагмент 
// Преобразовать в число 
// Прервать при неудаче 


} 

// Определить цвет, ширину, высоту и границы по оси у для диаграммы 
// из данных, из атрибутов баіа- элемента и из вычисленного стиля, 
ѵаг зііуіе = деЮотрц1:еб81:у1е(е11, піііі); 
ѵаг соіог = зіуіе.соіог; 

ѵаг ПеідІИ: = рагзеІпКеІІ:.деІАІігіЬціеС'баІіа-ПеідІ'іІ:")) || 
рагзеІпі:(з 1 :у 1 е. Гоп 1 ; 8 і 2 е) || 20; 
ѵаг \л/ібіП = рагзеІп1(е11.деІА11гіЬііі:е("ба1:а-\л/іб1:І'Г)) || 

баіа.ІепдіП * (рагзеІпІ(е1і.де1:А1:і:гіЬіі1:е("ба1:а-бх")) || ПеідПі/б); 
ѵаг утіп = рагзеІпі(е11. деШ1:гіЬіі1:е("ба1:а-утіп")) || Ма1:П.тіп.арр1у(Ма1:П, баіа); 
ѵаг утах = рагзеіпі:(еіі:.де-ГАІіІ:гіЬи1:е(*ба1:а-утах‘’)) || Ма1:П.тах.арр1у(Ма1:П, баіа); 
іГ (утіп >= утах) утах = утіп + 1; 


// Создать элемент <сапѵаз>. 
ѵаг сапѵаз = босіітепі:. сгеаіеЕІетепіС’сапѵаз”); 
сапѵаз.мібІП = ѵѵібІіГі; // Установить размеры холста 

сапѵаз. ПеідІИ: = ПеідПІ:; 

сапѵаз.Ііііе = сопіепі:; // Содержимое использовать как подсказку 
е11. іппегНТМІ_ = // Стереть содержимое элемента 

еІі.аррепбСПіЩсапѵаз); // Вставить холст в элемент 


// Нарисовать график по точкам (і,ба1:а[і]), преобразовав в координаты холста, 
ѵаг сопіехі = сапѵаз.деіСопІехК'26'); 

^ог(ѵаг і = 0; і < баіа.ІепдіП; і++) { // Для каждой точки на графике 

ѵаг х = \л/іб1:П*і/ба1:а.ІепдіП; // Масштабировать і 

ѵаг у = (утах-баіа[і])*ПеідПІ/(утах-утіп); // и баіа[і] 

сопіехі. 1іпеТо(х,у); // Первый вызов ІіпеТоО выполнит тоѵеТоО 

} 

сопіехі:. зі:гоке$1:у1е = соіог; // Указать цвет кривой на диаграмме 
сопіехі:. зігокеО; // и нарисовать ее 
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Под термином НТМЬб обычно подразумевается последняя версия спецификации 
языка разметки НТМЬ, но этот термин также используется для обозначения це¬ 
лого комплекса веб-технологий, которые разрабатываются и определяются как 
часть языка разметки НТМЬ или сопутствующие ему. Официально этот ком¬ 
плекс технологий называется «Ореп ЛѴеЪ РІаНогт». Однако на практике чаще ис¬ 
пользуется сокращенное название «НТМЬб», и в данной главе мы будем исполь¬ 
зовать его именно в этом смысле. В других главах этой книги уже описывались 
некоторые новые прикладные интерфейсы НТМЬб: 

• В главе 15 были представлены методы де1:Е1етеп1:зВуС1аз5№те(), диегуЗеіесІіог- 
А11() и атрибуты данных элементов документа. 

• В главе 16 было описано свойство сІаззИзІ: элементов. 

• В главе 18 рассказывалось о спецификации «ХМЬНіірКециезі Ьеѵеі 2», о вы¬ 
полнении междоменных НТТР-запросов и о прикладном интерфейсе Еѵепі:- 
Зоигсе, определяемом спецификацией «8егѵег-8епі Еѵепіз». 

• В главе 20 был описан прикладной интерфейс ДѴеЬ 8іога&е и кэш приложений 
для автономных веб-приложений. 

• В главе 21 были представлены элементы <аисііо>, <ѵісіео> и <сапѵаз>, а также 
средства для работы с векторной графикой 8ѴС. 

Эта глава охватывает ряд других прикладных интерфейсов НТМЬб: 

• В разделе 22.1 рассматривается прикладной интерфейс объекта Сеоіосаіііоп, 
позволяющий броузерам определять географическое местонахождение поль¬ 
зователя (с его разрешения). 

• В разделе 22.2 рассказывается о прикладных интерфейсах управления исто¬ 
рией посещений, которые позволяют веб-приложениям сохранять и обнов¬ 
лять информацию о своем состоянии в ответ на использование кнопок Васк (На¬ 
зад) и Рогѵѵагсі (Вперед) броузера, без необходимости выполнять полную переза¬ 
грузку страницы с веб-сервера. 

• В разделе 22.3 описывается простой прикладной интерфейс передачи сообще¬ 
ний между документами с различным происхождением. Он обеспечивает без- 
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опасный способ обхода ограничений политики общего происхождения (раз¬ 
дел 13.6.2), препятствующих непосредственному взаимодействию докумен¬ 
тов, полученных от разных веб-серверов. 

• В разделе 22.4 охватывается новая важная особенность НТМЬб: возможность 
выполнять программный код на языке ^ѵа8сгірі в отдельном фоновом потоке 
выполнения и безопасно взаимодействовать с этими «рабочими» потоками. 

• В разделе 22.5 рассматриваются специальные типы данных для работы с мас¬ 
сивами байтов и чисел, более экономно расходующие память. 

• В разделе 22.6 будут представлены двоичные объекты (ВІоЬ): нетипизирован¬ 
ные порции данных, которые служат основным форматом обмена данными, 
используемым различными новыми прикладными интерфейсами для работы 
с двоичными данными. В этом разделе также охватывается несколько типов 
данных, связанных с большими двоичными объектами, и их прикладные ин¬ 
терфейсы: объекты Рііе и РіІеВеасІег, тип ВІоЬВиіІсІег и ШІЬ-адреса вида ЫоЬ://. 

• В разделе 22.7 демонстрируется прикладной интерфейс к файловой системе, 
посредством которого веб-приложения могут читать и писать файлы в частной 
файловой системе. Это один из пока не устоявшихся прикладных интерфей¬ 
сов, и он не описывается в справочном разделе книги. 

• В разделе 22.8 демонстрируется прикладной интерфейс объекта ІпсіехесіОВ, 
предназначенный для сохранения и извлечения объектов в простых базах дан¬ 
ных. Как и интерфейс к файловой системе, прикладной интерфейс ІпсІехесШВ 
пока является нестабильным и не описывается в справочном разделе. 

• Наконец, раздел 22.9 охватывает прикладной интерфейс веб-сокетов АѴеЬ 8о- 
скеіз, позволяющий веб-приложениям устанавливать соединения с веб-серве¬ 
рами и использовать двунаправленные сетевые каналы на основе потоков вме¬ 
сто модели сетевых взаимодействий типа запрос/ответ, поддерживаемой с по¬ 
мощью объекта ХМЫНІіІірРериезІ:. 

Особенности, описываемые в этой главе, либо не укладываются естественным об¬ 
разом ни в одну из тем, обсуждавшихся в предыдущих главах, либо пока не явля¬ 
ются достаточно стабильными и зрелыми, чтобы обсуждать их в основных главах 
этой книги. Некоторые из прикладных интерфейсов выглядят достаточно ста¬ 
бильными, чтобы их можно было описать в справочном разделе, тогда как другие 
все еще продолжают изменяться и потому не были включены в четвертую часть 
книги. На тот момент, когда книга была отправлена в печать, все примеры в этой 
главе, кроме одного (пример 22.9), работали, по крайней мере, в одном из броузе¬ 
ров. Поскольку спецификации, описываемые здесь, все еще продолжают дораба¬ 
тываться, некоторые из этих примеров могут перестать работать, когда вы будете 
читать эту главу. 

22.1. Геопозиционирование 

Прикладной интерфейс объекта Сеоіосаіііоп ( Мір://іѵіѵіѵ.іѵ3.огё/ТК/ёеоІосаііоп-АРІ /) 
позволяет программам на языке ^ѵаЗсгірі запрашивать у броузера географиче¬ 
ское местонахождение пользователя. Такие приложения могут отображать кар¬ 
ты, маршруты и другую информацию, связанную с текущим местонахождением 
пользователя. При этом, конечно, возникает важная проблема соблюдения тай¬ 
ны частной информации, поэтому броузеры, поддерживающие прикладной ин- 
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терфейс Сеоіосаіііоп, всегда запрашивают у пользователя подтверждение, прежде 
чем передать ^ѵаЗсгірі-программе информацию о физическом местонахожде¬ 
нии пользователя. 

Броузеры с поддержкой интерфейса Сеоіосаіііоп определяют свойство паѵідаіогГ 
деоіосаіііоп. Это свойство ссылается на объект с тремя методами: 

паѵідаііог. деоіосаіііоп. де1:Сиггеп1:Розі1:іоп() 

Запрашивает текущее географическое местонахождение пользователя. 

паѵідаіог. деоіосаіііоп. ѵѵа1ісІіРозі1ііоп() 

Не только запрашивает текущее местонахождение, но и продолжает следить 
за координатами, вызывая указанную функцию обратного вызова при изме¬ 
нении местонахождения пользователя. 

паѵідаіог. деоіосаіііоп. с1еаг\л/а1ісИ() 

Останавливает слежение за местонахождением пользователя. В аргументе это¬ 
му методу следует передавать число, возвращаемое соответствующим вызо¬ 
вом метода ѵѵаіі с НРозіііопО. 

В устройствах, включающих аппаратную поддержку ОР8, имеется возможность 
определять местонахождение с высокой степенью точности с помощью устройст¬ 
ва СР8. Однако чаще информация о местонахождении поступает из Всемирной 
паутины. Если броузер отправит ІР-адрес специализированной веб-службе, она 
в большинстве случаев сможет определить (на основе информации о поставщи¬ 
ках услуг Интернета), в каком городе находится пользователь (и рекламодатели 
часто пользуются этой возможностью, реализуя определение местонахождения 
на стороне сервера). Броузер часто в состоянии получить еще более точную ин¬ 
формацию о местонахождении, запросив у операционной системы список бли¬ 
жайших беспроводных сетей и силы их сигналов. Затем эта информация отправ¬ 
ляется веб-службе, которая позволяет вычислить местонахождение с большой 
точностью (обычно с точностью до микрорайона в городе). 

Эти технологии определения географического местонахождения связаны либо 
с обменом данными по сети, либо с взаимодействием с несколькими спутниками, 
поэтому прикладной интерфейс объекта Сеоіосаіііоп является асинхронным: ме¬ 
тоды деЮиггетРозШопО и ѵѵаісИРозіІііопО возвращают управление немедленно, 
но они принимают функцию, которая будет вызвана броузером, когда он опреде¬ 
лит местонахождение пользователя (или когда местонахождение изменится). 
В простейшем случае запрос местонахождения выглядит так: 

паѵідаііог.деоіосаіііоп.деіСиггепіРозі1ііоп(Гііпс1ііоп(ро5) { 
ѵаг Іаііішсіе = роз. соогсіз. Іаіііііисіе; 
ѵаг Іопдіішсіе = роз. соогсіз.Іопдііюсіе; 
а1егіі("Ваши координаты: " + Іаііішсіе + ", + Іопдііюсіе); 

}); 

В дополнение к широте и долготе в ответ на каждый успешный запрос возвраща¬ 
ется также значение (в метрах), указывающее точность определения местонахо¬ 
ждения. Пример 22.1 демонстрирует получение информации о местонахожде¬ 
нии: он вызывает метод деіСиггеп 1 іРо 5 і 1 ііоп(), чтобы определить текущее местона¬ 
хождение, и использует полученную информацию для отображения карты (полу¬ 
ченной от службы Ооо^іе Марз) текущего местонахождения в масштабе, примерно 
соответствующем точности определения местонахождения. 
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Пример 22.1. Использование информации о местонахождении 

для отображения карты 

// Возвращает вновь созданный элемент <ітд>, настроенный (в случае успешного 
// определения местонахождения) на отображение карты для текущего местонахождения. 

// Обратите внимание, что вызывающая программа сама должна вставить возвращаемый 
// элемент в документ, чтобы отобразить его. Возбуждает исключение, если возможность 
// определения местонахождения не поддерживается броузером. 

Гііпсііоп деітарО { 

// Проверить поддержку объекта деоіосаііоп 
іГ (! паѵідаіог.деоіосаііоп) 

1:1тго\л/ "Определение местонахождения не поддерживается": 

// Создать новый элемент <ітд>, отправить запрос определения местонахождения, 

// чтобы в ітд отобразить карту местонахождения и вернуть изображение, 
ѵаг ітаде = с!осіітеп1.сгеа1еЕ1етепі("ітд"); 
паѵідаіог. деоіосаііоп. деіСіі ггепіРозі1іоп( зеіМарІЖ); 
геііігп ітаде: 

// Эта функция будет вызвана после того, как вызывающая программа получит объект 
// изображения, в случае успешного выполнения запроса определения местонахождения. 
Гііпсііоп зеІМарІЖ(роз) { 

// Получить информацию о местонахождении из объекта аргумента 
ѵаг Іаііііісіе = роз. соогбз. Іаііііісіе; // Градусы к северу от экватора 
ѵаг Іопдіііісіе = роз. соогбз. Іопдіііісіе; // Градусы к востоку от Гринвича 
ѵаг ассіігасу = роз.соогбз. ассіігасу; // Метры 

// Сконструировать (Ж для получения статического изображения карты 

// от службы боодіе Мар для этого местонахождения 

ѵаг іі г1 = "Піір://тар5.доод1е.сот/тарз/арі/5Іа1істар" + 

"?сеп1ег=" + Іаііііісіе + + Іопдіііісіе + 

"&5І2е=640х640&зепзог=1 те"; 

// Установить масштаб карты, используя грубое приближение 
ѵаг 2оот1еѵе1=20; // Для начала установить самый крупный масштаб 

іГ (ассіігасу > 80) // Уменьшить масштаб для низкой точности 
гоотіеѵеі -= МаіП. гоііпсІ(Ма1Гі. 1од(ассіігасу/50)/Ма1П. І.М2); 
іігі += "& 20 от=" + гоотіеѵеі; // Добавить масштаб в (Ж 

// Отобразить карту в объекте изображения. Спасибо, боодіе! 
ітаде. зге = іігі; 

} 

} 

Прикладной интерфейс Сеоіосаііоп обладает несколькими особенностями, кото¬ 
рые не были продемонстрированы в примере 22.1: 

• В дополнение к первому аргументу с функцией обратного вызова методы деі- 
СиггепіРозіііопО и ѵѵаісНРозіііопО принимают вторую необязательную функ¬ 
цию, которая будет вызвана в случае неудачного выполнения запроса. 

• Помимо функций обработчиков успешного и неудачного выполнения запроса 
эти два метода принимают в третьем необязательном аргументе объект с пара¬ 
метрами. Свойства этого объекта определяют: желательна ли высокая точ¬ 
ность определения местонахождения, насколько «устаревшей» может быть 
информация о местонахождении и предельное время ожидания определения 
местонахождения. 
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• Объект, который передается обработчику в случае успешного выполнения за¬ 
проса, также включает время и может (на некоторых устройствах) содержать 
дополнительную информацию, такую как высота над уровнем моря, скорость 
и направление перемещения. 

Эти дополнительные возможности демонстрируются в примере 22.2. 


Пример 22.2. Демонстрация всех возможностей определения местонахождения 

// Асинхронно определяет местонахождение и отображает его в указанном элементе. 

ГііпсГіоп \л/Пегеаті(е1Г) { 

// Этот объект передается методу деГСііггеп1іРо5і1ііоп( ) в 3 аргументе 
ѵаг оріііопз = { 

// Чтобы получить координаты с высокой точностью (например, с устройства СРВ), 

// присвойте этому свойству значение Гпіе. Отметьте, однако, что это может 
// увеличить расход энергии в аккумуляторах. 
епаЬІеНідПАссіігасу : Гаізе, // Приблизительно: по умолчанию 

// Определите свое значение, если допустимо брать координаты из кэша. 

// По умолчанию имеет значение 0, что обеспечивает получение самой 
// свежей информации. 

тахітіітАде : 300000, // Пригодна информация, полученная в течение последних 5 минут 
// Предельное время ожидания выполнения запроса. 

// По умолчанию имеет значение ІпГіпіГу, что соответствует бесконечному 
// времени ожидания выполнения запроса вызовом метода деІіСи г геп1:Розі'1:іоп( ) 
Гітеоіііі: 15000 // Ждать не более 15 секунд 

}; 


іГ (паѵідаііог.деоіосагіоп) // Запросить координаты, если возможно 

паѵідаіог.деоіосагіоп.деГСііггепГРозіГіоп(5ііссе55, еггог, оріііопз): 

еізе 

еІГ. іппегНТМІ_ = "Возможность определения местонахождения " + 

"не поддерживается этим броузером": 


// Эта функция будет вызвана в случае неудачного выполнения запроса 
Гііпсіііоп еггог(е) { 

// Объект ошибки содержит числовой код и текстовое сообщение. Коды: 

// 1: пользователь не дал разрешения на определение местонахождения 

// 2: броузер не смог определить местонахождение 

// 3: истекло предельное время ожидания 

еІГ. іппегНТМІ_ = "Ошибка определения местонахождения " + 

е.собе + ": + е.теззаде: 


} 

// Эта функция будет вызвана в случае успешного выполнения запроса 
Гііпсіііоп $іюсе$$(ро$) { 

// Эти поля возвращаются всегда. Обратите внимание, что поле ГітезГатр 
// принадлежит внешнему объекту роз, а не вложенному соогбз. 
ѵаг тзд = "АГ " + 

пе\л/ 0а1іе(ро5.ГітезГатр).ГоІ_оса1еЗіігіпд( ) + " вы находились в " + 
роз.соогбз. ассіігасу + " метрах от точки " + 
роз. соогбз. ІаГіІііісІе + " северной широты " + 
роз. соогбз. ІопдіГіісІе + " восточной долготы.": 


// Если устройство возвращает высоту над уровнем моря, добавить эту информацию. 
іГ (роз. соогсіз.аІГіГцбе) { 
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т$д += " Вы находитесь на высоте " + роз. соогсів.аШІюсІе + " ± " + 
роз. соогйэ. аШіііісІеАссіігасу + " метров над уровнем моря."; 

} 

// Если устройство возвращает направление и скорость движения, 

// добавить и эту информацию. 

іі (роз.соогбз. зреесі) { 

тзд += " Вы перемещаетесь со скоростью " + 

роз.соогрз. зреесі + "м/сек в направлении " + 
роз.соогбз. Меабіпд + 

} 

еіі.іппегНТМІ_ = тзд; // Отобразить информацию о местонахождении 

} 

} 

22.2. Управление историей посещений 

Веб-броузеры запоминают, какие документы загружались в окно, и предоставля¬ 
ют кнопки Васк и РогѵѵагсІ, позволяющие перемещаться между этими документа¬ 
ми. Эта модель хранения истории посещений в броузерах появилась еще в те дни, 
когда документы были статическими и все вычисления выполнялись на стороне 
сервера. В настоящее время веб-приложения часто загружают содержимое дина¬ 
мически и отображают новые состояния приложения без полной перезагрузки 
документа. Такие приложения должны предусматривать собственные механиз¬ 
мы управления историей посещений, если необходимо дать пользователю воз¬ 
можность использовать кнопки Васк и РогѵѵагсІ для перехода из одного состояния 
приложения в другое интуитивно понятным способом. Спецификация НТМЬб 
определяет два механизма управления историей посещений. 

Простейший способ работы с историей посещений связан с использованием свой¬ 
ства ІосаІііоп.НазН и события «ЬазЬсЬап^е». На момент написания этих строк дан¬ 
ный способ был также наиболее широко реализованным: его поддержка в броузе¬ 
рах появилась еще до того, как он был стандартизован спецификацией НТМЬб. 
В большинстве броузеров (кроме старых версий ІЕ) изменение свойства Іосаііоп. 
НазН приводит к изменению ШІЬ, отображаемого в строке ввода адреса, и добав¬ 
лению записи в историю посещений. Свойство НазН определяет идентификатор 
фрагмента в ІШЬ и традиционно использовалось для перемещения к разделу до¬ 
кумента с указанным идентификатором. Но свойство Іосаіііоп. ИазИ не обязатель¬ 
но должно определять идентификатор элемента: в него можно записать произ¬ 
вольную строку. Если состояние приложения можно представить в виде строки, 
эту строку можно будет использовать как идентификатор фрагмента. 

Предусмотрев изменение значения свойства Іосаіііоп. ИазИ, вы даете пользовате¬ 
лю возможность использовать кнопки Васк и РогѵѵагсІ для перемещения между со¬ 
стояниями приложения. Чтобы такие перемещения были возможны, приложе¬ 
ние должно иметь способ определять момент изменения состояния, прочитать 
строку, хранящуюся в виде идентификатора фрагмента, и обновить себя в соответ¬ 
ствии с требуемым состоянием. Согласно спецификации НТМЬб, при изменении 
идентификатора фрагмента броузер должен возбуждать событие «ЬазЬсЬап^е» 
в объекте Ілііпсіоѵ/. В броузерах, поддерживающих событие «ЬазЬсЬап^е», можно 
присвоить свойству ѵѵіпсіоѵѵ. опИазИсИапде функцию обработчика, которая будет 
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вызываться при каждом изменении идентификатора фрагмента документа, вы¬ 
званном перемещением по истории посещений. При вызове эта функция-обработ¬ 
чик должна проанализировать значение ІосаІііоп.НазН и отобразить содержимое 
страницы, соответствующее выбранному состоянию. 

Спецификация НТМЬб также определяет другой, более сложный и более надеж¬ 
ный способ управления историей посещений, основанный на использовании мето¬ 
да Иізііогу.ризЬЗі:а1:е( ) и события «рорзіаіе». При переходе в новое состояние веб¬ 
приложение может вызвать метод Иізііогу. риз1п31:а1:е( ), чтобы добавить это состоя¬ 
ние в историю посещений. В первом аргументе методу передается объект, содер¬ 
жащий всю информацию, необходимую для восстановления текущего состояния 
приложения. Для этой цели подойдет любой объект, который можно преобразо¬ 
вать в строку вызовом метода ^(Жз1:гіпдіГу(), а также некоторые встроенные ти¬ 
пы, такие как Оаііе и ВедЕхр (смотрите врезку ниже). Во втором аргументе передает¬ 
ся необязательное заглавие (простая текстовая строка), которую броузер сможет 
использовать для идентификации сохраненного состояния в истории посещений 
(например, в меню кнопки Васк). В третьем необязательном аргументе передается 
строка ШИ., которая будет отображаться как адрес текущего состояния. Относи¬ 
тельные ІШЬ-адреса интерпретируются относительно текущего адреса докумен¬ 
та и нередко определяют лишь часть ШИ, соответствующую идентификатору 
фрагмента, такую как #зіаіе. Связывание различных состояний приложения 
с собственными ІШЬ-адресами дает пользователю возможность делать закладки 
на внутренние состояния приложения, и если в строке ШИ. будет указан доста¬ 
точное количество информации, приложение сможет восстановить это состояние 
при запуске с помощью закладки. 


Структурированные копии 

Как отмечалось выше, метод ризЬЗі:а1:е( ) принимает объект с информацией 
о состоянии и создает его частную копию. Это полная, глубокая копия объ¬ 
екта: при ее создании рекурсивно копируется содержимое всех вложенных 
объектов и массивов. В стандарте НТМЬб такие копии называются струк¬ 
турированными копиями . Процедура создания структурированной копии 
напоминает передачу объекта функции ^(Ж з1:гіпдіГу( ) и обработку резуль¬ 
тата функцией ^(ЖрагзеО (раздел 6.9). Но в формат ^(Ж можно преобра¬ 
зовать только простые значения ^ѵаЗсгірі, а также объекты и массивы. 
Стандарт НТМЬб требует, чтобы алгоритм создания структурированных 
копий поддерживал возможность создания копий объектов Ьаііе и ВедЕхр, 
ІтадеОаІіа (полученных из элементов <сапѵаз> - раздел 21.4.14) и Рі1еІ_із1:, 
Рііе и ВІоЬ (описывается в разделе 22.6). Функции ЛѵаЗсгірі и объекты 
ошибок явно исключены из списка объектов, поддерживаемых алгорит¬ 
мом создания структурированных копий, также как и большинство объек¬ 
тов среды выполнения, таких как окна, документы, элемент и т. д. 

Вряд ли вам понадобится сохранять файлы или изображения как часть со¬ 
стояния приложения, однако структурированные копии также использу¬ 
ются некоторыми другими стандартами, связанными со стандартом НТМЬб, 
и мы будем встречать их на протяжении всей этой главы. 
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В дополнение к методу ризИ31:а1:е() объект Нізііогу определяет метод гер1асеЗііа1іе(), 
который принимает те же аргументы, но не просто добавляет новую запись в ис¬ 
торию посещений, а замещает текущую запись. 

Когда пользователь перемещается по истории посещений с помощью кнопок Васк 
и РогѵѵагсІ, броузер возбуждает событие «рорзіаіе» в объекте Міпсісм. Объект, свя¬ 
занный с этим событием, имеет свойство с именем зііаііе, содержащее копию (еще 
одну структурированную копию) объекта с информацией о состоянии, передан¬ 
ного методу ризН5ііа1іе(). 

В примере 22.3 демонстрируется простое веб-приложение - игра «Угадай число», 
изображенная на рис. 22.1, - в которой используются описанные приемы сохране¬ 
ния истории посещений, определяемые стандартом НТМЬб, с целью дать пользова¬ 
телю возможность «вернуться назад», чтобы пересмотреть или повторить попытку. 

Когда эта книга готовилась к печати, в броузере Гігеіох 4 было внесено два измене¬ 
ния в прикладной интерфейс объекта Нізііогу, которые могут быть заимствованы 
и другими броузерами. Во-первых, в Рігеіох 4 информация о текущем состоянии 
теперь доступна через свойство зіаііе самого объекта Нізііогу, а это означает, что 
вновь загружаемые страницы не должны ждать события «рорзіаіе». Во-вторых, 
Рігеіох 4 более не возбуждает событие «рорзіаіе» для вновь загруженных страниц, 
для которых отсутствует сохраненное состояние. Это второе изменение означает, 
например, что пример, приведенный ниже, будет работать неправильно в Рігеіох 4. 



і Ш I і 1 і— і і шЯ 




Гт іНіпкіпд а пит... щ ЩІ 


Я диез5іпддате.ЬітІ#диез53 


т іНіпкіпд а питЬег ЬеЫееп 50 апсі 75 


іѵ Ьеіѵѵееп 50 апсі 62 


т іНіпкіпд оі 1 а питЬег Ьеіѵѵееп 0 апсі 100 


41 5 


Ноѵѵ РиІІ Нізіогу 


62 і§ Іоо Ы§Ь. Оиезз а@аіп: 


Рис. 22.1. Игра «Угадай число» 


Примерх 22.3. Управление историей посещений с помощью ризН8іаіе() 

<Ю0СТѴРЕ М:т1> 

<М:т1><ИеасІ><1:і1:1е>І т іГііпкіпд оУ а пілпЬег... <ДШе> 

<5СГІр1І> 

ѵѵіпсіохл/. опіоасі = пемдате; // Начать новую игру при загрузке 

міпсіом.опрорзіаіе = рорЗіаіе; // Обработчик событий истории посещений 

ѵаг зіаіе, іп; // Глобальные переменные, инициализируемые в функции пемдашеО 

Уипсііоп пеѵл/дате(р1ауадаіп) { // Начинает новую игру "Угадай число" 

// Настроить объект для хранения необходимых элементов документа 
иі = { 
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Гіеасііпд: піЛІ, // Заголовок <М> в начале документа, 
рготрі: пиіі. // Текст предложения ввести число, 

іпрііі:: пиіі, // Поле, куда пользователь вводит -числа. 

Іом: пьП, // Три ячейки таблицы для визуального представления 

тісі: пьП, // ...диапазона, в котором находится загаданное число. 

НідП: пьП 

}; 

// Отыскать каждый из этих .элементов по их атрибутам ісі 
Гог(ѵаг ісі іп ьі) иі[ісі] = сіоситепі:.де{Е1етеп1:ВуІсІ(ісІ); 

// Определить обработчик событий для поля ввода 
ьі. іпрьі:. опсПапде = ПапсИебьезз; 

// Выбрать случайное число и инициализировать состояние игры 
зііаііе = { 

п: МаіП. Г1оог(99 * МаТП. гапсЗош()) + 1, // Целое число: 0 < п < 100 
Іоѵѵ/: 0, // Нижняя граница, где находится угадываемое число 

НідН: 100, // Верхняя граница, где находится угадываемое число 

диеззпцт: 0, // Количество выполненных попыток угадать число 

дьезз: ьпсІеГіпесІ // Последнее число, указанное пользователем 

}; 

// Изменить содержимое документа, чтобы отобразить начальное состояние 
с!ізр1ау( з1:а1:е): 

// Эта функция вызывается как обработчик события опіоаб, а также как обработчик щелчка 
// на кнопке Ріау Адаіп (Играть еще раз), которая появляется в конце игры. 

// Во втором случае аргумент ріауадаіп будет иметь значение Тгье, и если это так, 

// мы сохраняем новое состояние игры. Но если функция была вызвана в ответ 
// на событие "ІоасГ, сохранять состояние не требуется, потому что событие "ІоасГ 
// может возникнуть также при переходе назад по истории посещений из какого-то 
// другого документа в существующее состояние игры. Если бы мы сохраняли начальное 
// состояние, в этом случае мы могли бы затереть имеющееся в истории актуальное 
// состояние игры. В броузерах, поддерживающих метод рьзПЗТаТеС), за событием "ІоасГ 
// всегда следует событие "рорзТаТе". Поэтому, вместо того чтобы сохранять 
// состояние здесь, мы ждем событие “рорзТаТе". Если вместе с ним будет получен 
// объект состояния, мы просто используем его. Иначе, если событие "рорзТаіе" 

// содержит в поле зТаТе значение пьП, мы знаем, что была начата новая игра, 

// и поэтому используем герІасеВіаІіе для сохранения нового состояния игры. 

(ріауадаіп === *ще) заѵе(зііаііе); 

} 

// Сохраняет состояние игры с помощью метода ризИЗііаІіе(), если поддерживается 
^ьпсіііоп заѵе(з1:а1:е) { 

іі 1 (! Пізііогу. ріізІі$*а*е) геіигп\// Вернуться, если ризИ31:а1:е() не определен 

// С каждым состоянием мы связываем определенную строку ІЖІ_-адреса. 

// Этот адрес отображает число попыток, но не содержит информации о состоянии игры, 
// поэтому его нельзя использовать для создания закладок. 

// Мы не можем поместить информацию о состоянии в ІЖІ_-адрес, 

// потому что при этом пришлось бы указать в нем угадываемое число, 
ѵаг игі = "«дьезз" + зііаііе. диеззпит; 

// Сохранить объект с информацией о состоянии и строку ІЖІ_ 

Пізііогу. ризЬ31:а'1:е( зііаііе, // Сохраняемый объект с информацией о состоянии 

// Заглавие: текущие броузеры игнорируют его 
ьгі); // ІЖІ_ состояния: бесполезен для закладок 


} 
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// Обработчик события опрорзІіаТе, восстанавливающий состояние приложения. 

^ыпсТіоп рор8ТаТе(еѵепТ) { 

іТ (еѵепі:. зТаТе) { // Если имеется объект состояния, восстановить его 
// Обратите внимание, что еѵепТ.зІіаТе является полной копией 
// сохраненного объекта состояния, поэтому мы можем изменять его, 

// не опасаясь изменить сохраненное значение. 

зііаііе = еѵепі.зііаііе; // Восстановить состояние 

сІізрІауСзііаііе ); // Отобразить восстановленное состояние 

} 

еізе { 

// Когда страница загружается впервые, событие "рорзііаііе" поступает 
// без объекта состояния. Заменить значение піЛІ действительным 
// состоянием: смотрите комментарий в функции пемдате(). 

// Нет необходимости вызывать СІізрІауС ) здесь. 

бізііогу. гер1асе5ііа1іе(зііаііе, "Ядііезз" + зііаііе.диеззпцт); 

} 

}; 

// Этот обработчик событий вызывается всякий раз, когда пользователь вводит число. 
// Он обновляет состояние игры, сохраняет и отображает его. 
і^псіііоп бапсИебьеззС) { 

// Извлечь число из поля ввода 
ѵаг д = рагзеІпКШз.ѵаіііе); 

// Если это число и оно попадает в требуемый диапазон 
іі ((д > зііаііе. Іом) && (д < зііаііе.Нідб)) { 

// Обновить объект состояния для этой попытки 

іі (д < зііаііе. п) зііаііе. Іоѵѵ = д; 

еізе іі (д > зііаііе.п) зііаііе.Нідб = д; 

зііаііе. дьезз = д; 

зііаііе. диеззпит++; 

// Сохранить новое состояние в истории посещений 
за ѵе( зііаііе): 

// Изменить документ в ответ на попытку пользователя 
сИзрІау(зііаііе) : 

} 

еізе { // Ошибочная попытка: не сохранять новое состояние 
аІегІіС’РІеазе епіег а пьтЬег дгеаіег іНап " + зііаііе . Іоѵѵ + 
апсі Іезз ІНап " + зііаііе.Нідб); 

} 

} 

// Изменяет документ, отображая текущее состояние игры. 

^ьпсіііоп с1І5р1ау(зііаііе) { 

// Отобразить заголовок документа 
ііі. Неасііпд. іппегНТМІ. = сіоситепіі. Іііііе = 

"Гт ІНіпкіпд оі 1 а піітЬег Ьеімееп " + 
зііаііе. 1о\ѵ + " апсі " + зііаііе.Нідб + 

// Отобразить диапазон чисел с помощью таблицы 
іл. 1о\л/. зііуіе.ѵл/ісіііб = зііаііе. Іоѵѵ + 
ці.тісі. зіуіе.ѵѵісіііб = (зііаііе. б ід б- зііаііе. Іоѵл/) + 
ці. бідб. зііуіе.ѵл/ісіііб = (100-зІіаІіе. Ыдб) + 

// Сделать поле ввода видимым, очистить его и установить фокус ввода 
ііі. іпрііі. зііуіе. ѵізіЬіПІіу = "ѵізіЫе"; 
ьі. іприіі. ѵаіье = 
ці. іпрціі. ^осьзС); 
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// Вывести приглашение к вводу, опираясь на последнюю попытку 
іГ (зТаТе. дьезз === ьпсІеГіпесІ) 

іл. рготрТ. іппегНТМЬ = "Туре уоьг дііезз апсі ИіТ ЕпТег: 
еізе (зТаТе. дьезз < зТаТе.п) 

іл. рготрт. іппегНТМІ. = зТаТе. дііезз + " із Тоо Іом. Сьезз адаіп: 
еізе іГ (зГаГе. дьезз > зГаГе.п) 

іл. рготрГ. іппегНТМІ_ = зГаГе. дьезз + " із Гоо ЬідГі. Сьезз адаіп: 
еізе { 

// Если число угадано, скрыть поле ввода и отобразить кнопку 
// Ріау Адаіп (Играть еще раз). 

ііі. іпрііГ. зГуІе. ѵізіЬіІіГу = "Гіісісіеп”; // Попыток больше не будет 
иі. Пеасііпд. іппегНТМІ = сіосіітеп*.ТШе = зГаГе. дьезз + " із соггесГ! 
іл. рготрГ. іппегНТМІ. = 

"Ѵоіі Іл/іп! <Ьы1:Топ опс1іск='пеѵѵдате(іігие)’>Р1ау Адаіп</Ьіі1:1:оп>"; 

} 

} 

</зсгір1:> 

<5І:у1е> /* 085-стили, чтобы придать игре привлекательный внешний вид */ 

#рготрГ { ГопГ-зііе: ІбрГ; } 

ГаЫе { місНЬ: 90%; тагдіп:10рх; тагдіп-ІеГІ::5%; } 

#1см, ШдП { Ьаскдгоітсі-соіог: НдПГдгау; ІіеідШ: Іет; } 

ЯтісІ { Ьаскдгоьпсі-соіог: дгееп; } 

</з1:у1е> 

</ПеасІ> 

<ЬосІу><!— Следующие элементы образуют пользовательский интерфейс игры --> 

<!-- Заголовок игры и текстовое представление диапазона чисел --> 

<М ісІ="ПеасІіпд">Гт ГПіпкіпд оГ а пьтЬег... </М> 

<!-- визуальное представление чисел, которые еще не были исключены --> 

<ГаЫе><Гг><і:сІ ій="1оѵГ><ДсІ><Т(1 ісі=’шісі"></1:сі><1:сі ісІ="ГіідІг”></1:сІ></1:г></1:аЫе> 

<!-- Поле ввода чисел --> 

<1аЬе1 ісІ=”рготр1:"></1аЬе1><іпри1: іс!=”іприі:” Гуре="ТехТ"> 

</ЬосІу></М:т1> 

22.3. Взаимодействие документов 
с разным происхождением 

Как отмечалось в разделе 14.8, некоторые окна и вкладки броузера полностью изо¬ 
лированы друг от друга, и сценарий, выполняющийся в одном окне или вкладке, 
ничего не знает о существовании других окон и вкладок. В других случаях, когда 
сценарий сам открывает новые окна или работает с вложенными фреймами, сце¬ 
нарии в этих окнах и фреймах могут быть осведомлены друг о друге. Если эти окна 
или фреймы содержат документы, полученные от одного и того же веб-сервера, 
сценарии в этих окнах и фреймах смогут взаимодействовать друг с другом и ма¬ 
нипулировать документами друг друга. 

Однако иногда сценарий имеет возможность сослаться на другой объект Міпсіом, 
но, поскольку содержимое этого окна имеет иное происхождение, веб-броузер 
(следующий требованиям политики общего происхождения) не позволит сцена¬ 
рию просматривать содержимое документа в этом другом окне. Броузер не позво¬ 
лит сценарию читать значения свойств или вызывать методы другого окна. Един¬ 
ственный метод окна, который может вызвать сценарий из документа с другим 
происхождением, называется розі:Меззаде(), и этот метод обеспечивает возмож- 
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ноетъ ограниченных взаимодействий - в форме асинхронных сообщений - между 
сценариями из документов с разным происхождением. Этот вид взаимодействий 
определяется стандартом НТМЬб и реализован во всех текущих броузерах (вклю¬ 
чая ІЕ8 и более поздние версии). Этот прием известен как «обмен сообщениями 
между документами с разным происхождением», но, так как прикладной интер¬ 
фейс поддержки определен в объекте Міпсісм, а не в объекте документа, возможно, 
лучше было бы назвать этот прием «обменом сообщениями между окнами». 

Метод розіМеззадеО принимает два обязательных аргумента. Первый - переда¬ 
ваемое сообщение. Согласно спецификации НТМЬб, это может быть любое про¬ 
стое значение или объект, который можно скопировать (смотрите врезку «Струк¬ 
турированные копии» выше), но некоторые текущие броузеры (включая Ріге&х 4 
Ъеіа) принимают только строки, поэтому, если в сообщении потребуется передать 
объект или массив, его необходимо будет предварительно сериализовать с помо¬ 
щью функции ^(Жз1:гіпді1 : у() (раздел 6.9). 

Во втором аргументе должна передаваться строка, определяющая ожидаемое про¬ 
исхождение окна, принимающего сообщение. Эта строка должна включать прото¬ 
кол, имя хоста и (необязательно) номер порта (можно передать полный ІШЬ-адрес, 
но все, кроме протокола, хоста и порта будет игнорироваться). Это предусмотрено 
из соображений безопасности: злонамеренный программный код или обычные 
пользователи могут открывать новые окна с документами, взаимодействие с ко¬ 
торыми вы не предполагали, поэтому розіМеззадеО не будет доставлять ваши со¬ 
общения, если окно будет содержать документ с происхождением, отличным от 
указанного. Если передаваемое сообщение не содержит конфиденциальной ин¬ 
формации и вы готовы передать ее сценарию из документа с любым происхожде¬ 
нием, то во втором аргументе можно передать строку которая будет играть 
роль шаблонного символа. Если необходимо указать, что документ должен иметь 
то же происхождение, что и документ в текущем окне, можно передать строку У ”. 

Если происхождение документа совпадет с указанным в аргументе, вызов метода 
розіМеззадеО приведет к возбуждению события «тезза^е» в целевом объекте Міп- 
до ѵі. Сценарий в этом окне может определить обработчик для обработки событий 
«шезза^е», которому будет передан объект события со следующими свойствами: 

сіаііа 

Копия сообщения, переданного методу роз1:Меззаде( ) в первом аргументе. 

зоигсе 

Объект Іл/іпсісм, из которого было отправлено сообщение, 
огідіп 

Строка, определяющая происхождение (в виде ШИ,) документа, отправивше¬ 
го сообщение. 

Большинство обработчиков оптеззаде() должно сначала проверить свойство 
огідіп своего аргумента и должно игнорировать сообщения из неподдерживаемых 
доменов. 

Обмен сообщениями с документами из сторонних доменов посредством метода 
розіМеззадеО и обработки события «шезза^е» может пригодиться, например, ко¬ 
гда необходимо подключить к веб-странице модуль, или «гаджет», с другого сай¬ 
та. Если модуль достаточно прост и автономен, его можно просто загрузить в эле¬ 
мент <іігате>. Однако представьте, что это более сложный модуль, который опре- 
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деляет свой прикладной интерфейс, и ваша веб-страница должна управлять этим 
модулем или как-то иначе взаимодействовать с ним. Если модуль определен в ви¬ 
де элемента <зсгір1:>, он сможет предложить полноценный прикладной интерфейс 
на языке Лѵабсгірі, но, с другой стороны, включение его в страницу даст ему 
полный контроль над страницей и ее содержимым. Такой подход широко исполь¬ 
зуется в современной Всемирной паутине (особенно в веб-рекламе), но в действи¬ 
тельности это не самое лучшее решение, даже если вы доверяете другому сайту. 

Альтернативой является обмен сообщениями между документами с разным про¬ 
исхождением: автор модуля может упаковать его в НТМЬ-файл, который прини¬ 
мает события «тезза&е» и передает их для обработки соответствующим функциям 
на языке ^ѵаЗсгірі. В этом случае веб-страница, подключившая модуль, сможет 
взаимодействовать с ним, отправляя сообщения с помощью метода розГМеззадеО. 
Этот прием демонстрируется в примерах 22.4 и 22.5. В примере 22.4 приводится 
реализация простого модуля, подключаемого с помощью элемента <іГгате>, кото¬ 
рый выполняет поиск на сайте ТѴіііег и отображает сообщения, соответствующие 
указанной фразе. Чтобы выполнить поиск с помощью этого модуля, подключив¬ 
шая его страница должна просто отправить ему сообщение с требуемой фразой. 

Пример 22.4. Модуль поиска на сайте Тюіііег с помощью метода ровіМез8аёе( ) 

<! ИОСТУРЕ Шт1> 

<! — 

Это модуль поиска на сайте ТміІіГег. Модуль можно подключить к любой странице внутри 
элемента <іГгате> и запросить его выполнить поиск, отправив ему строку запроса 
с помощью метода розГМеззадеС). Поскольку модуль подключается в элементе <іГгате>, 
а не <зсгір1:>, он не сможет получить доступ к содержимому вмещающего документа. 

<М:т1> 

<ИеасІ> 

<5І:у1е>Ьос)у { Гопі:: 9рГ запз-зегіГ; }</з1:у1е> 

<!-- Подключить библиотеку іОііегу ради ее утилиты іОцегу. деГЭЗСЩ) --> 

<зс гірі: згс="М:1:р: //сосіе . іцііегу.сот/ідііегу-1.4.4.тіп.із"/х/зсгір1:> 

<зсгірі:> 

// Можно было бы просто использовать свойство міпсіом.оптеззаде, 

// но некоторые старые броузеры (такие как РігеГох 3) не поддерживают его, 

// поэтому обработчик устанавливается таким способом. 
іГ (ѵѵіпс!о\л/. асІсІЕѵепІ:Изііепег) 

ѵѵіпсіоѵѵ.асІсІЕѵепІ:Ьізііепег("теззаде", НапсіІеМеззаде, Гаізе); 

еізе 

ѵѵіпсіоѵѵ. аІіІіасІтЕѵепІ:( 'оптеззаде", ПапсІІеМеззаде); // Для ІЕ8 
ГііпсГіоп ПапсІ1еМе55аде(е) { 

// Нас не волнует происхождение документа, отправившего сообщение: 

// мы готовы выполнить поиск на сайте Тѵѵіііііе г для любой страницы. 

// Однако сообщение должно поступить от окна, вмещающего этот модуль. 

ІГ (е.зоьгсе !== ѵѵіпсЗоѵѵ. рагепі) геГьгп; 

ѵаг зеагсПГегт = е.РаГа; // Это фраза, которую требуется отыскать 

// С помощью утилит поддержки А]ах из библиотеки ]0ьегу и прикладного 

// интерфейса ТміГГег отыскать сообщения, соответствующие фразе. 

]0ііегу. деГЭ30Н("ІтІ:1:р://5еагсП. ГміГГег. сот/зеагсЬ. ізоп?са11Ьаск=?", 

{ ц: зеагсПГегт }, 

ГипсІііоп(сІаГа) { // Вызывается с результатами запроса 




22.3. Взаимодействие документов с разным происхождением 


719 


ѵаг ТмееТз = сіаііа. гевиіііз ; 

// Создать НТМЬ-документ для отображения результатов 
ѵаг езсаресі = зеагсМіегт. гер1асе("<", "Ш;"); 
ѵаг ИТтІ = "<Ь2>" + езсаресі + "</Ь2>"; 

ІТ (ТѵѵееТз. ІепдТІі == 0) { 

Шті += "N 0 ТѵѵееТз І'оііпсГ; 


} 

еізе { 

Міті += // <сі1> НзТ оі 1 гезіЛІіз 

^ог(ѵаг і = 0; і < ТмееТз. ІепдТІі; і++) { 
ѵаг ТмееТ = ТмееТз[і]; 
ѵаг ТехТ = ТиееТ.ТехТ; 
ѵаг Ітот = ТмееТ. 1тот_іізег; 
ѵаг Туу/ееііьгі = "ІіТТр:/ЛміТТег.сот/#!/" + 
Ітот + "/з*аЩз/" + ТиееТ. і(1_зТг; 

ИТтІ += "<(Ц><а ТагдеТ='_Ыапк‘ ИгеТ=’" + 
*ѵ*/ее*ііг1 + + ТмееТ. ^гот_іізег + 

”</а></(1Т><сІ(1>" + ТмееТ.ТехІ: + "</с!сІ>"; 


Шті += "</сИ>"; 

} 

// Вставить документ в <іТгате> 
сІосіітепТ. Ьобу. іппегНТМІ. = Міті; 

}); 

} 

$(^ипсѣіоп() { 

// Сообщить вмещающему документу, что модуль готов к поиску. Вмещающий документ 
// не может отправлять модулю сообщения до получения этого сообщения, потому что 
// модуль еще не готов принимать сообщения. Вмещающий документ может просто 
// дождаться события опіоасі, чтобы определить момент, кода будут загружены 
// все фреймы. Но мы предусматриваем отправку этого сообщения, чтобы известить 
// вмещающий документ, что можно начать выполнять поиск еще до получения 
// события опіоасі. Модулю неизвестно происхождение вмещающего документа, 

// поэтому мы используем *, чтобы броузер доставил сообщение любому документу. 
ѵѵіпсіо\л/. рагепі. роз1Меззаде("Тміиег ЗеагсН ѵО.1", 

}); 

</зсгір*> 

</Иеас1> 

<ЬосІу> 

</ЬосІу> 

</Шт1> 


В примере 22.5 представлен простой сценарий на языке ^ѵаЗсгірі, который мо¬ 
жет быть вставлен в любую веб-страницу, где требуется использовать модуль по¬ 
иска по сайту ТѴіііег. Он вставляет модуль в документ и затем устанавливает об¬ 
работчики событий во все ссылки в документе, чтобы при наведении указателя 
мыши на ссылку производился вызов метода роз1:Меззаде() модуля, заставляю¬ 
щий его выполнить поиск по строке ШИ, ссылки. Это позволит узнать, что гово¬ 
рят люди о веб-сайте перед тем, как перейти к нему. 


Пример 22.5. Использование модуля поиска по сайту ТъѵШег с помощью 

метода ро8іМе88а&е( ) 

II Этот сценарий ЭЗ вставляет Тмііііег ЗеагсЬ бабдеі: в документ и добавляет обработчик 
// событий ко всем ссылкам в документе, чтобы при наведении указателя мыши на них 
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// с помощью модуля поиска отыскать упоминания ІІРЬ-адресов в ссылках. 

// Это позволяет узнать, что говорят другие о сайтах, прежде чем щелкнуть на ссылке. 
\л/іпсіоѵл/. ас)сІЕѵеп1:Ііз1:епе г( "ІоасІ” , ГііпсГіопО { // Не работает в ІЕ < 9 

ѵаг огідіп = "М:1:р: //сіаѵісі^іападап. сот” ; // Происхождение модуля 

ѵаг дасЗдеІ: = '/сІетоз/Тѵѵі1:1:е гЗеа гсГі. ГіТтІ"; // Путь к модулю 

ѵаг іГгате = йосьтепГ. с геаГеЕ1етеп1:(" ІГгате"); // Создать іГгате 

іГгате. зге = огідіп + дасідеі; // Установить его ІІПІ_ 

іТгате.ѵѵісІІіП = ”250"; // Ширина 250 пикселов 

іігате.НеідМ: = ”100%"; // Во всю высоту документа 

іГгате. зГуІе. сззПоаГ = " гідМ:"; // Разместить справа 


// Вставить фрейм в начало документа 

сіосіітепі:. Ьосіу. іпзег1:ВеГоге(іГгате, босьтепТ. Ьосіу. ГігзГСЬіІсІ); 


// Отыскать все ссылки и связать их с модулем 
ѵаг Ііпкз = сІоситепГ.деГЕІетепІізВуТадМатеС'а"); 

Тог(ѵаг і = 0; і < Ііпкз.ІепдГЬ; і++) { 

// асІсІЕѵепІ:Ьізііепег не работает в версии ІЕ8 и ниже 
1іпкз[і].асІсІЕѵепІ:Ьізііепег("тоизеоѵег", ГьпсІііопО { 

// Отправить іігі как искомую фразу и доставлять его, только если 
// фрейм все еще отображает документ с сайта ЬаѵісІГІападап. сот 
іГгате.сопГепГІл/іпсІом.розГМеззадеСГЬіз.ЬгеГ, огідіп); 

}, Гаізе); 

} 

}, Гаізе); 


22.4. Фоновые потоки выполнения 

Одна из основных особенностей клиентских сценариев на языке ^ѵаЗсгірі за¬ 
ключается в том, что они выполняются в единственном потоке выполнения: бро¬ 
узер, к примеру, никогда не будет выполнять два обработчика событий одновре¬ 
менно, и таймер никогда не сработает, пока выполняется обработчик события. 
Параллельные обновления переменных приложения или документа просто не¬ 
возможны, и программистам, разрабатывающим клиентские сценарии, не требу¬ 
ется задумываться или хотя бы понимать особенности параллельного програм¬ 
мирования. Как следствие, функции в клиентских сценариях на языке ^ѵаЗсгірі 
должны выполняться очень быстро, иначе они остановят работу цикла событий 
и веб-броузер перестанет откликаться на действия пользователя. Именно по этой 
причине прикладной интерфейс поддержки А^ах всегда действует асинхронно, 
и по этой же причине в клиентском ^ѵаЗсгірі отсутствуют синхронные версии 
функций 1оасі( ) или гедиіге( ) для загрузки библиотек на языке ^ѵаЗсгірі. 

Спецификация «АѴеЬ АѴогкегз» 1 со всеми мерами предосторожности ослабляет ог¬ 
раничение на единственный поток выполнения в клиентском ^ѵаЗсгірі. «Фоно¬ 
вые потоки», определяемые спецификацией, фактически являются параллель¬ 
ными потоками выполнения. Однако эти потоки выполняются в изолированной 
среде, не имеют доступа к объектам іл/іпсісм и ЭоситеШ: и могут взаимодействовать 


1 Спецификация «\ѴеЪ ДѴогкегз» изначально была частью спецификации НТМЬб, но за¬ 
тем была выделена в отдельный, независимый, хотя и тесно связанный со стандартом, 
документ. На момент написания этих строк проект спецификации был доступен по ад¬ 
ресам Мір://(іеѵ.іѵ3.ог8/Ніт15/и)огкег8/ и кіір://іѵкаііѵё.огё/іѵіѵ. 
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с основным потоком выполнения только посредством передачи асинхронных со¬ 
общений. Это означает, что параллельные изменения дерева БОМ по-прежнему 
невозможны, но это также означает, что теперь имеется возможность использо¬ 
вать синхронные прикладные интерфейсы и писать функции, выполняющиеся 
длительное время, которые не будут останавливать работу цикла событий и под¬ 
вешивать броузер. Создание нового фонового потока выполнения не является та¬ 
кой тяжеловесной операцией, как открытие нового окна броузера, но также не 
является легковесной операцией, вследствие чего нет смысла создавать новые фо¬ 
новые потоки для выполнения тривиальных операций. В сложных веб-приложе¬ 
ниях может оказаться полезным применение даже нескольких десятков фоно¬ 
вых потоков, но весьма маловероятно, что приложения с сотнями и тысячами 
таких потоков смогут иметь практическую ценность. 

Как и любой прикладной интерфейс поддержки многопоточных приложений, 
спецификация «АѴеЬ АѴогкегз» определяет две различные части. Первая - объект 
ІА/огкег, который представляет фоновый поток выполнения в программе, создав¬ 
шей его. Вторая - объект МогкегСІоЬаІЗсоре, глобальный объект нового фонового 
потока выполнения, который представляет фоновый поток выполнения внутри 
него самого. Оба объекта описываются в следующих подразделах. За ними следу¬ 
ет раздел с примерами. 

22.4.1. Объект ѴѴогкег 

Чтобы создать новый фоновый поток, достаточно просто вызвать конструктор 
Могкег(), передав ему ШІЬ-адрес, определяющий программный код на языке За.- 
ѵаЗсгірі, который должен выполняться в фоновом потоке: 

ѵаг Іоасіег = пем \л/огкег(" иі:ііз/іоасіе г. із" ); 

Если указать относительный ШІЬ-адрес, он будет интерпретироваться относи¬ 
тельно ШИгадреса документа, содержащего сценарий, который вызвал конст¬ 
руктор \А/огкег(). Если указать абсолютный ШІЬ-адрес, он должен иметь то же про¬ 
исхождение (протокол, имя хоста и порт), что и вмещающий документ. 

После создания объекта ІА/огкег ему можно отправлять данные с помощью его ме¬ 
тода розііМеззадеО. Значение, переданное методу розіМеззадеО, будет скопировано 
(смотрите врезку «Структурированные копии» выше), и полученная копия будет 
передана фоновому потоку вместе с событием «теззаде»: 

Іоасіег. роз^МеззадеС'Ше. Ііхі: "); 

Обратите внимание, что, в отличие от метода розііМеззадеО объекта Міпсіом, метод 
розііМеззадеО объекта ІА/огкег не имеет аргумента, в котором передавалась бы стро¬ 
ка, описывающая происхождение (раздел 22.3). Кроме того, метод розііМеззадеО 
объекта ІА/огкег корректно копирует сообщение во всех текущих броузерах, в отли¬ 
чие от ІА/іпсІоѵл/.розііМеззадеО, который в некоторых основных броузерах способен 
принимать только строковые сообщения. 

Принимать сообщения от фонового потока можно с помощью обработчика собы¬ 
тия «теззаде» объекта ІА/огкег: 

шгкег.оптеззаде = ^ітсНоп(е) { 

ѵаг теззаде = е.сіаііа; // Извлечь сообщение 

сопзоіе.Іод ("Содержимое: " + теззаде); // Выполнить некоторые действия 

} 
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Если фоновый поток возбудит исключение и не обработает его, это исключение 
продолжит распространение в виде события, которое также можно перехватить: 

ѵюгкег. опеггог = Гипсіііоп(е) { 

// Вывести текст ошибки, включая имя файла фонового потока и номер строки 
сопзоіе. 1од("Ошибка в " + е.Шепате + + е.ііпепо + ": " + е.теззаде); 

} 

Подобно всем объектам, в которых могут возбуждаться события, объект Могкег 
определяет стандартные методы ас!с1Еѵеп1:1.із1:епег() и гетоѵеЕѵеп1:1.із1:епег(), кото¬ 
рые можно использовать вместо свойств оптезз ад ей опеггог, если необходимо уста¬ 
новить несколько обработчиков событий. 

Объект Могкег имеет еще один метод, *егтіпа*е(), который останавливает выпол¬ 
нение фонового потока. 

22.4.2. Область видимости фонового потока 

При создании нового фонового потока с помощью конструктора МогкегО вы задае¬ 
те ІЖЬ-адрес файла с программным кодом на языке ^ѵаЗсгірі. Этот программ¬ 
ный код выполняется в новой, нетронутой среде выполнения ^ѵаЗсгірі, полно¬ 
стью изолированной от сценария, запустившего фоновый поток. Глобальным объ¬ 
ектом этой изолированной среды выполнения является объект МогкегСІоЬаІЗсоре. 
Объект МогкегСІоЬаІЗсоре - это чуть больше, чем просто глобальный объект ^ѵа- 
Зсгірі, но меньше, чем полноценный клиентский объект Міпсісм. 

Объект МогкегСІоЬаІЗсоре имеет метод розІіМеззадеО и свойство обработчика собы¬ 
тия оптеззаде, подобные своим аналогам в объекте Могкег, но действующие в обрат¬ 
ном направлении. Вызов метода розІіМеззадеО внутри фонового потока сгенериру¬ 
ет событие «тезза&е» за его пределами, а сообщения, отправляемые извне, будут 
превращаться в события и передаваться обработчику оптеззаде. Обратите внима¬ 
ние: благодаря тому, что объект МогкегСІоЬаІЗсоре является глобальным объектом 
для фонового потока, метод розІіМеззадеО и свойство оптеззаде воспринимаются 
программным кодом, выполняющимся в фоновом потоке, как глобальная функ¬ 
ция и глобальная переменная. 

Функция с1озе() позволяет фоновому потоку завершить свою работу, и по своему 
действию она напоминает метод *егтіпа*е() объекта Могкег. Отметьте, однако, что 
в объекте Могкег нет метода, который позволил бы определить, прекратил ли ра¬ 
боту фоновый поток, как и нет свойства обработчика события опсіозе. Если попы¬ 
таться с помощью метода розІіМеззадеО передать сообщение фоновому потоку, ко¬ 
торый прекратил работу, это сообщение будет просто проигнорировано без возбу¬ 
ждения исключения. В общем случае, если фоновый поток может завершить ра¬ 
боту самостоятельно вызовом метода с1озе(), неплохо было бы предусмотреть 
отправку сообщения, извещающего о прекращении работы. 

Наибольший интерес представляет глобальная функция ітрогІіЗсгірІізО» опреде¬ 
ляемая объектом МогкегСІоЬаІЗсоре: фоновые потоки выполнения могут использо¬ 
вать ее для загрузки любых необходимых им библиотек. Например: 

// Перед началом работы загрузить необходимые классы и утилиты 
ітрогІЗсгірі5("со11есІіоп5/Зе1:. ^з", "соПесИопз/Мароз", "и1:і1з/Ьазе64. ^з"); 

Функция ітрог1:Зсгір1:з() принимает один или более аргументов с ГГКЬ-адресами, 
каждый из которых должен ссылаться на файл с программным кодом на языке 
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^ѵаЗсгірі. Относительные ШІЬ-адреса интерпретируются относительно ІШЬ-ад- 
реса, переданного конструктору Могкег(). Она загружает и выполняет указанные 
файлы один за другим в том порядке, в каком они были указаны. Если при загруз¬ 
ке или при выполнении сценария возникнет какая-либо ошибка, ни один из по¬ 
следующих сценариев не будет загружаться или выполняться. Сценарий, загру¬ 
женный функцией ітрог1:Зсгір1:з(), сам может вызвать функцию ігпрог*Зсгір*з(), 
чтобы загрузить необходимые ему файлы. Отметьте, однако, что функция ітрогі:- 
Зсгір1:з() не запоминает, какие сценарии были загружены и не предусматривает 
защиту от циклических ссылок. 

Функция ітрог1:Зсгір1:з( ) выполняется синхронно: она не вернет управление, пока 
не будут загружены и выполнены все сценарии. Сценарии, указанные в вызове 
функции ітрогі:Зсгірі:з( ), можно использовать сразу, как только она вернет управ¬ 
ление: нет никакой необходимости определять функцию обратного вызова или 
обработчик события. После того как вы свыклись с асинхронной природой кли¬ 
ентского ^ѵаЗсгірі, такой возврат к простой, синхронной модели может пока¬ 
заться странным. Но в этом и заключается достоинство потоков выполнения: 
в фоновом потоке можно использовать блокирующие функции, не блокируя цикл 
событий в основном потоке выполнения и не блокируя вычисления, выполняе¬ 
мые параллельно в других фоновых потоках. 

Поскольку для фоновых потоков выполнения МогкегСІоЬаІЗсоре является глобаль¬ 
ным объектом, он обладает всеми свойствами базового глобального объекта ^ѵа- 
Зсгірі, такими как объект функция ізМаМ() и конструктор 0а1:е(). (Полный 
список можно найти в справочной статье СІоЬаІ, в третьей части книги.) Однако, 
кроме того, объект МогкегСІоЬаІЗсоре имеет следующие свойства клиентского объ¬ 
екта Міп Ром: 

• зеІ'Г - ссылка на сам глобальный объект. Отметьте, однако, что в объекте Мог- 
кегСІоЬаІЗсоре отсутствует синонимичное свойство міпРом, имеющееся в объек¬ 
те Міпсіом. 


Модель выполнения фонового потока 

Фоновые потоки выполняют свой программный код (и все импортирован¬ 
ные сценарии) синхронно, от начала до конца, и затем переходят в асинхрон¬ 
ную фазу выполнения, когда они откликаются на события и таймеры. Если 
фоновый поток регистрирует обработчик события оптеззаде, он никогда не 
завершит работу, пока есть вероятность поступления событий «тезза&е». 
Но если фоновый поток не принимает сообщения, он будет работать, пока не 
будут выполнены все задания (такие как загрузка или таймеры) и не будут 
вызваны все функции, связанные с этими заданиями. После вызова всех за¬ 
регистрированных функций обратного вызова в фоновом потоке нет ника¬ 
кой возможности начать выполнять новые задания, поэтому он может смело 
завершить свою работу. Представьте себе фоновый поток без обработчика со¬ 
бытий оптеззаде, который загружает файл с помощью объекта ХМШІіІірПедиезІ:. 
Если обработчик опіоасі запустит загрузку другого файла или зарегистриру¬ 
ет обработчик таймера вызовом функции зеНітеои*( ), поток выполнения по¬ 
лучит новое задание и продолжит работу. Иначе он завершится. 
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• Методы работы с таймерами зеШ.теои*(), сІеагТітеоііШ, зеІІпІегѵаІО и сіеаг- 
ІпіегѵаІО. 

• Свойство Іосаііоп, содержащее ШІЬ-адрес, переданный конструктору Могкег( 
Это свойство ссылается на объект І_оса1ііоп, как и аналогичное ему свойство 
Іосаіііоп объекта Міпсісм. Объект Іосаіііоп имеет свойства Гіге'Г, ргоііосоі, Мозі, Мозі- 
пате, рогі, раі^пате, зеагсМ и Мазй. В фоновом потоке эти свойства доступны толь¬ 
ко для чтения. 

• Свойство паѵідаіо г, ссылающееся на объект, обладающий теми же свойствами, 
что и объект №ѵіда1іог окна. Объект паѵідаіог фонового потока имеет свойства 
аррМате, аррѴегзіоп, рІаІі'Рогт, изегАдепіі и опІ_іпе. 

• Обычные методы объектов, в которых могут возбуждаться события: асісІЕѵепІі- 
І_із1іепег() и гетоѵеЕѵеп1іІ_і5Ііепег(). 

• Свойство опеггог, которому можно присвоить функцию обработки ошибок, по¬ 
добное свойству Міпсісм. опеггог, которое описывается в разделе 14.6. Обработчик 
ошибок, если его зарегистрировать, будет получать три аргумента с сообщени¬ 
ем об ошибке, ШІЬ-адресом и номером строки. Он может вернуть Гаізе, чтобы 
показать, что ошибка обработана и не должна распространяться дальше в виде 
события «еггог» в объекте Могкег. (Однако на момент написания этих строк обра¬ 
ботка ошибок в разных броузерах была реализована несовместимым способом.) 


Дополнительные особенности объекта ѴѴогкег 

Фоновые потоки выполнения, описываемые в этом разделе, являются выде¬ 
ленными фоновыми потоками : они связаны (или выделены из) с общим ро¬ 
дительским потоком выполнения. Спецификация <ЛѴеЪ ЛѴогкегз» опреде¬ 
ляет еще один тип фоновых потоков выполнения, разделяемые потоки вы¬ 
полнения. На момент написания этих строк броузеры еще не поддерживали 
разделяемые потоки выполнения. Однако их назначение состоит в том, что¬ 
бы играть роль именованного ресурса, который может предоставлять вы¬ 
числительные услуги любым другим потокам выполнения. На практике 
взаимодействие с разделяемым потоком выполнения напоминает взаимо¬ 
действие с сервером посредством сетевых сокетов. 

Роль «сокета» для разделяемого потока выполнения играет объект Мезза- 
деРогі. Он определяет прикладной интерфейс обмена сообщениями, подоб¬ 
ный аналогичному интерфейсу в выделенных потоках выполнения, а так¬ 
же используемому для обмена сообщениями между документами с разным 
происхождением. Объект МеззадеРогі имеет метод розіМеззадеО и атрибут 
оптеззаде обработчика событий. Спецификация НТМЬб предусматривает 
возможность создания связанных пар объектов МеззадеРогі с помощью кон¬ 
структора МеззадеСІіаппе1(). Вы можете передавать объекты МеззадеРогі 
(в специальном аргументе метода розіМеззадеО) другим окнам или другим 
фоновым потокам выполнения и использовать их как выделенные каналы 
связи. Объекты МеззадеРогі и МеззадеСМаппеІ являются дополнительным при¬ 
кладным интерфейсом, который поддерживается лишь немногими броузе¬ 
рами и здесь не рассматривается. 
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Наконец, объект МогкегСІоЬаІЗсоре включает конструкторы объектов, важных для 
клиентских сценариев. В их числе конструктор ХМІ_Н1:1:рВедие8І:(), позволяющий 
фоновым потокам выполнять НТТР-запросы (глава 18), и конструктор Іл/огкег(), 
дающий возможность фоновым потокам создавать свои фоновые потоки. (Однако 
на момент написания этих строк конструктор Могкег() был недоступен фоновым 
потокам в броузерах СЬготе и 8а1агі.) 

Некоторые прикладные интерфейсы НТМЬб, описываемые далее в этой главе, оп¬ 
ределяют особенности, доступные как через обычный объект іл/іпсісм, так и через 
объект МогкегСІоЬаІЗсоре. Часто асинхронному прикладному интерфейсу объекта 
іл/іпсіом соответствует его синхронная версия в объекте МогкегСІоЬаІЗсоре. Эти при¬ 
кладные интерфейсы «с поддержкой фоновых потоков выполнения» мы рассмот¬ 
рим далее в этой главе. 

22.4.3. Примеры использования фоновых потоков 

Завершают этот раздел два примера использования фоновых потоков выполне¬ 
ния. Первый демонстрирует, как реализовать выполнение длительных вычисле¬ 
ний в фоновом потоке, чтобы они не влияли на отзывчивость пользовательского 
интерфейса, обслуживаемого основным потоком выполнения. Второй демонстри¬ 
рует, как можно использовать фоновые потоки для работы с простейшими син¬ 
хронными прикладными интерфейсами. 

В примере 22.6 определяется функция зтеаг(), которая принимает элемент <ітд> 
в виде аргумента. Она применяет эффект размытия для «смазывания» изображе¬ 
ния вправо. Для реализации этого эффекта используется описанный в главе 21 
прием копирования изображения в неотображаемый элемент <сапѵаз> и после¬ 
дующего извлечения пикселей изображения с помощью объекта ІтадеОаІіа. Эле¬ 
менты <ітд> и <сапѵаз> нельзя передать фоновому потоку выполнения с помощью 
метода розІіМеззадеО, но можно передать объект ІтадеОаІіа (подробности во врезке 
«Структурированные копии» выше). Пример 22.6 создает объект Могкег и вызыва¬ 
ет его метод роз1:Меззаде(), чтобы передать ему изображение. Когда фоновый поток 
отправит обработанные пикселы изображения обратно, программный код скопи¬ 
рует их снова в элемент <сапѵаз>, извлекая их как ресурс с ШІЬ-адресом вида 
сіаііа :// и устанавливая этот ІШЬ-адрес в качестве значения свойства зге ориги¬ 
нального элемента <ітд>. 

Пример 22.6. Создание фонового потока выполнения для обработки изображения 

// Асинхронная замена изображения его смазанной версией. 

// Используется так: <ітд з гс="1:ез1:ітаде .зрд” опс1іск="зтеаг(і:Ііі5)'7> 

Іипсііоп зтеаг(ітд) { 

// Создать неотображаемый элемент <сапѵаз> того же размера, что и изображение 
ѵаг сапѵаз = сіоситепі:. с геа1:еЕ1етеп1:( "сапѵаз"); 
сапѵаз. міеііііі = ітд.ѵѵісііііі; 
сапѵаз. ЬеідМ: = ітд. ИеідМ:; 

// Скопировать изображение в холст и извлечь его пикселы 
ѵаг сопіехі: = сапѵаз.де1:Соп1:ех1:("26"); 
сопіехі.сігаѵѵІтаде(ітд, 0, 0); 

ѵаг ріхеіз = сопіехі. де1:Ітаде0а1:а(0,0, ітд.ѵѵісІІіЬ, ітд. ЬеідИІ:) 

// Отправить пикселы фоновому потоку выполнения 

ѵаг ѵѵогкег = пеѵѵ Ѵ\1огкег("8теагѴ\1огкег. ^з"); // Создать фоновый поток 
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мэгкег. роз1:Ме55аде( ріхеіз); // Скопировать и отдать пикселы 

// Зарегистрировать обработчик для получения ответа от фонового потока 
мэгкег.оптеззаде = ^цпсЫоп(е) { 

ѵаг зтеагесІ_ріхеІ5 = е.баТа; // Пикселы, полученные от потока 

сопіехі:. рціІтаде0а1:а(5теагесІ_ріхеІ5, 0, 0); // Скопировать в холст 
ітд.згс = сапѵаз. ТоОаТаШЦ ); // А затем в изображение 

мэгкег. ТегтіпаТе(); // Остановить поток 

сапѵаз. ѵѵісііііі = сапѵаз. НеідІтЬ = 0; // Освободить память 

} 

} 

В примере 22.7 приводится программный код реализации фонового потока, ис¬ 
пользуемого в примере 22.6. Основу этого примера составляет функция обработки 
изображения: модифицированная версия примера 21.10. Обратите внимание, что 
этот пример настраивает свою инфраструктуру обмена сообщениями единствен¬ 
ной строчкой программного кода: обработчик события оптеззаде просто наклады¬ 
вает эффект смазывания на изображение и сразу же отправляет его обратно. 

Пример 22.7. Обработка изображения в фоновом потоке выполнения 

// Получает объект ІтадеОаіа от основного потока выполнения, обрабатывает его 
// и отправляет обратно 

оптеззаде = Гцпсіііоп(е) { роз1:Меззаде(зтеаг(е.сІа1:а)); } 

// Смазывает пикселы в ІтадеОаіа вправо, воспроизводя эффект быстрого движения. 

// При обработке больших изображений этой функции приходится выполнять огромный объем 
// вычислений, что может вызвать эффект подвисания пользовательского интерфейса, 

// если использовать ее в основном потоке выполнения. 

Гцпсііоп зтеаг(ріхеіз) { 

ѵаг сіаіа = ріхеіз. сіаіа, місИП = ріхеіз. ѵѵісіііГі, ІіеідІгЬ = ріхеіз. ИеідШ; 
ѵаг п = 10, т = п-1; // Нем больше п, тем сильнее эффект смазывания 
Гог(ѵаг гом = 0; том < ІтеідГіІ:; гоѵѵ++) { // Для каждой строки 

ѵаг і = гоѵ/*ѵ/і(ЦІі*4 + 4; // Индекс 2-го пиксела 

Гог(ѵаг соі = 1; соі < місИП; со1++, і += 4) { // Для каждого столбца 

ба1:а[і] = (да1:а[і] + ба1:а[і-4]*т)/п; // Красная составляющая 

ба1:а[і+1] = (ба1:а[і+1] + ба1:а[і-3]*т)/п; // Зеленая 

ба1:а[і+2] = (ба1:а[і+2] + сіа1:а[і-2]*т)/п; // Синяя 

ба1:а[і+3] = (сІаІаГі+3] + сіа1:а[і-1 ]*т)/п; // Альфа-составляющая 

} 

} 

геіигп ріхеіз; 

} 

Обратите внимание, что программный код в примере 22.7 может обрабатывать 
любое количество изображений, которые будут отправлены ему. Однако для про¬ 
стоты пример 22.6 создает новый объект Могкег для обработки каждого изображе¬ 
ния. Чтобы не плодить фоновые потоки, которые ничего не делают в ожидании 
новых сообщений, по завершении обработки изображения работа фонового пото¬ 
ка завершается вызовом метода іегтіпа1:е( ). 

Следующий пример демонстрирует, как с помощью фоновых потоков выполне¬ 
ния можно писать синхронный программный код и безопасно использовать его 
в клиентских сценариях на языке ^ѵаЗсгірі. В разделе 18.1.2.1 было показано, 
как с помощью объекта ХМЫНІіІірРІедиезІ: выполнять синхронные НТТР-запросы, 
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и говорилось, что такой способ его использования в основном потоке выполнения 
является не лучшим решением. Однако в фоновом потоке вполне оправданно вы¬ 
полнять синхронные запросы, и в примере 22.8 демонстрируется реализация фо¬ 
нового потока выполнения, которая выполняет именно такие запросы. Его обра¬ 
ботчик события оптеззаде принимает массив ШІЬ-адресов, использует синхрон¬ 
ный прикладной интерфейс объекта ХМЫНІіІірВедиезІ: для извлечения их содержи¬ 
мого и затем посылает полученное текстовое содержимое в виде массива строк 
обратно основному потоку выполнения. Или, если какой-либо НТТР-запрос по¬ 
терпит неудачу, возбуждает исключение, которое распространится до обработчи¬ 
ка опе г го г объекта Могкег. 


Отладка фоновых потоков выполнения 

Одним из прикладных интерфейсов, недоступных в объекте МогкегСІоЬаІ- 
Зсоре (по крайней мере, на момент написания этих строк), является при¬ 
кладной интерфейс доступа к консоли и одна из самых ценных его функ¬ 
ций - сопзоіе. 1од(). Фоновые потоки не могут выводить текст в консоль и во¬ 
обще не могут взаимодействовать с документом, поэтому их отладка может 
оказаться весьма трудным делом. Если фоновый поток возбудит исключе¬ 
ние, основной поток получит событие «еггог» в объекте Могкег. Но чаще бы¬ 
вает необходимо иметь в фоновом потоке хоть какой-нибудь способ выво¬ 
дить отладочные сообщения, которые будут видимы в веб-консоли броузе¬ 
ра. Один из самых простых способов добиться этого - изменить протокол 
передачи сообщений, используемый для взаимодействия с фоновым пото¬ 
ком, чтобы он мог посылать отладочные сообщения. Так, в примере 22.6 
можно было бы вставить следующий программный код в начало обработ¬ 
чика событий оптеззаде: 

іі 1 (Ііуреоі 1 е.сіаііа === "зігіпд") { 
сопзоіе. 1од( Могкѳг : " + е.сіаііа); 
геііи гп; 

} 

Благодаря этому дополнительному программному коду фоновый поток по¬ 
лучает возможность отображать отладочные сообщения, просто передавая 
строки методу роз1:Меззаде(). 


Пример 22.8. Выполнение синхронных НТТР-запросов в фоновом потоке 

// Этот файл будет загружен вызовом конструктора Ѵ\Іогкег(), поэтому он будет выполняться 
// в независимом потоке выполнения и может безопасно использовать синхронный прикладной 
// интерфейс объекта ХМШІіІірВедиезІ: . В качестве сообщения фоновому потоку должен 
// передаваться массив ЭРИ-адресов. Поток синхронно извлечет содержимое 
// из указанных адресов и вернет его в виде массива строк, 
оптеззаде = 1"ипс1ііоп(е) { 

ѵаг игіз = е.сіаііа; // Входные данные: ІШІ_-адреса извлекаемого содержимого 
ѵаг сопііепііз = []; // Выходные данные: содержимое указанных ІШІ_-адресов 

1"ог(ѵаг і = 0; і < игіз.Іепдіііі; і++) { 





728 


Глава 22. Прикладные интерфейсы НТМІ_5 


ѵаг игі = иг1з[ і]; // Для каждого ІЖ-адреса 

ѵаг хііг = пем ХМЫНІіІірВедиезІ:(); // Создать НТТР-запрос 

хІіг.ореп("СЕТ'', игі, І'аізе); // Гаізе обеспечит синхронное выполн. 
хЬг.зепсК); // Блокируется до выполнения запроса 

ІГ (хИг.зіаіиз !== 200) // Возбудить исключение при неудаче 

ТІі гом Еггог(хІпг. зТаТиз + " " + хііг.зІіаІіизТехІ: + ": + игі); 

сопТепТз. риз!і(хЬг. гезропзеТехТ); // Иначе сохранить содержимое 

} 

// Отослать массив содержимого Ж-адресов обратно основному потоку 
роз1:Меззаде( сопіетз); 

} 

22.5. Типизированные массивы и буферы 

Как говорилось в главе 7, массивы в языке ^ѵаЗсгірі являются многоцелевыми 
объектами с числовыми именами свойств и специальным свойством ІепдІО. Эле¬ 
ментами массива могут быть любые ^ѵаЗсгірІ-значения. Массивы могут увели¬ 
чиваться и уменьшаться в размерах и быть разреженными. Реализации ^ѵа- 
Зсгірі выполняют множество оптимизаций, благодаря которым типичные опера¬ 
ции с массивами в языке ^ѵабсгірі выполняются очень быстро. Типизированные 
массивы - это объекты, подобные массивам (раздел 7.11), которые имеют несколь¬ 
ко важных отличий от обычных массивов: 

• Все элементы типизированного массива являются числами. Конструктор, ис¬ 
пользуемый для создания массива, определяет тип (целые числа со знаком 
или без знака или вещественные числа) и размер (в битах) чисел. 

• Типизированные массивы имеют фиксированную длину. 

• Элементы типизированного массива всегда инициализируются значением О 
при его создании. 

Всего существует восемь разновидностей типизированных массивов, каждый 
с различным типом элементов. Создавать их можно с помощью следующих кон¬ 
структоров: 


Конструктор 

Числовой тип 

Іп1:8Аггау() 

байты со знаком 

ІЛп1:8Аггау() 

байты без знака 

ІпІІбАггауО 

16-битные короткие целые со знаком 

ІЛпІІбАггауО 

16-битные короткие целые без знака 

Іп1:32Аггау() 

32-битные целые со знаком 

ІЛп1:32Аггау() 

32-битные целые без знака 

Р1оа1:32Аггау() 

32-битные вещественные значения 

Р1оа1:64Аггау() 

64-битные вещественные значения 


При создании типизированного массива конструктору передается размер масси¬ 
ва. Вместо размера можно передать массив или типизированный массив, кото¬ 
рый будет использован для инициализации элементов нового массива. После соз¬ 
дания типизированного массива его элементы можно читать или изменять с по- 
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мощью обычной формы записи с квадратными скобками, как и при работе с лю¬ 
бым другим объектом, подобным массиву: 

ѵаг Ьуіез = пе\ѵ ІЛп1:8Аггау(1024); // Один килобайт байтов 

1"ог(ѵаг і = 0; і < Ьуіез. 1епд1:Іі; і++) // Для каждого элемента массива 
Ьу1:е5[і] = і & ОхРР; // Записать 8 младших бит индекса 

ѵаг сору = пеѵѵ ІЛп1:8Аггау(Ьу1:ез); // Создать копию массива 

ѵаг іпіз = пеѵѵ Іп1:32Аггау([0,1,2, 3]); // Типизированный массив с 4 целыми 

Современные реализации ^ѵаЗсгірі оптимизируют операции с массивами и де¬ 
лают их очень эффективными. Однако типизированные массивы могут быть еще 
более эффективными, как по времени выполнения операций с ними, так и по ис¬ 
пользованию памяти. Следующая функция вычисляет наибольшее простое чис¬ 
ло, которое меньше указанного значения. Она использует алгоритм «Решето Эра¬ 
тосфена», который основан на использовании большого массива, в котором запо¬ 
минается, какие числа являются простыми, а какие составными. Так как в каж¬ 
дом элементе массива требуется сохранять всего один бит информации, объект 
Іп1:8Аггау может оказаться более эффективным в использовании, чем обычный 
массив ^ѵабсгірі: 

// Возвращает наибольшее целое простое число меньше п. 

// Использует алгоритм "Решето Эратосфена" 

Рцпсііоп зіеѵе(п) { 

ѵаг а = пе\ѵ Іп1:8Аггау(п+1 ); // в а[х] записывается 1, если х - составное число 

ѵаг тах = Маіііт. Р1оог(Ма1:Іі. зцгі:(п)); // Множитель не может быть выше этого значения 
ѵаг р = 2; // 2 - первое простое число 

ѵ\4іі1е(р <= тах) { // Для простых чисел меньше тах 

1Ч)г(ѵаг і = 2*р; і <= п; і += р) // Пометить числа, кратные р, 
а[і] = 1; // как составные 

\ѵПі1е(а[++р]) /* пустое тело */; // Следующий непомеченный индекс - 
} // простое число 

ѵ\4іі1е(а[п]) п--; // Цикл в обр. напр., чтобы отыскать последнее простое 
геішгп п; // И вернуть его 

} 

Функция зіеѵе() будет работать, если вызов конструктора Іп1:8Аггау() заменить 
вызовом традиционного конструктора АггауО, но выполняться она будет в два- 
три раза дольше и будет расходовать гораздо больше памяти при больших значе¬ 
ниях параметра п. Типизированные массивы могут также пригодиться при обра¬ 
ботке графических изображений и для математических вычислений: 

ѵаг таігіх = пем Р1оа1:64Аггау(9); // Матрица 3x3 
ѵаг ЗсІРоіпІ: = пе\ѵ ІпІІбАггауО); // Точка в 3-мерном пространстве 
ѵаг гдЬа = пеѵѵ ЦіпІвАггау(4); // 4-байтовое значение ПСВА пиксела 

ѵаг зцсіоки = пеѵѵ ІЛп1:8Аггау(81); // Доска 9x9 для игры в судоку 

Форма записи с квадратными скобками, используемая в языке ^ѵаЗсгірі, позво¬ 
ляет читать и записывать значения отдельных элементов типизированного мас¬ 
сива. Но типизированные массивы определяют дополнительные методы для за¬ 
писи и чтения целого фрагмента массива. Метод зе1:( ) копирует элементы обычно¬ 
го или типизированного массива в типизированный массив: 

ѵаг Ьуіез = пем 1Яп1:8Аггау(1024) // Буфер размером 1Кбайт 

ѵаг раИегп = пем ІІіп1:8Аг гау([0,1,2,3]); // Массив из 4 байтов 

ЬуЬеэ. 8е*(ра1:1:егп); // Скопировать их в начало другого массива байтов 
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ЬуГез. зеТ(раТТегп, 4); // Скопировать их же в другое место массива 

ЬуГез. зеі:([0,1,2,3], 8); // Просто скопировать значения из обычного массива 

Типизированные массивы имеют также метод зиЬаггауО, возвращающий фраг¬ 
мент массива, относительно которого он был вызван: 

ѵаг іпГз = пеѵѵ ІпГ16Аггау([0,1,2,3,4,5,6,7,8,9]); // 10 коротких целых 

ѵаг ІазГЗ = іпГз. зцЬаггауЦпГз. ІепдГЬ-3, іпГз.ІепдГЬ); // Последние 3 из них 
1азГЗ[0] // => 7: то же самое, что и іпгз[7] 

Обратите внимание, что метод зцЬаггауО не создает копии данных. Он просто воз¬ 
вращает новое представление тех же самых значений: 

іпГз[9] = -1; // Изменить значение в оригинальном массиве и... 

1азГЗ[2] // => -1: изменения коснулись фрагмента массива 

Тот факт, что метод зиЬаггауО возвращает новое представление существующего 
массива, раскрывает важную особенность типизированных массивов: все они яв¬ 
ляются представлениями участка памяти, который называется АггауВиГГег. Каж¬ 
дый типизированный массив имеет три свойства, связывающие его с лежащим 
в его основе буфером: 

ІазГЗ. ЬьГГег // => вернет объект АггауВиГГег 

ІазГЗ. ЬиГГег == іпГз. ЬиГГег // => Ггце: оба - представления одного буфера 
ІазГЗ. ЬуГеОГГзеГ // => 14: это представление начинается с 14-го байта в буфере 
1аз1:3.ЬуГеЬепдГЬ // => 6: размер представления 6 байт (3 16-битных целых) 

Сам объект АггауВиГГег имеет только одно свойство, возвращающее его длину: 

ІазГЗ. ЬуГеЬепдГЬ // => 6: размер представления 6 байт 

ІазГЗ.ЬьГГег. ЬуГеЬепдГЬ // => 20: но буфер имеет размер 20 байт 


Типизированные массивы, элемент <сапѵа$> 

и базовый .ІаѵаБсгірІ: 

Типизированные массивы являются важной частью прикладного интер¬ 
фейса создания трехмерной графики АѴеЬСЬ в элементе <сапѵаз>, и в броузе¬ 
рах они реализованы как часть прикладного интерфейса АѴеЬСЬ. АѴеЬСЬ 
не рассматривается в этой книге, но типизированные массивы весьма по¬ 
лезны сами по себе, и поэтому обсуждаются здесь. В главе 21 говорилось, 
что прикладной интерфейс объекта Сапѵаз определяет метод деПтадеОаГаО, 
возвращающий объект ІтадеОаГа. Свойство сІаГа объекта ІтадеОаГа является 
массивом байтов. В спецификации НТМЬ он называется СапѵазРіхеІАггау, 
но, по сути, это то же самое, что описываемый здесь ІІіпГ8Аггау, за исключе¬ 
нием способа обработки значений, выходящих за диапазон 0-255. 

Имейте в виду, что эти типы не являются частью базового языка. Будущие 
версии языка ^ѵаЗсгірі, возможно, будут включать поддержку типизиро¬ 
ванных массивов, подобных этим, но на момент написания этих строк еще 
было неясно, примет ли язык прикладной интерфейс, описываемый здесь, 
или будет создан новый прикладной интерфейс. 
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Объект АггауВиІ'І'егз - это всего лишь последовательность байтов. К этим байтам 
можно обращаться с помощью типизированных массивов, но сам объект Аггау- 
ВиТТег не является типизированным массивом. Однако будьте внимательны: объ¬ 
ект АггауВиТТег можно индексировать числами, как любой другой объект ^ѵа- 
8сгірі, но это не обеспечивает доступ к байтам в буфере: 

ѵаг Ьуііез = пем ІЛп1і8Аггау(8); // Разместить 8 байтов 

Ьу1іез[0] = 1; // Записать в первый байт значение 1 

Ьуііез. Ьи^'Гег[0] // => ипсіе^іпесі : буфер не имеет индекса О 

Ьуііез. ЬиІ^^егС 1 ] = 255; // Попробовать некорректно записать значение в байт буфера 

Ьуііез. Ьиі^^е г[ 1 ] // => 255: это обычное ЗаѵаЗсгірІі-свойство 

Ьу1іез[1] // => 0: строка выше не изменила байт 

Имеется возможность создавать объекты АггауВиІ^ег непосредственно, вызовом 
конструктора АггауВиІ^егО, и на основе имеющегося объекта АггауВи1 = 1 = ег можно 
создать любое число представлений типизированного массива: 

ѵаг ЬііІ 1 = пем АггауВи1 = 1 = ег( 1024* 1024 ); // Один Мбайт 

ѵаг азЬуІез = пем ЬіпІівАг гау( ЬиІ 1 ); // Представление в виде байтов 

ѵаг азіпііз = пе\ѵ ІгѵЬ32Аггау(ЬиО; // В виде 32-битных целых со знаком 

ѵаг ІазіК = пе\ѵ ЬіпІівАг гау( Ьи^. 1023*1024); // Последний Кбайт в виде байтов 

ѵаг Іп1із2 = пем Іп1і32Аг гау( ЬиІ 1 . 1024, 256); // 2-й Кбайт в виде 256 целых чисел 

Типизированные массивы позволяют представлять одну и ту же последователь¬ 
ность байтов в виде целых чисел размером 8, 16, 32 или 64 бита. Это поднимает 
проблему «порядка следования байтов», т. е. порядка, в каком следуют байты при 
объединении в более длинные слова. Для эффективности типизированные масси¬ 
вы используют порядок следования байтов, определяемый аппаратным обеспече¬ 
нием. В системах с обратным порядком следования байтов байты числа распола¬ 
гаются в буфере АггауВи-Г^ег в порядке от младшего к старшему. На платформах 
с прямым порядком следования байтов байты располагаются в порядке от стар¬ 
шего к младшему. Определить порядок следования байтов на текущей платфор¬ 
ме, где выполняется сценарий, можно следующим образом: 

// Если целое число 0x00000001 располагается в памяти в виде 
// последовательности байтов 01 00 00 00, следовательно, сценарий выполняется 
// на платформе с обратным порядком следования байтов. На платформе с прямым 
// порядком следования байтов мы получим байты 00 00 00 01. 
ѵаг 1і1і1і1е_епсІіап = пем ІпІівАг гау( пеѵѵ Іп1і32Аггау([1]). Ьы1^ег)[0] === 1; 

В настоящее время наибольшее распространение получили процессорные архи¬ 
тектуры с обратным порядком следования байтов. Однако многие сетевые прото¬ 
колы и некоторые двоичные форматы файлов требуют, чтобы байты следовали 
в прямом порядке. В разделе 22.6 вы узнаете, как использовать объекты АггауВи'Г'Гег 
для хранения байтов, прочитанных из файлов или полученных из сети. В подоб¬ 
ных ситуациях нельзя просто полагаться на то, что порядок следования байтов, 
поддерживаемый аппаратной частью, совпадает с порядком следования байтов 
в данных. Вообще, при работе с внешними данными, для представления данных 
в виде массива отдельных байтов можно использовать Іп1:8Аггау и ІІіп1:8Аггау, но 
нельзя использовать другие виды типизированных массивов для представления 
данных в виде массивов многобайтовых слов. Вместо этого можно использовать 
класс ОаІіаѴіеѵѵ, который определяет методы чтения и записи значений из буфера 
АггауВиІ'І'ег, использующие явно указанный порядок следования байтов: 
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ѵаг сІаТа; // Предположим, что данные в АггауВиГГег получены из сети 

ѵаг ѵіе\ѵ = 0а1:аѴіе\ѵ(сІа1:а); // Создать представление буфера 

ѵаг іпт = ѵіе\ѵ.де1:Іпі:32(0); // 32-битное* целое со знаком с прямым порядком 

// следования байтов, начиная с 0-го байта 
іпт = ѵіеѵу/. деТІпі:32(4, ^аізе); // Следующее 32-битное целое, также с прямым 

// порядком следования байтов 

іпт = ѵіе\ѵ.деГІпі:32(8,Іігііе) // Следующие 4 байта как целое со знаком 

// и с обратным порядком следования байтов 
ѵіе\ѵ.зеТІпТ32(8,іпт,Гаізе); // Записать его обратно, в формате с прямым 

// порядком следования байтов 

Класс ЬаІіаѴіеѵѵ определяет восемь методов деГ для каждого из восьми видов типи¬ 
зированных массивов. Они имеют такие имена, как деГІпПбО, деГЬіпГ32() и деГ- 
Р1оа1:64(). В первом аргументе они принимают смещение значения в байтах в бу¬ 
фере АггауВиГГег. Все эти методы чтения, кроме деЫпЩ) и деГЫпЩ), принимают 
логическое значение во втором необязательном аргументе. Если второй аргумент 
отсутствует или имеет значение Гаізе, используется прямой порядок следования 
байтов. Если второй аргумент имеет значение Іігие, используется обратный поря¬ 
док следования байтов. 

Класс ОаГаѴіеѵѵ определяет восемь соответствующих методов зе!, которые записы¬ 
вают значения в буфер АггауВиГГег. В первом аргументе этим методам передается 
смещение начала значения. Во втором аргументе - записываемое значение. Все 
методы, кроме зеГІпГ8() и зеГ1Лп1:8(), принимают необязательный третий аргу¬ 
мент. Если аргумент отсутствует или имеет значение Гаізе, значение записывается 
в формате с прямым порядком следования байтов, когда первым следует старший 
байт. Если аргумент имеет значение Ггие, значение записывается в формате с об¬ 
ратным порядком следования байтов, когда первым записывается младший байт. 

22.6. Двоичные объекты 

Двоичный объект (ВІоЬ) - это нетипизированная ссылка, или дескриптор, блока 
данных. Название «ВІоЬ» пришло из мира баз данных 8()І<, где оно расшифровы¬ 
вается как «Віпагу Ьаг^е ОЬіесі» (большой двоичный объект). В языке ^ѵа8сгірі 
двоичные объекты часто представляют двоичные данные, и они могут иметь 
большой размер, но это совсем необязательно: двоичный объект ВІоЬ может также 
представлять содержимое небольшого текстового файла. Двоичные объекты не¬ 
прозрачны, т. е. являются своего рода черными ящиками: все, что можно с ними 
сделать, - это определить их размер в байтах, узнать МІМЕ-тип и разбить на бо¬ 
лее мелкие двоичные объекты: 

ѵаг ЫоЬ = ... // Как получить двоичный объект, будет показано ниже 

ЬІоЬ.зіге // Размер двоичного объекта в байтах 

ЬІоЬ.Ііуре // МІМЕ-тип двоичного объекта или если неизвестен 

ѵаг зиЬЫоЬ = ЫоЬ. з1ісе(0, 1024, "ГехГ/рІаіп"); // Первый килобайт - как текст 

ѵаг Іазі: = ЫоЬ. з1ісе(Ь1оЬ.зіге-1024, 1024); // Последний килобайт - 

// как нетипизированные данные 

Веб-броузеры могут сохранять двоичные объекты в памяти или на диске, и дво¬ 
ичные объекты могут представлять действительно огромные блоки данных (та¬ 
кие как видеофайлы), которые слишком велики, чтобы их можно было уместить 
в памяти, предварительно не разбив на более мелкие части с помощью метода 
з1ісе(). Поскольку двоичные объекты могут иметь огромный размер и для рабо- 
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ты с ними может потребоваться доступ к диску, прикладные интерфейсы для ра¬ 
боты с ними действуют асинхронно (имеются также синхронные версии для ис¬ 
пользования в фоновых потоках выполнения). 

Сами по себе двоичные объекты не представляют особого интереса, но они слу¬ 
жат важным механизмом обмена данными для некоторых прикладных интер¬ 
фейсов в языке ^ѵабсгірі, которые работают с двоичными данными. На рис. 22.2 
показано, как можно обмениваться двоичными объектами во Всемирной паути¬ 
не, читать и сохранять их в локальной файловой системе, в локальных базах дан¬ 
ных и даже обмениваться ими с другими окнами и фоновыми потоками выполне¬ 
ния. Он также показывает, как можно получить содержимое двоичного объекта 
в виде текста, типизированного массива или ТЖЬ-адреса. 

Прежде чем приступать к работе с двоичным объектом, его необходимо получить. 
Сделать это можно множеством способов, одни из которых связаны с использова¬ 
нием уже знакомых вам прикладных интерфейсов, а другие - с прикладными 
интерфейсами, которые описываются ниже в этой главе: 

• Двоичные объекты поддерживаются алгоритмом структурированного копи¬ 
рования (смотрите врезку «Структурированные копии» выше), а это означает, 
что их можно получить от другого окна или фонового потока выполнения вме¬ 
сте с событием «теееа^е» (разделы 22.3 и 22.4). 
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Рис, 22,2, Двоичные объекты и прикладные интерфейсы , использующие их 
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• Двоичные объекты можно извлекать из баз данных на стороне клиента, как 
описывается в разделе 22.8. 

• Двоичные объекты можно загрузить из сети по протоколу НТТР, используя 
ультрасовременные возможности, определяемые спецификацией ХНК2. Об 
этом рассказывается в разделе 22.6.2. 

• Можно также создать свой двоичный объект, сконструировав его с помощью 
объекта ВІоЬВиіІсІег из строки, объекта АггауВиГГег (раздел 22.5) или другого дво¬ 
ичного объекта. Объект ВІоЬВиіІсІег будет демонстрироваться в разделе 22.6.3. 

• Наконец, и, пожалуй, самое важное, - объект Рііе в клиентском ^ѵа8сгірі 
является подтипом типа ВІоЬ: объект Рііе - это просто двоичный объект с дан¬ 
ными, которые имеют имя и дату последнего изменения. Получить объект Рііе 
можно из элемента сіприГ іуре= Тііе ”> и от прикладного интерфейса буксиров¬ 
ки мышью (бга^-апб-бгор), как описывается в разделе 22.6.1. Объект Рііе 
можно также получить с помощью прикладного интерфейса доступа к файло¬ 
вой системе, который охватывается в разделе 22.7. 

Получив двоичный объект, над ним можно выполнить различные операции, 
многие из которых являются симметричными операциям, описанным выше: 

• Двоичный объект можно отправить другому окну или фоновому потоку вы¬ 
полнения с помощью метода розГМеззадеО (разделы 22.3 и 22.4). 

• Двоичный объект можно сохранить в базе данных на стороне клиента (раз¬ 
дел 22.8). 

• Двоичный объект можно выгрузить на сервер, передав его методу зепсІ() объ¬ 
екта ХМШГГрРедиезІ. Как это можно реализовать, демонстрирует пример 18.9 
выгрузки файла (напомню, что объект Рііе - это всего лишь специализирован¬ 
ная разновидность двоичного объекта ВІоЬ). 

• Можно воспользоваться функцией сгеаГеОуесГЬВЦ), чтобы получить специ¬ 
альный ШІЬ-адрес вида ЫоЬ://, ссылающийся на двоичное содержимое, и за¬ 
тем использовать его вместе с механизмами БОМ или С88. Этот прием демон¬ 
стрируется в разделе 22.6.4. 

• Можно воспользоваться объектом РіІеВеасІег, чтобы асинхронно (или синхрон¬ 
но, в фоновом потоке выполнения) извлечь содержимое двоичного объекта 
в строку или в объект АггауВиГГег. Этот прием демонстрируется в разделе 22.6.5. 

• Можно воспользоваться прикладным интерфейсом доступа к файловой систе¬ 
ме и объектом РіІеІлІгіГег, который описывается в разделе 22.7, чтобы записать 
двоичный объект в локальный файл. 

В следующих подразделах демонстрируются простые способы получения и ис¬ 
пользования двоичных объектов. Более сложные приемы, связанные с использо¬ 
ванием локальной файловой системы и базами данных на стороне клиента, будут 
описаны далее, в отдельных разделах. 

22.6.1. Файлы как двоичные объекты 

Элемент <іприі Гуре= Тііе "> изначально предназначался для обеспечения возмож¬ 
ности выгрузки файлов в НТМЬ-формах. Производители броузеров всегда с осо¬ 
бым тщанием подходили к реализации этого элемента, чтобы позволить ему вы¬ 
гружать только те файлы, которые были явно выбраны пользователем. Сценарии 
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не смогут присвоить имя файла свойству ѵаіие этого элемента, поэтому они лише¬ 
ны возможности выгружать произвольные файлы, находящиеся на компьютере 
пользователя. Совсем недавно производители броузеров расширили возможности 
этого элемента с целью обеспечить доступ к файлам на стороне клиента, выбран¬ 
ным пользователем. Обратите внимание, что возможность читать содержимое 
выбранных пользователем файлов клиентскими сценариями не более и не менее 
опасна, чем возможность выгружать эти файлы на сервер. 

В броузерах, поддерживающих доступ к локальным файлам, свойство 'Гііез эле¬ 
мента <іпри1: іуре-Ті1е"> будет ссылаться на объект Рі1еІ_ізі:. Это объект, подоб¬ 
ный массиву, элементами которого являются объекты Рііе, соответствующие 
файлам, выбранным пользователем. Объект Рііе - это двоичный объект ВІоЬ, ко¬ 
торый имеет дополнительные свойства пате и ІазіМосІШесІОаІіе: 


<зсгірі:> 

// Выводит информацию о выбранных файлах 
Рітсііоп РіІеіпРо(РіІез) { 

Рог(ѵаг і = 0; і < Рііез.ІепдіМ; і++) 
ѵаг Р = Рі1ез[і]; 
сопзоіе.1од(Р. пате, 

Р.зіге, Р.іуре, 

Р. ІазРМосІіРіесІОаРе); 

} 

} 


{ // Рііез - подобный массиву объект 

// Только имя: без пути к файлу 
// размер и тип - свойства ВІоЬ 
// еще одно свойство объекта Рііе 


</зсгірі> 

<!-- Разрешить выбор нескольких файлов изображений и передать их Рі1еіпРо( )--> 
<іпрцр Руре="Рі1е” ассерр=”ітаде/*" гтшІРірІе опсМапде="Рі1еіпРо(РМіз.Рі1ез)"/> 


Возможность выводить имена, типы и размеры файлов не представляет особого 
интереса. В разделах 22.6.4 и 22.6.5 будет показано, как можно использовать со¬ 
держимое файла. 

В дополнение к файлам, выбранным с помощью элемента <іприР>, пользователь 
может также дать сценарию доступ к локальным файлам, буксируя их мышью 
и сбрасывая в окно броузера. Когда приложение получает событие «<1гор», свойст¬ 
во сІаіаТгапзРег.РіІез объекта события будет содержать ссылку на объект РПеИзР, 
связанный с этой операцией буксировки, если в ней участвовали файлы. При¬ 
кладной интерфейс буксировки объектов мышью рассматривался в разделе 17.7, 
а подобное использование файлов демонстрируется в примере 22.10. 


22.6.2. Загрузка двоичных объектов 

Глава 18 охватывает тему выполнения НТТР-запросов с помощью объекта ХМІ_- 
НіІірРедиезІ: и также описывает некоторые новые возможности, определяемые про¬ 
ектом спецификации «XМ^Ні;і;рКе^ие8І; Ьеѵеі 2» (ХНК2). На момент написания 
этих строк спецификация ХНК2 определяла способ загрузки содержимого ІІКЬ- 
адреса в виде двоичного объекта, но реализации броузеров пока не поддерживали 
его. Поскольку программный код не может быть протестирован, этот раздел яв¬ 
ляется лишь схематическим описанием прикладного интерфейса, предусматри¬ 
ваемого спецификацией ХНК2 для работы с двоичными объектами. 

Пример 22.9 демонстрирует простой способ загрузки двоичного объекта из Веб. 
Сравните его с примером 18.2, который загружает содержимое ГГКЬ-адреса как 
простой текст. 
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Пример 22.9. Загрузка двоичного объекта с помощью объекта ХМЬНіірЕедиезі 


// Запрашивает методом СЕТ содержимое ГІРІ в виде двоичного объекта и передает его 
// указанной функции обратного вызова. Этот программный код не тестировался: на тот 
// момент, когда он был написан, броузеры еще не поддерживали этот прикладной интерфейс. 
ГітсТіоп деШоЬ(иг1, саІІЬаск) { 

ѵаг хЬг = пе\ѵ ХМЕНТТрРедцезТС); // Создать новый объект ХНР 


хЬг.ореп("0ЕТ", іігі); 
хЬг.гезропзеТуре = "ЫоЬ" 
хЬг.опІоас! = ГцпсТіопО { 
са11Ьаск(хЬг. гезропзе): 

} 

хЬг. зепсі(піііі); 


// Указать (Ж-адрес 
// Желательно получить двоичный объект 
// опіоаб проще, чем оп геасІузІаІіесГіапде 
// Передать ответ функции обратного вызова 
// Отметьте: .гезропзе, а не .гезропзеТехТ 
// Послать запрос 


Если загружаемый двоичный объект слишком велик и вам хотелось бы начать 
его обработку уже в процессе загрузки, можно задействовать обработчик события 
опргодгеззв комплексе с приемами чтения двоичных объектов, которые демонст¬ 
рируются в разделе 22.6.5. 


22.6.3. Конструирование двоичных объектов 

Двоичные объекты часто представляют фрагменты данных из внешних ресур¬ 
сов, таких как локальные файлы, ІІКЬ-адреса или базы данных. Но иногда веб¬ 
приложению требуется создать собственный двоичный объект, чтобы выгрузить 
его на веб-сервер, сохранить в файле или в базе данных, или передать его фоново¬ 
му потоку выполнения. Создать объект ВІоЬ из имеющихся данных можно с помо¬ 
щью объекта ВІоЬВиіІсІег: 

// Создать новый объект ВІоЬВиіІсІе г 
ѵаг ЬЬ = пе\ѵ ВІоЬВиіІсІе г(); 

// Добавить в двоичный объект строку и отметить ее конец символом N111. 

ЬЬ. аррепсі( "Данный двоичный объект содержит этот текст и 10 ” + 

"32-битных целых чисел с прямым порядком следования байтов."); 

ЬЬ. аррепсі ("\0"); // Добавить символ ИЫ, чтобы отметить конец строки 
// Сохранить некоторые данные в объекте АггауВцГГег 
ѵаг аЬ = пе\ѵ АггауВиГ^ег(4*10); 
ѵаг сіѵ = пем ОаіаѴіе\ѵ(аЬ); 

Гог(ѵаг і = 0; і < 10; і++) сіѵ. зеіІп1:32(і*4, і); 

// Добавить АггауВцГГег в двоичный объект 
ЬЬ. аррепсІ(аЬ); 

// Теперь извлечь полученный двоичный объект, указав искусственный МІМЕ-тип 
ѵаг ЫоЬ = ЬЬ.деіВ1оЬ("х-орііопаІ/тіте-Ііуре-Ьеге"); 

В начале этого раздела мы узнали, что двоичные объекты имеют метод з1ісе(), 
который разбивает их на фрагменты. Точно так же имеется возможность объеди¬ 
нять двоичные объекты, передавая их методу аррепсІО объекта ВІоЬВиіІсІег. 

22.6.4. ІИИ-адреса, ссылающиеся на двоичные объекты 

В предыдущих разделах было показано, как можно получить или создать двоич¬ 
ный объект. Теперь мы поговорим о том, что можно делать с полученными или 
созданными двоичными объектами. Самое простое, что можно сделать с двоич¬ 
ным объектом, - это создать ИКЬ-адрес, ссылающийся на него. Такой ІІКЬ-адрес 
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можно использовать везде, где используются обычные ІІКЬ-адреса: в элементах 
БОМ, в таблицах стилей и даже при работе с объектом ХМШИрРериезІ. 

Создаются ІІКЬ-адреса, ссылающиеся на двоичные объекты, с помощью функции 
сгеаІеОЩесШРЦ). На момент написания этих строк проект спецификации и Гіге- 
Іох 4 помещали эту функцию в глобальный объект ЬНІ_, а броузер СЬготе и библио¬ 
тека АѴеЬкіі добавляли свой префикс к имени этого объекта, называя его меЬкгШВЬ. 
Ранние версии спецификации (и ранние реализации броузеров) помещали эту 
функцию непосредственно в объект Ілііпсісм. Чтобы получить возможность перено¬ 
симым образом создавать ІІКЬ-адреса, ссылающиеся на двоичные объекты, мож¬ 
но определить вспомогательную функцию, как показано ниже: 

ѵаг деШоЬЬРЬ = (\ѵіпс!о\ѵ. ІІРЪ && ІІРЪ. с геаІіеОЬз есШРЪ. ЬіпсІ(І)ВІ)) || 

(\ѵіпс!о\ѵ.\л/еЬкі1:ІІВІ && меЬкі-ШВІ_. сгеа^еОЫесЫР!.. ЬіпсІ(ѵу/еЬкИІІРІ)) || 
міпсіом. сгеа1:еОЬзес1:ІІВІ; 

Фоновые потоки выполнения также могут использовать этот прикладной интер¬ 
фейс и обращаться к тем же функциям, в том же объекте ІІПІ_ (или хл/еЬкИІІРЬ). 

Если передать двоичный объект функции с геаЬеОЬ^ есЬЬРЬС), она вернет ЦКЬ-адрес 
(в виде обычной строки). Этот адрес начинается с названия схемы ЫоЬ://, за кото¬ 
рой следует короткая строка, ссылающаяся на двоичный объект с некоторым 
уникальным идентификатором. Обратите внимание, что эти ІІКЬ-адреса совер¬ 
шенно не похожи на ІІКЬ-адреса сіаііа://, которые представляют свое собственное 
содержимое. ІІКЬ-адрес, ссылающийся на двоичный объект, - это просто ссылка 
на объект ВІоЬ, хранящийся в памяти броузера или на диске. ІІКЬ-адреса вида 
ЫоЬ:// также отличаются от ІІКЬ-адресов Ше://, которые ссылаются непосредст¬ 
венно на файл в локальной файловой системе, давая возможность увидеть путь 
к файлу, позволяя просматривать содержимое каталогов и тем самым затрагивая 
проблемы безопасности. 

Пример 22.10 демонстрирует два важных приема. Во-первых, он реализует «пло¬ 
щадку для сброса», которая обрабатывает события механизма буксировки мышью 
(сіга^-апсі-сігор), имеющие отношение к файлам. Во-вторых, когда пользователь 
сбросит один или более файлов на эту «площадку», с помощью функции сгеаііе- 
ОуеЫЬВЦ) для каждого из файлов будет создан ІІКЬ-адрес и элемент <ітд>, чтобы 
отобразить миниатюры изображений, на которые ссылаются эти ІІКЬ-адреса. 

Пример 22.10. Отображение файлов изображений с использованием ѴЯЬ-адресов 

двоичных объектов 

<! ЬОСТУРЕ Ыт1> 

<Ыт1><ЬеасІ> 

<зсгірі:> 

// На момент написания этих строк создатели Рігеіох и МеЬкіІ: еще не пришли 

// к соглашению об именовании функции с геаІеОЬзесЫІРЬС ) 

ѵаг деІВІоЬЬПІ- = (міпсіом. ЬРЪ && ЬРЬ. сгеаІіеОЬзесІІІРЪ. ЫпсКЬРЬ) ) || 

(\ѵіпсіо\л/. ѵу/еЬкі1:ІІРЪ && меЬкИЬРЬ. сгеаІеОЬзесЫІРЬ. ЬіпсІ(меЬкі1:иРІ_)) || 
міпсіом. сгеа^еОЬзесЫП!-; 

ѵаг геѵокеВ1оЫіРІ_ = (міпсіом. ЬРЬ && ЬРІ_. геѵокеОЬзесЫРІ-. ЬіпсІ(ЬРЬ)) || 

(міпсіом.меЬкі-ШРІ && меЬкИЬРЬ. геѵокеОЫесЫРІ-. ЬіпсІ(\ѵеЬкі1:ІІРІ)) || 
міпсіом. геѵокеОЬзесЫРи 

// После загрузки документа добавить обработчики событий к элементу сігоріагдеі:, 

// чтобы он мог обрабатывать сбрасываемые файлы 
ѵѵіпсіо\л/. опіоасі = Іііпс1:іоп() { 
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// Отыскать элемент, к которому следует добавить обработчики событий, 
ѵаг Ргоріагдеі = сіоситепі:.де1:Е1етеп1:ВуІсІ("сігорііагдеі:"); 

// Выделяет элемент сігоріагдеі изменением рамки, когда пользователь 
// буксирует файлы над ним. 
йгорТагдеТ.опсІгадепТег = Гцпсіііоп(е) { 

// Игнорировать, если буксируется что-то иное, не являющееся файлом. 

// Когда будет реализована поддержка атрибута сігоргопе, определяемого 
// спецификацией НТМІ.5, это позволит упростить обработчик, 
ѵаг іурез = е.йаТаТгапзГег.Турез; 
іТ (! іурез || 

(іурез.сопіаіпз && іурез.сопіаіпз("Рі1ез")) || 

(іурез. іпсІехОі && іурез.іпРехОРС'РіІез") != -1)) { 
сігоріагдеі:.сІаззИзІ:. ас!сІ("асіііѵе"); // Выделить элемент сігоріагдеі 
геіцгп іаізе; // Нас интересует 

} // буксируемый объект 

}; 

// Снимает выделение площадки сброса, как только пользователь 
// отбуксирует файл за ее пределы 
сі горііагдеі: . опсігадіеаѵе = іцпсііоп() { 

сі горііагдеі:. сІаззЬізі. гетоѵе( "асііѵе"); 

}; 

// Этот обработчик просто сообщает броузеру продолжать посылать события 
сігоріагдеі. опсігадоѵег = іцпсііоп(е) { геіигп Гаізе; }; 

// Когда пользователь сбросит файлы, необходимо получить их ИРЬ-адреса 
// и отобразить миниатюры, 
сі горііагдеі:. опсі гор = Рцпсіііоп(е) { 

ѵаг Гііез = е. сІаІаТгапзГег. Гііез; // Сброшенные файлы 

Гог(ѵаг і = 0; і < Гііез.ІепдІН; і++) { // Обойти все файлы в цикле 

ѵаг Іуре = Шез[і].1:уре; 

ІГ (Іуре.зиЬзІ:гіпд(0,6) !== "ітаде/") // Пропустить не являющиеся 

сопИпце; // изображениями 

ѵаг ітд = Росцтепі:.сгеа1:еЕ1етеп1:(”ітд"); // Создать элемент <ітд> 
ітд.згс = де1:В1оЫІРІ(^і1ез[і]); // ОРГ ЫоЬ:// в <ітд> 

ітд.опіоасі = Гипс1:іоп() { // После загрузки изобр. 

ІіГііз. ѵѵісіііГі = 100; // установить его размеры 

Росцтепі:. Ьосіу. аррепсЮГіі1сІ(1:Гііз); // и вставить в документ. 

геѵокеВІоЫІРЦііІііз. зге); // Предотвратить утечки памяти! 

} 

} 

сі горііа гдеі:. сІаззИзІ. гетоѵе( ’асіііѵе"); //Снять выделение 

геіигп Гаізе; // Событие сброса обработано 

} 

}; 

</зсгір1:> 

<з1:у1е> /* Простые стили для оформления площадки сброса */ 

#сІгорііагдеі: { Ьогсіег: зоіісі Ыаск 2рх; ѵшШі: 200рх; ГіеідИІ:: 200рх; } 

#сІгорііагдеіі.асіііѵе { Ьогсіег: зоіісі гесі 4рх; } 

</з1іу1е> 

</ЬеасІ> 

<ЬосІу> <!-- Изначально в документе имеется только площадка сброса --> 

<с!іѵ ісі="сі горііагдеіі">Сбросьте сюда файлы изображений</сііѵ> 

</ЬосІу> 

</Ыт1> 
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ІІКЬ-адреса двоичных объектов имеют то же происхождение (раздел 13.6.2), что 
и сценарии, создавшие их. Это делает их более универсальными по сравнению 
с ІІКЬ-адресами Рііе://, которые имеют иное происхождение, из-за чего послед¬ 
ние сложнее использовать в веб-приложениях. ІІКЬ-адреса двоичных объектов 
считаются допустимыми только в документах с общим происхождением. Если, 
например, с помощью метода роз1:Меззаде() передать ІІКЬ-адрес двоичного объек¬ 
та в окно с документом, имеющим другое происхождение, для этого окна ІІКЬ-ад¬ 
рес будет бессмысленным. 

ЬГКЬ-адреса двоичных объектов не являются постоянными. Такой ІІКЬ-адрес пере¬ 
станет быть действительным, как только пользователь закроет документ или вый¬ 
дет из документа, в котором был создан этот ІІКЬ-адрес. Нельзя, например, сохра¬ 
нить ІІКЬ-адрес двоичного объекта в локальном хранилище и затем повторно ис¬ 
пользовать его, когда пользователь начнет новый сеанс работы с веб-приложением. 

Имеется также возможность вручную «прекращать» действие ІІКЬ-адреса дво¬ 
ичного объекта вызовом метода ЬРІ_. геѵокеОЬ]ес1:ІІРІ_() (или ѵѵеЬкі1:ІІРІ_. геѵокеОЬ]ес1> 
ІІРІ_()), и, как вы могли заметить, пример 22.10 использует эту возможность. Это 
связано с проблемой управления памятью. После того как миниатюра будет ото¬ 
бражена, двоичный объект становится ненужным и его следует сделать доступ¬ 
ным для утилизации сборщиком мусора. Но если веб-броузер будет хранить 
ссылку на созданный двоичный объект в виде ІІКЬ-адреса двоичного объекта, он 
не сможет утилизировать его, даже если он не будет больше использоваться в при¬ 
ложении. Интерпретатор Лѵабсгірі не может следить за использованием строк, 
и если ІІКЬ-адрес по-прежнему остается допустимым, он вправе предположить, 
что этот адрес все еще используется. Это означает, что интерпретатор не сможет 
утилизировать двоичный объект, пока не будет прекращено действие ІІКЬ-адре¬ 
са. Пример 22.10 работает с локальными файлами, не требующими утилизации, 
но представьте, какие серьезные утечки памяти могут быть при работе с двоич¬ 
ными объектами, создаваемыми в памяти методом ВІоЬВиіІсІег или загружаемы¬ 
ми с помощью объекта ХМЫНЫірРедиезІ: и сохраняемыми во временных файлах. 

ІІКЬ -схема ЫоЬ:// явно проектировалась как упрощенный вариант схемы ЬИр://, 
и при обращении по ІІКЬ-адресу ЫоЬ:// броузеры должны действовать как своеоб¬ 
разные НТТР-серверы. При запросе недействительного ІІКЬ-адреса двоичного 
объекта броузер должен послать в ответ код состояния 404 «N 0 ! Еоипсі». При за¬ 
просе ІІКЬ-адреса двоичного объекта с другим происхождением броузер должен 
вернуть код состояния 403 «N 0 ! Аіклѵеб». ІІКЬ-адреса двоичных объектов могут 
использоваться только в запросах СЕТ, и в случае успешного выполнения запро¬ 
са броузер должен отправить код состояния 200 «ОК» и заголовок СопЬепЬ-Туре со 
значением свойства Ьуре двоичного объекта ВІоЬ. Поскольку ІІКЬ-адреса двоич¬ 
ных объектов действуют как упрощенные ІІКЬ-адреса М:1:р://, их содержимое 
можно «загружать» с помощью объекта ХМШИгрРериезЬ (Однако, как будет пока¬ 
зано в следующем разделе, содержимое двоичного объекта можно прочитать бо¬ 
лее непосредственным способом - с помощью объекта РіІеРеасІег.) 

22.6.5. Чтение двоичных объектов 

До сих пор двоичные объекты были для нас непрозрачными фрагментами данных, 
которые позволяют обращаться к их содержимому только косвенным способом, 
посредством ІІКЬ-адресов двоичных объектов. Объект РіІеРеасІег дает возможность 
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читать символы или байты, хранящиеся в двоичном объекте, и его можно рассмат¬ 
ривать как противоположность объекту ВІоЬВиіІсІег. (Для него больше подошло бы 
имя ВІоЬПеасІег, поскольку он может работать с любыми двоичными объектами, 
а не только с файлами.) Так как двоичные объекты могут быть очень большими 
и храниться в файловой системе, прикладной интерфейс чтения их содержимого 
действует асинхронно, во многом подобно тому, как действует объект ХМШИрРедиезІ. 
Фоновым потокам доступна также синхронная версия прикладного интерфейса 
в виде объекта РіІеРеасІе гЗупс, хотя они могут использовать и асинхронную версию. 

Чтобы воспользоваться объектом РіІеВеасІег, сначала необходимо создать его экзем¬ 
пляр с помощью конструктора Рі1еВеасІег(). Затем определить обработчики собы¬ 
тий. Обычно в приложениях определяются обработчики событий «Іоасі» и «еггог» 
и иногда - обработчик событий «рго^геве». Сделать это можно посредством свойств 
опіоасі, опеггог и опргодгезз или с помощью стандартного метода асІсІЕѵеп1:І_і5І:епег(). 
Кроме того, объекты РіІеВеасІег генерируют события «Іоасізіагі», «Іоасіепсі» и «аЪогі», 
которые соответствуют одноименным событиям в объекте ХМЫНІіІірПедиезІ: (раз¬ 
дел 18.1.4). 

После создания объекта РіІеВеасІег и регистрации необходимых обработчиков со¬ 
бытий можно передать двоичный объект, содержимое которого требуется прочи¬ 
тать, одному из четырех методов: геасІАзТехіО, геасІАзАггауВиГГег(), геасІАзОаІіаиВЦ) 
и геасІАзВіпагуЗі:гіпд(). (Разумеется, можно сначала вызвать один из этих методов 
и лишь потом зарегистрировать обработчики событий - благодаря однопоточной 
природе ^ѵаЗсгірі, о которой рассказывалось в разделе 22.4, обработчики собы¬ 
тий не могут быть вызваны, пока ваша функция не вернет управление и броузер 
не сможет продолжить цикл обработки событий.) Первые два метода являются 
наиболее важными, и только они будут описаны здесь. Каждый из этих методов 
чтения принимает двоичный объект ВІоЬ в первом аргументе. Метод геасІАзТехіО 
принимает необязательный второй аргумент, определяющий имя кодировки тек¬ 
ста. Если кодировка не указана, метод автоматически будет обрабатывать текст 
в кодировках А8СП и ІЛТ-8 (а также текст в кодировке ІЛТ-16 с маркером поряд¬ 
ка следования байтов (Ьуіе-огсіег тагк, ВОМ)). 

По мере чтения содержимого указанного двоичного объекта объект РіІеВеасІег бу¬ 
дет обновлять значение своего свойства геасІуЗііаІіе. Первоначально это свойство 
получает значение 0, показывающее, что еще ничего не было прочитано. Когда 
становятся доступны какие-нибудь данные, оно принимает значение 1 и по окон¬ 
чании чтения - значение 2. Свойство гезиіі: хранит частично или полностью про¬ 
читанные данные в виде строки или объекта АггауВиРРег. Веб-приложения обычно 
не опрашивают свойства геасІуЗііаІіе и гезиіі: и вместо этого используют обработ¬ 
чик события опргодгезз или опіоасі. 

Пример 22.11 демонстрирует, как использовать метод геасІАзТехіО для чтения ло¬ 
кальных текстовых файлов, выбранных пользователем. 


Пример 22.11. Чтение текстовых файлов с помощью объекта РйеНеайег 


<зсгір1:> 

// Читает указанный текстовый файл 
Рііпсііоп геасІРіІе(Р) { 

ѵаг геасіег = пе\ѵ РіІеРеасІег(); 
геасіег. геасІАзТехіСО; 
геасіег. опіоасі = РііпсРіопО { 


и отображает его в элементе <рге> ниже 

// Создать объект РіІеРеасІе г 

// Прочитать файл 

// Определить обработчик события 
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ѵаг ТехТ = геасіег. гезиіі:; // Это содержимое файла 

ѵаг оііТ = сіоситепі:. де1:Е1етеп1:ВуІс1("ои1:ри1:”); // Найти элемент оьіриі: 

оііТ. іппегНТМІ. = // Очистить его 

оиі.аррепсіСЬіІсКсіоситепі:. сгеаТеТехТМойеСТехТ )); // Вывести содержимое 
} // файла 

геасіег. опеггог = Рипсіііоп(е) { // Если что-то пошло не так 

сопзоіе.ІодС'Еггог", е); // Вывести сообщение об ошибке 

}; 

} 

</зсгірі:> 

// Выберите файл для отображения: 

<іпріі1: іуре="Ше" опсЬапде="геасІШе(1:Ы5.Шез[0])”х/іпри1:> 

<рге ісІ="ои1:ри1:"></рге> 

Метод геасІАзАггауВиІ^егО похож на метод геасІАзТехіО, за исключением того, что 
требует приложить чуть больше усилий при работе с результатом, возвращая 
объект АггауВиІ^ег вместо строки. Пример 22.12 демонстрирует использование ме¬ 
тода геасІАзАггауВиІ^егО для чтения первых четырех байтов из файла в виде цело¬ 
го числа с прямым порядком следования байтов. 

Пример 22.12. Чтение первых четырех байтов из файла 

<зсгір1:> 

// Исследует первые 4 байта в указанном двоичном объекте. Если это "сигнатура", 

// определяющая тип файла, асинхронно устанавливает свойство двоичного объекта. 

Рітсііоп ІуреШе(Ше) { 

ѵаг зіісе = Ше.з1ісе(0,4); // Читать только первые 4 байта 

ѵаг геасіег = пе\ѵ Рі1еВеасІег(); // Создать асинхронный РіІеВеасІег 

геасіег. геасІАзАггауВііРРегСзІісе); // Прочитать фрагмент файла 
геасіег.опіоасі = Рііпс1:іоп(е) { 

ѵаг ЬііІРег = геасіег. гезіЛІ:; // Результат - АггауВііРРег 

ѵаг ѵіеѵѵ = пе\ѵ 0а1:аѴіе\ѵ(ЬііРРег); // Получить доступ к результату 

ѵаг тадіс = ѵіеѵѵ. деШп1:32(0, Раізе): // 4 байта, прямой порядок 
зѵ/і1:сИ(тадіс) { // Определить по ним тип файла 

сазе 0х89504Е47: Ше.ѵегШес!_1:уре = "ітаде/рпд"; Ьгеак; 
сазе 0x47494638: Ше. ѵегіРіес!_1:уре = "ітаде/діР"; Ьгеак; 
сазе 0x25504446: Ше.ѵегШес!_1:уре = "арр1іса1:іоп/рсіР"; Ьгеак; 
сазе 0х504Ь0304: Ше.ѵегіРіесИіуре = "арріісаііоп/гір"; Ьгеак; 

} 

сопзоіе. 1од(Ше. пате, Ше. ѵегШес!_1:уре); 

}; 

} 

</зсгір1:> 

<іпри1: Іуре="Ше" опсЬапде="1:уреШе(1:Ьіз. Шез[0])”х/іпри1:> 

В фоновых потоках выполнения вместо объекта РіІеВеасІег можно использовать 
объект РіІеПеасІегЗупс. Синхронный прикладной интерфейс определяет те же ме¬ 
тоды геасІАзТехіО и геасІАзАггауВи1 = 1 : ег(), которые принимают те же аргументы, что 
и их асинхронные версии. Разница заключается лишь в том, что синхронные ме¬ 
тоды блокируются до окончания операции и непосредственно возвращают ре¬ 
зультат в вид строки или объекта АггауВи'Г'Гег, что избавляет от необходимости ис¬ 
пользовать обработчики событий. Пример 22.14 ниже демонстрирует использова¬ 
ние объекта РіІеВеасІегЗупс. 
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22.7. Прикладной интерфейс к файловой системе 

В разделе 22.6.5 вы познакомились с классом РіІеВеасІег, использовавшимся для 
чтения содержимого файлов, выбираемых пользователем, или любых двоичных 
объектов. Типы Рііе и ВІоЬ определяются проектом спецификации, известной как 
«Гііе АРІ». Проект другой спецификации, еще более новой, чем «Гііе АРІ», дает 
веб-приложениям управляемый доступ к частной файловой системе, где они могут 
писать в файлы, читать файлы, создавать каталоги, читать содержимое каталогов 
и т. д. На момент написания этих строк данный прикладной интерфейс к файловой 
системе был реализован только в броузере Ооо^іе СЬготе. Это мощная и важная 
форма локального хранилища, поэтому она будет описана здесь, несмотря на то что 
ее прикладной интерфейс еще менее стабилен, чем другие прикладные интерфей¬ 
сы, описываемые в этой главе. Данный раздел охватывает лишь основные задачи, 
выполняемые с файловой системой, и не демонстрирует всех возможностей при¬ 
кладного интерфейса. Так как обсуждаемый здесь прикладной интерфейс явля¬ 
ется новым и нестабильным, он не описывается в справочном разделе этой книги. 

Работа с файлами в локальной файловой системе является многоэтапным про¬ 
цессом. Прежде всего, необходимо получить объект, представляющий саму фай¬ 
ловую систему. Сделать это можно с помощью синхронного прикладного интер¬ 
фейса в фоновом потоке или асинхронного - в основном потоке выполнения: 

// Метод синхронного получения файловой системы. Принимает параметры, 

// определяющие срок существования файловой системы и ее размер. 

// Возвращает объект файловой системы или возбуждает исключение, 
ѵаг = гедиез1:Рі1еЗуз1:етЗупс(РЕРЗІЗТЕМТ, 1024*1024); 

// Асинхронная версия принимает функции обратного вызова для обработки 
// успешного или неудачного создания файловой системы 
гециезІіРіІеЗузІіетСТЕМРОПАПѴ, // срок существования 

50*1024*1024, // размер: 50 Мбайт 

^ипсіііоп (^з) { // будет вызвана с объектом файловой системы 
// Здесь используется объект 

}, 

^ипсіііоп (е) { // будет вызвана с объектом ошибки 

сопзоіе. 1од(е); // Или как-то иначе обработать ошибку 

}); 

В обеих версиях прикладного интерфейса, синхронной и асинхронной, указыва¬ 
ются срок существования и желаемый размер файловой системы. Файловая сис¬ 
тема, срок существования которой определяется константой РЕВЗІЗТЕМТ (постоян¬ 
ная), подходит для веб-приложений, которым требуется хранить пользователь¬ 
ские данные постоянно. Броузер не будет удалять эту файловую систему, пока 
пользователь явно не потребует этого. Файловая система, срок существования 
которой определяется константой ТЕМР0ЯАРУ (временная), подходит для веб-прило¬ 
жений, которые требуют кэшировать данные, но также сохраняют работоспособ¬ 
ность и после того, как веб-броузер удалит файловую систему. Размер файловой 
системы определяется в байтах и должен быть равен разумному верхнему преде¬ 
лу объема данных, которые потребуется сохранять. Броузер может ограничивать 
этот размер, устанавливая квоты. 

Доступность файловой системы определяется происхождением создавшего ее до¬ 
кумента. Все документы или веб-приложения с общим происхождением (хост, 
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порт и протокол) будут совместно использовать одну и ту же файловую систему. 
Два документа или приложения с разным происхождением будут пользоваться 
совершенно разными и никак не связанными между собой файловыми система¬ 
ми. Кроме того, файловая система веб-приложения отделена от остальных фай¬ 
лов на жестком диске пользователя: веб-приложения не имеют никакой возмож¬ 
ности «вырваться» за пределы локального корневого каталога или как-то иначе 
получить доступ к произвольным файлам. 

Обратите внимание, что в именах этих функций присутствует слово «^е^ие8^;» 
(запросить). Когда приложение вызывает одну из этих функций в первый раз, 
броузер может запросить разрешение у пользователя, прежде чем создать файло¬ 
вую систему и разрешить доступ к ней. 1 После получения доступа все последую¬ 
щие вызовы метода гедиезі будут просто возвращать объект, представляющий 
уже имеющуюся локальную файловую систему. 

Объект файловой системы, полученный одним из методов, представленных вы¬ 
ше, имеет свойство гооі, ссылающееся на корневой каталог файловой системы. 
Это объект ЭігесІіогуЕпІігу, и он может иметь вложенные каталоги, представлен¬ 
ные собственными объектами Эі гесііогуЕпіігу. Каждый каталог в файловой систе¬ 
ме может содержать файлы, представленные объектами РіІеЕпІігу. Объект Эігесііо- 
гуЕпІігу определяет методы для получения объектов йігесіогуЕпігу и РіІеЕпІігу по 
пути в файловой системе (они могут создавать новые каталоги и файлы, если ука¬ 
занное имя не существует). Объект ЭігесІіогуЕпІігу также определяет фабричный 
метод сгеаіеРеабег(), возвращающий объект ЭігесІіогуПеасІег, который позволяет 
получить список содержимого каталога. 

Класс РіІеЕпігу определяет метод для получения объекта Рііе (двоичный объект 
ВІоЬ), представляющий содержимое файла. Получив этот объект, его содержимое 
можно прочитать с помощью объекта РіІеЯеасІег (как показано в разделе 22.6.5). 
Объект РіІеЕпІігу определяет еще один метод, возвращающий объект РіІеМгііег, 
который можно использовать для записи в файл. 

Операции чтения и записи с использованием этого прикладного интерфейса пред¬ 
ставляют собой многоэтапный процесс. Прежде всего, необходимо получить объ¬ 
ект файловой системы. Затем, используя свойство гооі этого объекта, необходимо 
отыскать (и при необходимости создать) объект РіІеЕпігу, представляющий тре¬ 
буемый файл. Затем с помощью объекта РіІеЕпігу нужно получить объект Рііе или 
РіІеМгііег для выполнения операции чтения или записи. Этот процесс становится 
особенно сложным при использовании асинхронного прикладного интерфейса: 

// Читает текстовый файл "Ііеііо.іхі" и выводит его содержимое. При использовании 
// асинхронного прикладного интерфейса глубина вложенности функций достигает 
// четырех уровней. Этот пример не включает определения функций обработки ошибок. 
гециез1:Рі1еЗуз1:ет(РЕРЗІЗТЕМТ , 10*1024*1024, іипсііоп(із) { // Получить объект ФС 
із.гооі . деіРі1е("Неііо. іхі ”, {}, іипсііоп(епігу) { // Получить РіІеЕпігу 

епігу.Рі1е(іипсііоп(іі1е) { // Получить Рііе 

ѵаг геабег = пем Рі1еПеабег(); 
геабег. геабАзТехі(ііІе); 

геабег.опіоаб = іипсііоп() { // Получить содержимое файла 


1 На момент написания этих строк броузер СЬготе не запрашивал разрешение у пользо¬ 
вателя, но требовал, чтобы он был запущен с ключом командной строки --ипіітііеб- 
дуоіа-іог-іііез. 
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сопзоіе. 1од( геасіег. гезиіі:); 

}; 

}); 

}); 

}); 

В примере 22.13 демонстрируется более полное решение. В нем показано, как ис¬ 
пользовать асинхронный прикладной интерфейс для чтения, записи и удаления 
файлов, создания каталогов и получения списков их содержимого. 

Пример 22.13 . Использование асинхронного прикладного интерфейса доступа 

к файловой системе 

Л 

* Следующие функции были протестированы в Соодіе СЬгоше 10.0 беѵ. 

* Вам может потребоваться запустить СЬгоше со следующими ключами: 

* --ипІітіІіесІ-диоІіа-Гог-ТіІез : разрешает доступ к файловой системе 

* --аііом-іііе-ассезз-ігот-і'ііез : разрешает тестировать из ЬПІ_ "Гііе :// 

*/ 

// Многие асинхронные функции, используемые здесь, принимают необязательные функции 
// обратного вызова для обработки ошибок. 

// Следующая функция просто выводит сообщение об ошибке. 

^ипсііоп Іодегг(е) { сопзоіе. 1од(е); } 

// гециезІіРіІебузІіетО возвращает локальную файловую систему, доступную 
// только приложениям с указанным происхождением. Приложение может читать 
// и писать файлы в ней, но не может получить доступ к остальной файловой системе, 
ѵаг іііезузіет; // Предполагается, что эта переменная будет инициализирована 

// перед вызовом функции, объявленной ниже. 
гециез1:Рі1еЗуз1:ет(РЕР8ІЗТЕМТ , // Или ТЕМРОПАПУ для кэширования файлов 

10*1024*1024, // Требуется 10 Мбайт 

ГипсТіопСТз) { // После выполнения вызвать эту функцию 

Рііезузііет = Тз; // Просто сохранить ссылку на файловую систему 
}, //в глобальной переменной. 

Іодегг); // Вызвать эту функцию в случае ошибки 

// Читает содержимое указанного файла как текст и передает его функции обратного вызова, 
іипсііоп геасГГехТРПеСраТЬ, саІІЬаск) { 

// Вызвать деТРіІеО, чтобы получить объект РіІеЕпТгу для файла 
// с указанным именем 

ГіІезузТет. гооТ.деТРПеСраТЬ, {}, іипс1:іоп(еп1:гу) { 

// При вызове этой функции передается объект РіІеЕпТгу, соответствующий файлу. 

// Теперь следует вызвать метод РіІеЕпІгу.Гі1е( ), чтобы получить объект Рііе 
епіігу. ШеСГипсИопСШе) { // Вызвать с объектом Рііе 

ѵаг геасіег = пем Рі1еПеасІег( ); // Создать объект РіІеПеасІег 
геасіег. геасІАзТех1:(Гі1е); // И прочитать файл 

геасіег. опіоасі = Типсіііоп () { // В случае успешного чтения 

са11Ьаск( геасіег. гезиіі: ); // Передать данные функции саІІЬаск 

} 

геасіег. опе г го г = Іодегг; // Сообщить об ошибке в геасІАзТехІ () 

}, Іодегг); // Сообщить об ошибке в Рі1е() 

}, 

Іодегг); // Сообщить об ошибке в деіРіІеО 

} 


// Добавляет указанное содержимое в конец файла с указанным именем, создает новый файл, 
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// если файл с указанным именем не существует. Вызывает саІІЬаск по завершении операции, 
^ипсіііоп аррепс!ТоРі1е(раІЬ, сопРепРз, саІІЬаск) { 

// РіІезузРет. гооР - это корневой каталог. 

РіІезузРет. гооР. деРРі1е( // Получить объект РіІеЕпРгу 
раРЬ, // Имя и путь к требуемому файлу 

{сгеаРе:Ргие}, // Создать, если не существует 

РипсРіоп(епРгу) { // Вызвать эту функцию, когда файл будет найден 

епРгу. сгеаРеІ\/гіРег( // Создать для файла объект РіІеМгіРег 
РипсРіоп(мгіРег) { // Вызвать эту функцию после создания 
// По умолчанию запись производится в начало файла. 

// Нам же требуется выполнить запись в конец файла 

мгіРег.зеек(ѵ\/гірег.ІепдРЬ); // Переместиться в конец файла 


// Преобразовать содержимое файла в объект ВІоЬ. Аргумент сопРепРз 
// может быть строкой, объектом ВІоЬ или объектом АггауВиРРег. 
ѵаг ЬЬ = пем В1оЬВиі1с1ег( ) 

ЬЬ. аррепсКсопРепРз); 
ѵаг ЫоЬ = ЬЬ.деРВ1оЬ(); 


// Записать двоичный объект в файл 
мгіРег. мгіРе(ЫоЬ); 

мгіРег. опеггог = Іодегг; // Сообщить об ошибке в ѵіг іРе() 

ІР (саІІЬаск) // Если указана функция саІІЬаск 

ѵі/гіРег.опмгіРе = саІІЬаск; // вызвать в случае успеха 

}. 

Іодегг); // Сообщить об ошибке в сгеаРеѴ\/гіРег( ) 


Іодегг); // Сообщить об ошибке в деРРі1е() 

} 

// Удаляет файл с указанным именем, вызывает саІІЬаск по завершении операции. 
РипсРіоп Ье1еРеРі1е(пате, саІІЬаск) { 

РіІезузРет. гооР. деРРі1е(пате, {}, // Получить РіІеЕпРгу по имени файла 

РипсРіоп(епРгу) { // Передать РіІеЕпРгу сюда 
епргу.гетоѵе(са11Ьаск, // Удалить файл 
Іодегг); // Или сообщить 
}, //об ошибке в гешоѵеО 

Іодегг); // Сообщить об ошибке в деРРі1е() 

} 

// Создает новый каталог с указанным именем 
РипсРіоп такеОігесРогу(пате, саІІЬаск) { 

РіІезузРет.гооР.деРОігесРогу(пате, // Имя создаваемого каталога 

{ // Параметры 

сгеаРе: Ргие, // Создать, если не сущ. 
ехсіизіѵеіргие // Ошибка, если существует 

}, 

саІІЬаск, // Вызвать по завершении 
Іодегг); // Выводить любые ошибки 

} 

// Читает содержимое указанного каталога и передает его в виде массива строк 
// указанной функции саІІЬаск 
РипсРіоп 1ізРРі1ез(раРЬ, саІІЬаск) { 

// Если каталог не указан, получить содержимое корневого каталога. 

// Иначе отыскать каталог с указанным именем и вернуть список 
// с его содержимым (или сообщить об ошибке поиска). 

ІР (ІраРЬ) деРРі1ез(Рі1езузРет.гооР); 




746 


Глава 22. Прикладные интерфейсы НТМІ.5 


еізе Шезузіет. гооТ.деЮігес1:огу(раіііі. {}, деіРіІез, Іодегг); 

^ипсіііоп деіРіІез(сІіг) { // Эта функция используется выше 

ѵаг геасіег = сііг. сгеа1іеПеас1ег(); // Объект ОігесіогуВеасІег 

ѵаг НзТ = []; // Для сохранения имен файлов 

геасіег. геасІЕпІ:гіез(ЬапсІІеЕпІ:гіез, // Передать функции ниже 

Іодегг); // или сообщить об ошибке. 

// Чтение каталогов может превратиться в многоэтапный процесс. 

// Необходимо сохранять результаты вызовов геасІЕпІгіез( ), пока не будет 
// получен пустой массив. На этом операция будет закончена, 

// и полный список можно будет передать функции саІІЬаск. 

Рипсііоп ЬапсІІеЕпІ:гіез(епі:гіез) { 

ІР (епТгіез.ІепдТЬ == 0) са11Ьаск(Іізі:); // Операция закончена 
еізе { 

// Иначе добавить эти записи в общий список и запросить 
// очередную порцию. Объект, подобный массиву, содержит 
// объекты РіІеЕпігу, и нам следует получить имя для каждого. 

Рог(ѵаг і = 0; і < епігіез.ІепдіЬ; і++) { 

ѵаг пате = епТгіезЦ]. пате; // Получить имя записи 
ІР (епргіез[і].ізОігесРогу) пате += "/"; // Пометить каталоги 
ІізР.ризЬ(пате); // Добавить в список 

} 

// Получить следующую порцию записей 
геасіег. геас!ЕпРгіез(ІіапсІ1еЕпРгіез, Іодегг); 

} 

} 

} 

} 

Работать с файлами и с файловой системой намного проще в фоновых потоках 
выполнения, где допускается выполнять блокирующие вызовы и можно исполь¬ 
зовать синхронный прикладной интерфейс. Пример 22.14 определяет те же функ¬ 
ции для работы с файловой системой, что и пример 22.13, но использует синхрон¬ 
ный прикладной интерфейс, и потому получился намного короче. 

Пример 22.14. Синхронный прикладной интерфейс для работы с файловой системой 

// Утилиты для работы с файловой системой, использующие синхронный прикладной 
// интерфейс, предназначенный для фоновых потоков выполнения 
ѵаг РіІезузРет = гедиезРРіІеЗузРетбупсСРЕПЗІЗТЕМТ, 10*1024*1024); 

РипсРіоп геасІТехРРіІе(пате) { 

// Получить объект Рііе из объекта РіІеЕпРгу из корневого ОігесІіогуЕпІігу 
ѵаг Ше = Шезузіет. гооі. де1:Рі1е(пате). Ше( ); 

// Использовать для чтения синхронную версию РіІеПеасІег 
геііигп пем Рі1еПеас1егЗупс(). геас!АзТех1:(Гі1е); 

} 

Рипсііоп аррепсІТоРі1е(пате, сопіетз) { 

// Получить Рі1еѴ\Ігі1:ег из РіІеЕпІгу из корневого ОігесІіогуЕпІігу 

ѵаг мгііег = Шезузіет. гооі. деі Рііе (пате, {сгеаіе:1гие}).сгеаіе1\1гііег(); 

\л/гііег. зеек(\ѵгі1іег. ІепдіЬ); // Начать запись с конца файла 

ѵаг ЬЬ = п еѵі ВІоЬВиіІсІег() // Собрать содержимое в виде объекта ВІоЬ 

Ыэ. аррепб (сопіепііз); 

мгііег.мгііе(ЬЬ.де1іВ1оЬ()); // Записать двоичный объект в файл 


} 
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ТипсТіоп бе1е1:еРі1е(пате) { 

ШезузТет. гею*. деіРіІе (пате). гетоѵе(); 

} 

Рипсііоп такеОігесІіогу(пате) { 

РіІезузТет. гооі.деЮігесІіогуСпате, { сгеаТе: Ігие, ехс1изіѵе:1:гие }); 

} 

Рипсііоп ІізТРіІез(раТІі) { 
ѵаг сііг = РіІезузТет. гооТ; 

ІР (раІЬ) сііг = сііг. деЮігесІіогуСраІіЬ); 

ѵаг Іізіег = сііг.сгеа1:еРеасіег(); 
ѵаг ІізТ = []; 
сіо { 

ѵаг епігіез = Іізіег. геасІЕпІ:гіез(); 

Рог(ѵаг і = 0; і < епігіез.ІепдІЬ; і++) { 
ѵаг пате = епТгіез[і]. пате; 

ІР (епргіез[і]. ізОігесРогу) пате += 

Из*. ризЬ(пате); 

} 

} ѵ»/Ьі1е(епРгіез.ІепдРИ > 0); 
геРигп ІізР; 

} 

// Разрешить основному потоку выполнения использовать эти утилиты, посылая сообщения 
оптеззаде = РипсРіоп(е) { 

// Сообщение должно быть объектом: 

// { РипсРіоп: "аррепсІТоРіІе", агдз: ["РезР", "РезРіпд, РезРіпд"]} 

// Вызвать указанную функцию с указанными аргументами и послать сообщение обратно 

ѵаг Р = зе1Р[е.сІаРа. РипсРіоп]; 

ѵаг гезиІР = Р.арр1у(пи11, е.сІаРа.агдз); 

розРМеззаде( гезиіі:); 

}; 

22.8. Базы данных на стороне клиента 

Архитектура веб-приложений традиционно была основана на поддержке НТМЬ, 
С88 и ЛаѵаЗсгірі на стороне клиента и базы данных на стороне сервера. Поэтому 
одним из самых удивительных прикладных интерфейсов, определяемых специ¬ 
фикацией НТМЬ.5, является поддержка баз данных на стороне клиента. Это не 
прикладные интерфейсы доступа к базам данных на стороне сервера, а действи¬ 
тельно интерфейсы доступа к базам данных, хранящимся на компьютере клиен¬ 
та и доступным непосредственно из программного кода на языке ЛаѵаЗсгірі, вы¬ 
полняемого броузером. 

Прикладной интерфейс веб-хранилища, определяемый спецификацией <ЛѴеЪ 8іо- 
га&е» и описанный в разделе 20.1, можно расценивать как простейшую разновид¬ 
ность базы данных, хранящую пары ключ/значение. Но помимо него имеются 
еще два прикладных интерфейса доступа к клиентским базам данных, которые 
являются «настоящими» базами данных. Один из них известен как «^\ѴеЬ 8(^Ь 
БаіаЬазе» - простая реляционная база данных, поддерживающая простейшие 
ЗС^Ь-запросы. Этот прикладной интерфейс реализован в броузерах СЬготе, 8а1агі 
и Орега. Он не реализован в Гігеіох и ІЕ и, скорее всего, никогда не будет реали¬ 
зован в них. Работа над официальной спецификацией этого прикладного интер- 
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фейса была остановлена, и поддержка полноценной базы данных вероятно, 
никогда не приобретет статус официального стандарта или неофициальной, но 
широко поддерживаемой особенности веб-платформы. 

В настоящее время все усилия по стандартизации сконцентрированы на другом 
прикладном интерфейсе к базам данных, известном как ІпсІехесШВ. Пока слиш¬ 
ком рано описывать детали этого прикладного интерфейса (его описание отсутст¬ 
вует в четвертой части книги), но Гігеіох 4 и СЬготе 11 включают его реализацию, 
и в этом разделе будет представлен действующий пример, демонстрирующий не¬ 
которые из наиболее важных особенностей прикладного интерфейса ІпсІехесШВ. 

ІпсІехесШВ - это объектная, а не реляционная база данных, и она намного проще, 
чем базы данных, поддерживающие язык запросов 8(^Ь. Однако она гораздо мощ¬ 
нее, эффективнее и надежнее, чем веб-хранилище пар ключ/значение, доступное 
посредством прикладного интерфейса ЛѴеЪ 8іога&е. Как и в случае прикладных 
интерфейсов к веб-хранилищам и файловой системе, доступность базы данных 
ІпсІехесШВ определяется происхождением создавшего ее документа: две веб-стра¬ 
ницы с общим происхождением могут обращаться к данным друг друга, но веб¬ 
страницы с разным происхождением - нет. 

Для каждого происхождения может быть создано произвольное число баз данных 
ІпсІехесШВ. Каждая база данных имеет имя, которое должно быть уникальным 
для данного происхождения. С точки зрения прикладного интерфейса ІпсІехесШВ 
база данных является простой коллекцией именованных хранилищ объектов . 
Как следует из этого названия, хранилище объектов хранит объекты (или любые 
другие значения, которые можно копировать, - смотрите врезку «Структуриро¬ 
ванные копии» выше). Каждый объект должен иметь ключ , под которым он сохра¬ 
няется и извлекается из хранилища. Ключи должны быть уникальными - два 
объекта в одном хранилище не могут иметь одинаковые ключи, - и они должны 
иметь естественный порядок следования, чтобы их можно было сортировать. При¬ 
мерами допустимых ключей являются строки, числа и объекты йаііе. База данных 
ІпсІехесШВ может автоматически генерировать уникальные ключи для каждого 
объекта, добавляемого в базу данных. Однако часто объекты, сохраняемые в хра¬ 
нилище объектов, уже будут иметь свойство, пригодное для использования в ка¬ 
честве ключа. В этом случае при создании хранилища объектов достаточно просто 
определить «путь к ключу», определяющий это свойство. Концептуально, путь 
к ключу - это значение, сообщающее базе данных, как извлечь ключ из объекта. 

Помимо возможности извлекать объекты из хранилища по значению первичного 
ключа существует также возможность выполнить поиск по значениям других 
свойств объекта. Чтобы обеспечить эту возможность, в хранилище объектов мож¬ 
но определить любое количество индексов . (Способность индексировать объекты 
подчеркивается самим названием «ІпсІехесШВ».) Каждый индекс определяет вто¬ 
ричный ключ хранимых объектов. Эти индексы в целом могут быть неуникаль¬ 
ными, и одному и тому же ключу может соответствовать множество объектов. 
Поэтому в операциях обращения к хранилищу объектов с использованием ин¬ 
декса обычно используется курсор , определяющий прикладной интерфейс для 
извлечения объектов из потока результатов по одному. Курсоры могут также ис¬ 
пользоваться для обращения к хранилищу объектов с использованием диапазона 
ключей (или индексов), и прикладной интерфейс ІпсІехесШВ включает объект, ис¬ 
пользуемый для описания диапазонов (с верхней и/или с нижней границей, 
включающих или не включающих границы) ключей. 
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ІпсІехесШВ гарантирует атомарность операций: операции чтения и записи в базу 
данных объединяются в транзакции , благодаря чему либо они все будут успеш¬ 
но выполнены, либо ни одна из них не будет выполнена, и база данных никогда не 
останется в неопределенном, частично измененном состоянии. Транзакции в Іп¬ 
сІехесШВ реализованы намного проще, чем во многих других прикладных интер¬ 
фейсах к базам данных, и мы еще вернемся к ним ниже. 

Концепция прикладного интерфейса ІпсІехесШВ чрезвычайно проста. Чтобы про¬ 
читать или изменить данные, сначала необходимо открыть требуемую базу дан¬ 
ных (указав ее имя). Затем создать объект транзакции и с помощью этого объекта 
отыскать требуемое хранилище объектов в базе данных, также по имени. Нако¬ 
нец, отыскать объект вызовом метода деШ хранилища объектов или сохранить 
новый объект вызовом метода риШ. (Или вызвать метод ас!с1(), если необходимо 
избежать затирания существующих объектов.) Если потребуется отыскать объ¬ 
екты по диапазону ключей, нужно создать объект ЮВПапде и передать его методу 
орепСигзог() хранилища объектов. Или, если потребуется выполнить запрос по 
вторичному ключу, отыскать именованный индекс в хранилище объектов и за¬ 
тем вызвать метод деШ или орепСигзог() объекта-индекса. 

Однако эта концептуальная простота осложняется тем фактом, что прикладной 
интерфейс должен быть асинхронным, чтобы веб-приложения могли пользовать¬ 
ся им, не блокируя основной поток выполнения броузера, управляющий пользо¬ 
вательским интерфейсом. (Спецификация ІпсІехесШВ определяет синхронную 
версию прикладного интерфейса для использования в фоновых потоках выпол¬ 
нения, но на момент написания этих строк ни один броузер еще не реализовал эту 
версию, поэтому она не рассматривается здесь.) Создание транзакции, а также 
поиск хранилища объектов и индексов являются простыми синхронными опера¬ 
циями. Но открытие базы данных, обновление хранилища объектов с помощью 
метода риШ и получение хранилища или индекса с помощью метода деШ или 
орепСигзог() являются асинхронными операциями. Все эти асинхронные методы 
немедленно возвращают объект запроса. В случае успешного или неудачного вы¬ 
полнения запроса броузер генерирует событие «зиссезз» или «еггог» в объекте за¬ 
проса, которые можно обработать, определив обработчики событий с помощью 
свойств опзиссезз и опеггог. В обработчике опзиссезз результат операции доступен 
в виде свойства гезиіі; объекта запроса. 

Одно из удобств этого асинхронного прикладного интерфейса заключается в про¬ 
стоте управления транзакциями. При типичном использовании прикладного ин¬ 
терфейса ІпсІехесШВ сначала открывается база данных. Это асинхронная опера¬ 
ция, поэтому по ее выполнении вызывается обработчик опзиссезз. В этом обработ¬ 
чике создается объект транзакции, и затем этот объект используется для поиска 
хранилища или хранилищ объектов, которые предполагается использовать. По¬ 
сле этого производится серия вызовов методов де1:() и риШ хранилищ объектов. 
Они также действуют асинхронно, поэтому непосредственно при их вызове ниче¬ 
го не происходит, но запросы, сгенерированные этими методами деШ и риШ, ав¬ 
томатически будут связаны с объектом транзакции. При необходимости можно 
отменить все операции в транзакции, ожидающие выполнения, и откатить лю¬ 
бые уже выполненные операции вызовом метода аЬог1:() объекта транзакции. Во 
многих других прикладных интерфейсах к базам данных объект транзакции 
обычно имеет метод сотті1:( ), подтверждающий транзакцию. Однако в ІпсІехесШВ 
транзакция подтверждается после выхода из обработчика опзиссезз, создавшего 
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транзакцию, когда броузер вернется в цикл обработки событий, и после выполне¬ 
ния всех операций, запрошенных в транзакции (без запуска новых операций в их 
функциях обратного вызова). Такая схема, на первый взгляд, кажется слишком 
сложной, но в практическом применении она очень проста. При использовании 
прикладного интерфейса ІпсІехесШВ программист вынужден создавать объекты 
транзакций, чтобы получить доступ к хранилищам объектов, но в обычных си¬ 
туациях ему даже не приходится задумываться о транзакциях. 

Наконец, существует один особый вид транзакций, обеспечивающий возмож¬ 
ность работы очень важной части прикладного интерфейса ІпсІехесШВ. Создать 
новую базу данных с использованием интерфейса ІпсІехесШВ АРІ очень просто: 
достаточно выбрать имя и запросить открытие этой базы данных. Но новая база 
данных создается абсолютно пустой, и она совершенно бесполезна, пока в нее не 
будет добавлено одно или более хранилищ объектов (и, возможно, нескольких 
индексов). Создавать хранилища объектов и индексы можно только внутри обра¬ 
ботчика события опзиссезз объекта запроса, возвращаемого методом зеІіѴегзіопО 
объекта базы данных. Метод зеіѴегзіопО позволяет указать номер версии базы 
данных - в обычной ситуации номер версии должен изменяться при каждом из¬ 
менении структуры базы данных. Однако более важно, что метод зеІіѴегзіопО не¬ 
явно запускает специальную транзакцию, позволяющую вызвать метод сгеаіе- 
0Ь]ес1:Зі:оге() объекта базы данных и метод сгеаіеІпйехО хранилища объектов. 

Теперь, получив представление о прикладном интерфейсе ІпсІехесШВ, вы сможете 
самостоятельно разобраться в примере 22.15. Этот пример использует ІпсІехесШВ 
для создания базы данных, отображающей почтовые индексы США в названия го¬ 
родов, и выполнения запросов к ней. Он демонстрирует многие, хотя и не все, ос¬ 
новные особенности ІпсІехесШВ. На момент написания этих строк пример действо¬ 
вал в Гігеіох 4 и СЬготе 11, но из-за того, что спецификация все еще продолжала 
меняться и реализации находились на предварительной стадии разработки, вели¬ 
ка вероятность, что он не будет работать именно так, как описывается здесь, когда 
вы будете читать эти строки. Однако общая структура примера должна сохранить 
свою полезность для вас. Пример 22.15 получился достаточно длинным, но в нем 
имеется большое количество комментариев, которые облегчат его изучение. 

Пример 22.15. База данных ІпдехедБВ с почтовыми индексами США 

<Ю0СТѴРЕ Ыт1> 

<И1:т1> 

<ИеасІ> 

<ІШе>2ірсосІе 0а1аЬазе</1:Ше> 

<зсгір1:> 

// Реализации ІпсІехесЮВ все еще используют префиксы в именах 
ѵаг ІпсІехесЮВ = \л/іпс!о\ѵ. ІпсІехесЮВ || // Использовать стандартный АРІ БД 
\ѵіпсІо\ѵ. тоіІпсІехесЮВ || // Или раннюю версию в Рігеі'ох 

\ѵіпсіохѵ.ѵі/еЬкіІІпсІехесЮВ; // Или раннюю версию в СЬготе 

// В РігеГох не используются префиксы для следующих двух объектов: 
ѵаг ЮВТгапзасііоп = \л/іпсіо\ѵ. ЮВТгапзасііоп || міпсіом. меЬкШОВТгапзасііоп; 
ѵаг ЮВКеуПапде = ѵѵіпсіоѵѵ. ЮВКеуВапде || міпсІоѵі/.меЬкіІ: ЮВКеуПапде; 

// Эта функция будет использоваться для вывода сообщений об ошибках 
Гипсііоп Іодегг(е) { 

сопзоіе. 1од("Ошибка ІпсІехесЮВ " + е.сосіе + ": " + е.теззаде); 

} 
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// Эта функция асинхронно получает объект базы данных (при необходимости 
// создает и инициализирует базу данных) и передает его функции 14). 

^цпсіііоп ѵі/іііЬОВСО { 

ѵаг гециезі: = іпбехесЮВ. орепС'гірсосІез"); // Открыть базу данных гірсосіе 
гециезі:. опеггог = Іодегг; // Выводить сообщения об ошибках 

гециезі.опзиссезз = ^ипсИопС ) { // Или вызвать эту функцию по завершении 

ѵаг сІЬ = геццезТ.гезцІТ; // Результатом запроса является база данных 

// Базу данных можно открыть всегда, даже если она не существует. 

// Мы проверяем версию, чтобы узнать, была ли БД создана и инициализирована. 

// Если нет - это необходимо сделать. Но если БД уже настроена, 

// остается просто передать ее функции 14 ). 

іі" (сІЬ.ѵегзіоп === "1") 14 сІЬ); // Если БД существует, передать ее 14) 

еізе іпі1:с1Ь(с1Ь, О; // Иначе сначала инициализировать ее 

} 

} 

// Принимает почтовый индекс, отыскивает город, которому он принадлежит, 

// и асинхронно передает название города указанной функции. 

^ипсііоп 1оокцрСі1:у(2ір, саІІЬаск) { 
ѵѵі1:Ь0В( ^ипсІііоп(сІЬ) { 

// Создать объект транзакции для этого запроса 

ѵаг Ігапзасііоп = бЬ.1:гапзас1:іоп(["2ірсос1ез"], // Требуемое хранилище 

ЮВТгапзасИоп. ПЕА0_0МІ_Ѵ, // Не обновлять 
0); // Время ожидания не ограничено 

// Получить хранилище объектов из транзакции 
ѵаг оЬіесІіз = 1:гапзасТіоп. оЬ^есЬвТогеС ‘гірсосіез*'); 

// Запросить объект, соответствующий указанному индексу. 

// Строки выше выполнялись синхронно, но эта выполняется асинхронно 
ѵаг гециезі: = оЬіесІіз. деКіір); 

геццезі:.опеггог = Іодегг; // Выводить сообщения об ошибках 

гециезі:.опзиссезз = Типсіііоп() { // Передать результаты этой функции 
// Искомый объект сейчас в свойстве гециезі:. гезиіі: 
ѵаг о^есі; = гециезі:. гезиіі:; 

іТ (оЬ]ес1:) // Если соотв. найдено, передать город и штат функции 
са11Ьаск(оЬ]ес1:. сііу + ", " + оЬ^есІ:.зТаІе); 
еізе // Иначе сообщить о неудаче 

са11Ьаск( "Неизвестный индекс" ); 

} 

}); 

} 

// По указанному названию города отыскивает все почтовые индексы для всех 
// городов (в любом штате) с этим названием (с учетом регистра символов). 

// Асинхронно передает результаты по одному указанной функции 
^цпсіііоп 1оокцр2ірсосІез(сі1:у, саІІЬаск) { 
ѵѵі1:Ь0В(^ипсіііоп(сІЬ) { 

// Как и выше, создаем транзакцию и получаем хранилище объектов 

ѵаг Ігапзасііоп = сІЬ. 1:гапзас1:іоп(["гірсосіез”], ЮВТгапзасИоп. ВЕА0_0МІ_Ѵ, 0); 

ѵаг зіоге = 1: гапзасЫоп .оЬ^ес1:8'І:оге("гірсосіез"); 

// На этот раз нам требуется получить индекс по названиям городов 
ѵаг іпсіех = зіоге. іпсІехС'сШез"); 

// Этот запрос может вернуть несколько результатов, поэтому, чтобы 
// получить их все, следует использовать объект курсора. Чтобы создать 
// курсор, нужно создать объект диапазона, представляющий диапазон ключей 
ѵаг гапде = пем ЮВКеуРапде. опіу(сіііу); // Диапазон с одним ключом 
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// Все, что выше, выполняется синхронно. 

// Теперь нужно запросить курсор, который возвращается асинхронно, 
ѵаг геццезі: = іпбех.орепСцгзог(гапде); // Запросить курсор 
геццезіі.опеггог = Іодегг; // Сообщать об ошибках 

геццезі:. опзцссезз = ТііпсТіопО { // Передать курсор этой функции 
// Этот обработчик событий будет вызван несколько раз, по одному 
// для каждой записи, соответствующей запросу, и еще один раз 
// с пустым курсором, указывающим на окончание результатов, 
ѵаг сцгзог = геццезі:. гезціі: // Курсор в свойстве геццезі:. гезьіі: 

ІГ (!сцгзог) геТцгп; // Нет курсора = нет результатов 

ѵаг оЬіесІ = сцгзог. ѵаіце // Получить совпавшую запись 
са11Ьаск(оЬ]ес1:); // Передать ее указанной функции 

сцгзог. соп1:іпце( ); // Запросить следующую запись 

}; 

}); 

} 

// Эта функция используется обработчиком опсііапде в документе ниже. 

// Она выполняет запрос к БД и отображает результаты 
Гцпсііоп бі5р1ауСі1:у(2ір) { 

1оокцрСі1:у(2ір, ^цпс*іоп(з) { босцтеп1:.де1:Е1етеп1:ВуІб('сііу'). ѵа1це=з; }); 

} 

// Это другая функция, используемая обработчиком опсПапде в документе ниже. 

// Она выполняет запрос к БД и отображает результаты 
Гцпсііоп бізр1ау2ірсобез(сі1:у) { 

ѵаг оцірці: = босцтепі:.де1:Е1етеп1:ВуІб("2ірсобез"); 
оиірці;.іппегНТМБ = "Найденные индексы:"; 

1оокцр2ірсобез(сі1:у, Гцпс1:іоп(о) { 

ѵаг біѵ = босьтеп1.сгеа1:еЕ1етепІ("сііѵ"); 
ѵаг Іехі: = о.гірсобе + ": + о.сііу + ", " + о.зіаіе; 

біѵ. аррепсЮШсі(сіосцтеп1:. сгеа1:еТех1:Мобе(1:ех1:)); 
оцірці:. аррепбСНіІб(біѵ); 

}); 

} 

// Настраивает структуру базы данных и заполняет ее данными, затем передает базу данных 
// функции Г(). Эта функция вызывается функцией мі{ГШВ(), если база данных еще не была 
// инициализирована. Это самая хитрая часть программы, поэтому мы оставили ее напоследок. 
Гцпсііоп іпі1:бЬ(бЬ, Г) { 

// Загрузка информации о почтовых индексах и сохранение ее в базе данных может 
// потребовать некоторого дополнительного времени при первом запуске этого 
// приложения. Поэтому необходимо вывести сообщение, извещающее о выполнении операции, 
ѵаг зШьзІіпе = босцтепі:.сгеаІеЕІетепіС'біѵ"); 

8І:а1:цз1іпе.з1:у1е.сззТех1: = 

"розі1:іоп:Гіхеб; 1еГ1::0рх; 1ор:0рх; ѵѵібІП: 100%;" + 

"соіог іѵѵШе; Ьаскдгоцпб-соіог: Ыаск; Гопі:: Ьоіб 18р1: запз-зегіГ;" + 

"раббіпд: Юрх; "; 

босцтепі:. Ьобу.аррепбСНіІсКзШцзІіпе); 

Гцпсііоп 5Шц5(тзд) { зіаіцзііпе.іппегНТМБ = тзд.ІоЗІгіпдО; }; 

з1;а1;цз( "Инициализация базы данных почтовых индексов"); 

// Единственное место, где можно определить или изменить структуру 
// базы данных ІпбехесЮВ - обработчик опзцсезз запроса зеІѴегзіоп. 
ѵаг геццезі: = 6Ь. зеІѴегзіопС'І"); // Попробовать изменить версию БД 
геццезі.опеггог = зШьз; // Вывести сообщение в случае ошибки 

гедцезі:. опзцссезз = ^ипс*іоп() { // Иначе вызвать эту функцию 
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// База данных почтовых индексов включает единственное хранилище. 

// Оно хранит объекты следующего вида: { 

// гірсобе: "02134", // Отправьте на телепередачу 2оотМ :-) 

// сіТу: "Аіізіоп", 

// зТаТе: "МА", 

// ІаШибе: "42.355147", 

// ІопдШбе: "-71.13164" 

// } 

// 

// Свойство "гірсобе" используется в качестве ключа базы данных 
// Кроме того, создается индекс по названию города 

// Создать хранилище объектов, указав имя хранилища и объект с параметрами, 

// включающий "путь к ключу", определяющий имя свойства-ключа для этого 
// хранилища. (Если опустить путь к ключу, ІпбехесШВ определит свой 
// собственный уникальный целочисленный ключ. ) 
ѵаг зіоге = бЬ.сгеаІеОЬіесіЗТогеС'гірсобез", // имя хранилища 

{ кеуРаТІі: "гірсобе" }); 

// Создать в хранилище объектов индекс по названию города. 

// Строка пути к ключу передается этому методу непосредственно, 

// как обязательный аргумент, а не как свойство объекта с параметрами. 
з*оге. сгеаІеІпбех( "сШез" , "сііу"); 

// Теперь необходимо загрузить информацию о почтовых индексах, преобразовать 
// ее в объекты и сохранить эти объекты в созданном выше хранилище. 

// 

// Файл с исходными данными содержит строки следующего вида: 

// 

// 02130,Затаіса Ріаіп,МА.42.309998,-71.11171 
// 02131, Возііпсіаіе, МА, 42.284678, -71.13052 
// 02132, Мез* ВохЬигу, МА, 42.279432,-71.1598 
// 02133,Возіоп,МА,42.338947,-70.919635 
// 02134, АН 5*оп,МА, 42.355147,-71.13164 
// 

// Как ни странно, но почтовая служба США не обеспечивает свободный доступ 
// к этой информации, поэтому мы будет использовать устаревшие данные переписи 
// с сайта: ІлПр://тарріпдІіаскз.сот/2008/04/28/сіѵісзрасе-2ір-собе-ба1:аЬазе/ 

// Для загрузки данных используется объект ХМЕНИрВецііезІ:. 

// Но для обработки данных по мере поступления будут использованы 
// новые события опіоаб и опргодгезз, определяемые спецификацией ХНВ2 
ѵаг хНг = пе\л/ ХМБНІіІірВедиезІ: (); // Объект ХНР для загрузки данных 

хНг.ореп("СЕТ", "гірсосіез.сзѵ"); // НТТР-запрос типа СЕТ для этого ІЖ 
хНг.зепб(); // Запустить немедленно 

хНг.опеггог = з*а1:цз; // Отображать сообщения об ошибках 


1 В 1972-1978 гг. телекомпания АѴСВН-ТѴ в Бостоне выпускала детское телешоу «200М». 
Детям предлагалось после шоу «выключить телевизор и сделать то, о чем рассказыва¬ 
лось в передаче...». Дети, обычно семеро, участвовавшие в шоу, играли в игры, ставили 
пьесы, рассказывали стихи, ставили научные эксперименты, вели беседы на такие те¬ 
мы, как больницы, предрассудки и другие, предлагаемые телезрителями. Передача 
имела призыв со словами: «Напишите на конверте 200М, Зет-Дабл-Оу-М, Бокс 3-5-0, 
Бостон, Масс 0-2-1-3-4 и отправьте его на 200М!». Весь текст проговаривался, кроме ин¬ 
декса, который пропевался. Описание в Википедии: кіір://еп.іѵікіресІіа.огё/іѵікі/200М_ 
(1972_ТѴ_8егіе8). - Прим, перев. 
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ѵаг 1аз1:СГіаг = 0, пцтііпез = 0; // Уже обработанный объем 

// Обрабатывает файл базы данных блоками, по мере загрузки 
хПг.опргодгезз = хГіг.опіоасі = ^ііпстіоп(е) { // Сразу два обработчика! 

// Обработать блок между ІазіСИаг и последним принятым символом 
// перевода строки. (Нам требуется отыскать последний символ 
// перевода строки, чтобы не обработать неполную запись) 
ѵаг ІазіИемИпе = х.Пг. гезропзеТехІ:. 1азТІпбехО^("\п"); 

(ІазіИемИпе > ІазіСНаг) { 

ѵаг сіиіпк = хНг. гезропзеТехТ. зиЬзІ:гіпд(1аз1:СІіаг, ІазіИеиПпе) 

ІазіСИаг = ІазіИемИпе + 1; // Откуда начинать в следующий раз 

// Разбить новый фрагмент на строки 
ѵаг Ііпез = сішпк. зрШ(”\п"); 
пцтііпез += Ііпез. ІепдТІі; 

// Чтобы вставить информацию о почтовом индексе в базу данных, необходимо 
// получить объект транзакции. Все операции добавления объектов 
// в базу данных, выполняемые с использованием этого объекта, 

// будут автоматически подтверждаться после выхода из этой функции, 

// когда броузер вернется в цикл обработки событий. 

// Чтобы создать объект транзакции, следует определить, 

// какие хранилища объектов будут использоваться (у нас имеется всего 
// одно хранилище). Кроме того, требуется сообщить, что будет 
// выполняться не только чтение, но и запись в базу данных: 
ѵаг ігапзасііоп = 6Ь. *гап5асІіоп(["2ірсогіе5 ,, ] І // хранилища 

ЮВТгапзасІііоп. ВЕА0_1ШТЕ); 

// Получить ссылку на хранилище из объекта транзакции 
ѵаг зіоге = ■|:гапзас 1 :іоп.оЬ^ес 1 : 81 :оге(" 2 ірсобез'■): 

// Теперь обойти в цикле строки в файле с почтовыми индексами, 

// создать на их основе объекты и добавить их в хранилище. 

Гог(ѵаг і = 0; і < Ііпез.Іегдііі; і++) { 

ѵаг ^іеібз = 1іпез[і]. 5рШ(”, ");// Значения через запятую 
ѵаг гесогб = { // Сохраняемый объект 

гірсобе: Гіе1бз[0], // Все свойства - строки 

сііу: Гіе1бз[1], 
зіаііе: Тіе1бз[2], 

Іаііішсіе: Тіе1бз[3], 

Іопдііцбе: Гіе1бз[4] 

}; 

// Вся прелесть ІпбехесЮВ АРІ в том, что хранилище 
// объектов *по-настоящему* просто использовать. 

// Следующая строка добавляет запись: 

зіоге. риі:(гесогб); // Или абб(), чтобы избежать затирания 

} 

8ТаТц8( "Инициализация базы данных, загружено записей: 

+ піітііпез + ".''); 

} 

іТ (е.іуре == "Іоаб") { 

// Если это было последнее событие Іоаб, значит, мы отправили в базу 
// данных все сведения о почтовых индексах. Но, так как мы только 
// что обработали порядка 40000 записей, они все еще могут записываться 
// в хранилище. Поэтому мы выполним простой запрос. Когда он будет 
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// успешно выполнен, это послужит сигналом, что база данных готова 
// к работе, и наконец можно удалить строку сообщения и вызвать 
// функцию 1=0, которая так давно была передана функции ѵѵііііОВО 
1оокирСі1:у( "02134", І'ііпсІіопСз) { // Аіізіоп, МА 
босіітепі:. Ьобу. гетоѵеСІйІсКзІаІіізІіпе); 

}); 

} 

} 

} 

} 

</зсгір1:> 

</Ііеаб> 

<Ьобу> 

<р>Введите почтовый индекс, чтобы отыскать город :</р> 

Индекс: <іпріі1: опсІіапде="бізр1ауСі1:у(1:Іііз.ѵа1це)"х/іпріі1:> 

Город: <оііІріі1: ісі='сі1:у"></ои1:ри1:> 

</сІіѵ> 

<біѵ> 

<р>Введите название города (с учетом регистра символов, без названия штата), 
чтобы отыскать все города с этим названием и их почтовые индексы:</р> 

Город: <іпріі1: опсИапде="сіізр1ау2ірсос1ез(ІИіз.ѵа1ііе)"></іпрц1:> 

<біѵ ісІ=" 2 ірсосІез"></біѵ> 

</біѵ> 

<рхі>Этот пример работает только в Рігеі'ох 4 и СІіготе 11.</і></р> 

<рхі>Выполнение первого запроса может занять длительное время.</і></р> 

<рхі>Вам может потребоваться запустить Сііготе с ключом --ітІітіІесІ-дііо'Ііа-Рог- 
іпсІехеббЬ</іх/р> 

</Ьос1у> 

</И1т1> 

22.9. Веб-сокеты 

В главе 18 демонстрируется, как клиентские сценарии на языке ^ѵабсгірі; могут 
взаимодействовать с серверами по сети. Все примеры в этой главе используют 
протокол НТТР, а это означает, что все они ограничены исходной природой про¬ 
токола НТТР: этот протокол, не имеющий информации о состоянии, состоит из 
запросов клиента и ответов сервера. Протокол НТТР фактически является узко¬ 
специализированным сетевым протоколом. Более универсальные сетевые взаи¬ 
модействия через Интернет (или через локальные сети) часто реализуются с ис¬ 
пользованием долгоживущих соединений и обеспечивают двунаправленный об¬ 
мен сообщениями через ТСР-сокеты. Довольно небезопасно предоставлять кли¬ 
ентскому сценарию на языке ^ѵа8сгір1 доступ к низкоуровневым ТСР-сокетам, 
однако спецификация «ДѴеЬ8оскеі; АРІ» определяет безопасную альтернативу: 
она позволяет клиентским сценариям создавать двунаправленные соединения 
с серверами, поддерживающими протокол веб-сокетов. Это существенно упроща¬ 
ет решение некоторых сетевых задач. 

Прикладной интерфейс веб-сокетов удивительно прост в использовании. Снача¬ 
ла необходимо создать сокет с помощью конструктора ИеЬЗоскеШ: 

ѵаг зоскеі: = пе\л/ МеЬЗоскеІіС'ѵѵз://^.ехатріе. сот: 1234/ гезоіі гее"); 
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Протокол веб-сокетов 

Чтобы использовать веб-сокеты в сценариях на языке ^ѵабсгірі, достаточ¬ 
но будет освоить клиентский прикладной интерфейс веб-сокетов, описы¬ 
ваемый здесь. Не существует эквивалентного серверного прикладного ин¬ 
терфейса для создания серверов с поддержкой веб-сокетов; в этом разделе 
будет представлен простой пример сервера, основанного на использовании 
интерпретатора Иосіе (раздел 12.2) и сторонней серверной библиотеки под¬ 
держки веб-сокетов. Клиент и сервер взаимодействуют через долгоживу¬ 
щие ТСР-сокеты, следуя правилам, определяемым протоколом веб-соке- 
тов. Мы не будем рассматривать здесь особенности протокола, но следует 
отметить, что протокол веб-сокетов спроектирован очень аккуратно, бла¬ 
годаря чему веб-серверы могут легко обрабатывать НТТР-соединения и со¬ 
единения на основе веб-сокетов через один и тот же порт. 

Веб-сокеты получили широкую поддержку среди производителей броузе¬ 
ров. В ранней, предварительной версии протокола веб-сокетов была обна¬ 
ружена серьезная брешь в системе безопасности, поэтому на момент напи¬ 
сания этих строк в некоторых броузерах поддержка веб-сокетов была от¬ 
ключена, - до стандартизации безопасной версии протокола. В Гігеіох 4, 
например, может потребоваться явно включить поддержку веб-сокетов, от¬ 
крыв страницу аЬоиІ:ісоп^ід и установив переменную «пеІѵѵогклѵеЪзоскеі;. 
оѵеггісіе-зесигііу-Ыоск» в значение Ігие. 


Аргументом конструктора ІлІеЬЗоскеіО является ІШЬ-адрес, в котором использу¬ 
ется протокол мз:// (или мзз:// - в случае с безопасными соединениями, по анало¬ 
гии с ИИрз://). ІЖЬ-адрес определяет имя хоста, к которому выполняется под¬ 
ключение, и может также определять порт (по умолчанию веб-сокеты использу¬ 
ют тот же порт, что и протоколы НТТР и НТТР8) и путь или ресурс. 

После создания сокета в нем обычно регистрируются обработчики событий: 

зоскеі. опореп = Іішсііоп(е) { /* Соединение установлено. */ }; 

зоскеі.опсіозе = Іипсііоп(е) { /* Соединение закрыто. */ }; 
зоскеі:. опе г го г = Іііпсііоп(е) { /* Что-то пошло не так! */ }; 
зоскеі. оптеззаде = Іітсііоп(е) { 

ѵаг теззаде = е.сіаіа; /* Сервер послал сообщение. */ 

}; 

Чтобы отправить данные серверу через сокет, следует вызвать метод зепс!( ) сокета: 
зоскеі .зепб("Привет, сервер!"); 

Текущая версия прикладного интерфейса веб-сокетов поддерживает только тек¬ 
стовые сообщения и отправляет их в виде строк в кодировке ІЛТ-8. Однако теку¬ 
щая версия спецификации протокола веб-сокетов включает поддержку двоич¬ 
ных сообщений, и будущие версии прикладного интерфейса, возможно, будут 
обеспечивать обмен двоичными данными с сервером. 

По окончании взаимодействия с сервером сценарий может закрыть веб-сокет вы¬ 
зовом его метода с1озе(). 
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Веб-сокеты являются двунаправленными, и единственное соединение, установ¬ 
ленное через веб-сокет, может использоваться клиентом и сервером для передачи 
сообщений друг другу в любой момент времени. Это взаимодействие не обязатель¬ 
но должно иметь форму запросов и ответов. Каждая служба, основанная на веб-со¬ 
кетах, будет определять собственный «подпротокол» передачи данных между 
клиентом и сервером. С течением времени эти «подпротоколы» могут развиться, 
и вам может потребоваться реализовать клиенты и серверы, поддерживающие не¬ 
сколько версий подпротокола. К счастью, протокол веб-сокетов включает меха¬ 
низм, дающий возможность договориться о выборе подпротокола, который под¬ 
держивается и клиентом, и сервером. Конструктору ИеЬЗоскеіО можно передать 
массив строк. Сервер получит его в виде списка подпротоколов, поддерживаемых 
клиентом. Сервер выберет подпротокол, поддерживаемый им, и отправит его об¬ 
ратно клиенту. После установления соединения клиент сможет определить, какой 
подпротокол можно использовать, проверив свойство ргоіосоі объекта АѴеЬбоскеі. 

В разделе 18.3 описывается прикладной интерфейс объекта ЕѵепІЗоигсе и демон¬ 
стрируется его применение на примере реализации клиента и сервера чата. Веб¬ 
сокеты еще больше упрощают реализацию подобных приложений. В приме¬ 
ре 22.16 демонстрируется очень простой клиент чата: он напоминает пример 18.15, 
но использует веб-сокеты для двунаправленного обмена сообщениями вместо 
объекта ЕѵепІЗоигсе для приема сообщений и ХМЫН1:1:рРедиез1: - для отправки. 

Пример 22.16 . Клиент чата на основе веб-сокетов 

<зсгірі> 

міпбом. опіоаб = ГыпсИопО { 

// Позаботиться о некоторых деталях пользовательского интерфейса 
ѵаг піск = рготрК" Введите свой псевдоним"); // Получить псевдоним 
ѵаг іпрьі = сіоситепі: . де1:Е1етепі:ВуІсІ("іприі:"); // Отыскать поле ввода 
іпрііі. Госьз(); // Установить фокус ввода 

// Открыть веб-сокет для отправки и приема сообщений в чате. 

// Предполагается, что НТТР-сервер, откуда загружается сценарий, также 
// поддерживает веб-сокеты, и для связи с ним используется то же имя хоста 
// и номер порта, но вместо протокола Пир:// используется протокол ѵіз:// 
ѵаг зоскеі = пеѵѵ МеЬЗоскеІ("\л/з://" + Іосаііоп.Нозі + "/"); 

// Так через веб-сокет принимаются сообщения с сервера 
зоскеі .оптеззаде = Гипсііоп(еѵепі) { // Вызывается при получении сообщения 
ѵаг тзд = еѵепі.сіаіа; // Получить текст из объекта события 

ѵаг побе = босшпепІ.сгеаІеТехІМобе(тзд); // Создать текстовый узел 
ѵаг біѵ = сіоситепі. сгеаІеЕ1етепІ("сііѵ"); // Создать элемент <с!іѵ> 
біѵ.аррепбСПіІб(побе); // Добавить текстовый узел 

сіоситепі. Ьобу. іпзегіВеГоге(сііѵ, іприі:); // и вставить біѵ перед полем ввода 

іприі:. зсго11Іп1:оѴіеѵѵ(); // Гарантировать видимость элемента іприі 

} 

// Так через веб-сокет отправляются сообщения на сервер 
іпрііІ.опсНапде = ТііпсііопО { // Когда пользователь нажмет клавишу Епіег 
ѵаг тзд = піск + ": " + іприі:.ѵаіие; // Имя пользователя и текст 
зоскеі.зепб(тзд); // Отправить через сокет 

іприі.ѵаіііе = ""; // Подготовиться к вводу следующего сообщения 

} 

}; 

</зсгірі> 

<!-- Пользовательский интерфейс - это единственное поле ввода --> 
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Глава 22. Прикладные интерфейсы НТМІ.5 


<!-- Новые сообщения в чате будут появляться перед этим элементом --> 

<іпріі1: ісі="іприі: *' з1:у1е="ѵ\/ісИ:Іі: 100%*’/> 

В примере 22.17 демонстрируется реализация сервера чата, основанного на веб-со; 
кетах, которая предназначена для работы под управлением интерпретатора Кобе 
(раздел 12.2). Сравните этот пример с примером 18.17, чтобы увидеть, что веб-со- 
кеты упрощают не только клиентскую часть реализации чата, но и серверную. 

Пример 22,17. Сервер чата на основе веб-сокетов, выполняющийся 

под управлением Иоде 

/* 

* Этот серверный сценарий на языке ЭаѵаЗсгірІ: предназначен для выполнения 

* под управлением МосЫЗ. Он играет роль сервера веб-сокетов, реализованного поверх 

* НТТР-сервера с использованием внешней библиотеки ѵѵеЬзоскеІ: , которую можно найти 

* по адресу: Н1:1:р5://ді1:НцЬ.сот/тік5адо/пос1е-\л/еЬ5оске1:-зегѵег/. При обращении 

* к ресурсу "/" он возвращает НТМІ_-файл клиента чата. В ответ на обращение к любому 

* другому ресурсу возвращается код 404. Сообщения принимаются посредством протокола 

* веб-сокетов и просто рассылаются по всем активным соединениям. 

*/ 

ѵаг ППр = геццігеС ‘ітр’ ); // Использовать НТТР-сервер в Иосіе 

ѵаг юз = геццігеС’ѵѵеЬзоскеІ-зегѵег' ); // Использовать внешнюю библиотеку 

// Прочитать исходный файл с реализацией клиента чата. Используется ниже, 
ѵаг сііепіііі = гецціге( 'Гз'). геабРіІеЗупсС'ѵѵзсПаІсІіепІ:. ШтГ'); 

// Создать НТТР-сервер 

ѵаг НПрзегѵег = пеѵѵ НПр. Зегѵег(); 

// Когда НТТР-сервер получит новый запрос, будет вызвана эта функция 
НПрзегѵег.опС'гедііезІ:", Гііпсііоп (гедііезТ, гезропзе) { 

// Если запрошен ресурс "/", отправить реализацию клиента чата. 

ІГ (гедііезі:. ц гі === "/") { // Запрошена реализация клиента чата 
гезропзе.\л/гіІеНеаб(200, {"СопІеШі-Туре”: "Нехіі/Іііті"}); 
гезропзе. ѵѵгііеСсІіепІці); 
гезропзе. епсІ(); 

} 

еізе { // В ответ на любой другой запрос отправить код 404 ”N01: РоііпсГ 
гезропзе. \л/гііеНеаб(404): 
гезропзе. епс!(); 

} 

}): 

// Обернуть НТТР-сервер сервером на основе веб-сокетов 
ѵаг ѵѵззегѵег = \л/з.сгеаІе5егѵег({зегѵег: НПрзегѵег}); 

// Вызывать эту функцию при получении новых запросов на соединение 
ѵѵззегѵег.опС'соппесІіоп", І'ііпсІіопСзоскеІ:) { 

зоскеі. зепб("Добро пожаловав в чат."); // Приветствовать нового клиента 
зоскеі. оп("теззаде", ГцпсІіопСтзд) { // Принимать сообщения от клиента 

ѵѵззегѵег. Ьгоабсаз1:(тзд); // И рассылать их всем остальным 

}); 

}); 

// Запустить сервер на порту 8000. Запуск сервера на основе веб-сокетов 
// приводит также к запуску НТТР-сервера. Для его использования подключайтесь 
// по адресу Іт1:1:р://1оса1Ііоз1: :8000/. 
ѵѵззегѵег. 1із1:еп( 8000); 
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Эта часть книги представляет собой справочник по всем классам, свойствам и ме¬ 
тодам базового прикладного программного интерфейса ^ѵабсгірі;. В справочни¬ 
ке описываются следующие классы и объекты, в алфавитном порядке: 


Агдіітепіз 

Аггау 

Вооіеап 

Оаііе 

Еггог 


ЕѵаІЕггог 

Рітсііоп 

61оЬа1 

МаІІі 


МіітЬег 31: гіпд 

ОЬіесІ: ЗупІахЕггог 

ВапдеЕггог ТуреЕггог 

ВеІ'егепсеЕггог ЦІРІЕггог 
ВедЕхр 


Справочные страницы с описанием методов и свойств классов отсортированы по 
их полным именам, включающим имена определяющих их классов. Например, 
чтобы найти метод гер1асе() класса Зігіпд, его следует искать как Зігіпд. гер1асе(), 
а не просто геріасе. 

В базовом ^ѵаЗсгірі; определены некоторые глобальные функции и свойства, та¬ 
кие как еѵа1() и МаІ\І. Формально они являются свойствами глобального объекта. 
Однако у глобального объекта нет имени, поэтому в справочнике они перечисле¬ 
ны по их неполным именам. Для удобства полный набор глобальных функций 
и свойств базового ^ѵаЗсгірі объединен в специальную справочную статью «С1о- 
Ъаі» (хотя объекта или класса с таким именем нет). 



Справочник по базовому іаѵаБсгірІ 


агдиѵпеп{$[] 

массив аргументов функции 

Синтаксис 

агдитепііз 

Описание 

Массив агдитепІізП определен только внутри тела функции, где он ссылается на объ¬ 
ект Агдитепііз этой функции. Данный объект имеет нумерованные свойства и пред¬ 
ставляет собой массив, содержащий все переданные функции аргументы. Идентифи¬ 
катор агдитепііз - это, по существу, локальная переменная, автоматически объявляе¬ 
мая и инициализируемая внутри каждой функции. Она ссылается на объект Агдитепііз 
только внутри тела функции и не определена в глобальном программном коде. 

См. также 

Агдитепііз; глава 8 

АгдитепіБ 

аргументы и другие свойства функции ОЬ]есІ->Агдитепі$ 

Синтаксис 

агдитепііз 

агдитепІізИ 

Элементы 

Объект Агдитепііз определен только внутри тела функции. Хотя формально он не явля¬ 
ется массивом, у него есть нумерованные свойства, действующие как элементы мас¬ 
сива, и свойство ІепдІіП, значение которого равно количеству элементов массива. Его 
элементами являются значения, переданные функции в качестве аргументов. Эле¬ 
мент 0 - это первый аргумент, элемент 1 - второй аргумент и т. д. Все значения, пере¬ 
данные в качестве аргументов, становятся элементами массива в объекте Агдитепііз 
независимо от того, присвоены ли этим аргументам имена в объявлении функции. 

Свойства 

саііее Ссылка на выполняемую в данный момент функцию. 

ІепдІіП Количество аргументов, переданных функции, и количество элементов 
массива в объекте Агдитепііз. 
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Описание 

Когда вызывается функция, для нее создается объект Агдитепііз, и локальная перемен¬ 
ная агдитепііз автоматически инициализируется ссылкой на объект Агдитепііз. Основ¬ 
ное назначение объекта Агдитепііз - предоставить возможность определить, сколькб 
аргументов передано функции, и обратиться к неименованным аргументам. В допол¬ 
нение к элементам массива и свойству ІепдІП, у объекта Агдитепііз имеется свойство 
саііее, которое позволяет неименованной функции ссылаться на саму себя. 

Для большинства задач объект Агдитепііз можно рассматривать как массив с дополни¬ 
тельным свойством саііее. Однако он не является экземпляром объекта Аггау, а свой¬ 
ство Агдитепііз.ІепдІН не обладает особым поведением, как свойство Аггау. Іепдіііі, и не 
может использоваться для изменения размера массива. 

При выполнении сценария в нестрогом режиме объект Агдитепііз имеет одну очень не¬ 
обычную особенность. Когда у функции есть именованные аргументы, элементы мас¬ 
сива в объекте Агдитепііз являются синонимами локальных переменных, содержащих 
аргументы функции. Объект Агдитепііз и имена аргументов предоставляют два раз¬ 
личных способа обращения к одной и той же переменной. Изменение значения аргу¬ 
мента с помощью имени аргумента изменяет значение, извлекаемое через объект 
Агдитепііз, а изменение значения аргумента через объект Агдитепііз изменяет значение, 
извлекаемое по имени аргумента. 

См. также 

РипсИоп; глава 8 

Агдитепіз.саііее не доступно в строгом режиме 

функция, выполняемая в данный момент 

Синтаксис 

агдитепііз.саііее 

Описание 

агдитепііз.саііее ссылается на функцию, выполняющуюся в данный момент. Данный 
синтаксис предоставляет неименованной функции возможность сослаться на себя. 
Это свойство определено только внутри тела функции. 

Пример 

// Неименованный литерал функции использует свойство саііее 
// для ссылки на себя, чтобы произвести рекурсивный вызов 
ѵаг ^асТо гіаі = ^ипс1:іоп( х) { 

Н (х < 2) геііи гп 1; 

еізе геТигп х * агдитепііз. са11ее(х1); 

} 

ѵаг у = -Рас1іогіа1(5); // Вернет 120 

Агдитеп{$.ІепдіН 

число аргументов, переданных функции 

Синтаксис 

агдитепііз. ІепдіН 





Аггау 
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Описание 

Свойство Іепдіііі объекта Агдитепііз возвращает количество аргументов, переданных те¬ 
кущей функции. Это свойство определено только внутри тела функции. 

Обратите внимание: это свойство возвращает фактическое количество переданных 
аргументов, а не ожидаемое. О количестве аргументов в объявлении функции гово¬ 
рится в справочной статье Рипсіііоп. Іепдіііі. Кроме того, следует отметить, что это свой¬ 
ство не обладает особым поведением, как свойство Аггау. ІепдІіИ. 

Пример 

// Использовать объект Агдцтепііз, чтобы проверить, верное ли количество 
// аргументов было передано 
^ипсіііоп сИеск(агдз) { 

ѵаг асішаі = агдз. Іепдіііі; // Фактическое количество аргументов 

ѵаг ехресТесІ = агдз. саііее. Іепдіііі; // Ожидаемое количество аргументов 
іР (асіюаі != ехресРесі) { // Если не совпадают, сгенерировать исключение 

іііігсм пеѵѵ Еггог("Неверное число аргументов: ожидается: " + 

ехресііесі + фактически передано " + асішаі); 

} 

} 

// Функция, демонстрирующая использование функции, приведенной выше 
Рцпсіііоп Р(х, у, г) { 

с!іеск( агдцтепііз); // Проверить правильность количества аргументов 
геііцгп х + у + г; // Выполнить оставшуюся часть функции обычным образом 

} 

См. также 

Аггау. Іепдіііі, Рипсіііоп.Іепдіііі 

Аггау 

встроенная поддержка массивов ОЬ]ес(->Аггау 

Конструктор 

пем АггауО 
пем Аггау (размер) 

п еѵі кггау(элементО, элементі . элемент) 

Аргументы 

размер 

Желаемое количество элементов в массиве. Длина возвращаемого массива (Іепдіііі) 
равна аргументу размер . 

элементО, ... элемент 

Список аргументов из двух и более произвольных значений. Когда конструктор 
Аггау() вызывается с этими аргументами, элементы только что созданного массива 
инициализируются указанными значениями, а свойство Іепдіііі становится рав¬ 
ным количеству аргументов. 

Возвращаемое значение 

Вновь созданный и инициализированный массив. Когда конструктор АггауО вызыва¬ 
ется без аргументов, он возвращает пустой массив, свойство Іепдіііі которого равно 0. 
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При вызове с одним числовым аргументом конструктор возвращает массив с указан¬ 
ным количеством неопределенных элементов. При вызове с любыми другими аргу¬ 
ментами конструктор инициализирует массив значениями аргументов. Когда конст-’ 
руктор АггауО вызывается как функция (без оператора пем), он ведет себя точно так" 
же, как при вызове с оператором пем. 

Исключения 

НапдеЕггог Когда конструктору Аггау() передается один целый аргумент размер , ге¬ 

нерируется исключение НапдеЕггог, если размер отрицателен или пре¬ 
вышает 2 32 -1. 

Синтаксис литерала 

ЕСМА8сгірі ѵЗ определяет синтаксис литералов для массивов. Программист может 
создавать и инициализировать массив, заключая список выражений, перечисленных 
через запятые, в квадратные скобки. Значения этих выражений становятся элемен¬ 
тами массива. Например: 

ѵаг а = [1, 1: гие, 'аЬс' ]; 
ѵаг Ь = [а[0], а[0]*2. Цх)]; 

Свойства 

ІепдІіР Целое, доступное для чтения и записи, определяет количество элемен¬ 

тов массива или, если элементы массива расположены не непрерывно, 
число, на единицу большее индекса последнего элемента массива. Из¬ 
менение этого свойства укорачивает или расширяет массив. 

Методы 

Методы еѵегу (), Ш1:ег(), ^огЕасІіО, іпсІехОЦ), 1аз*1пс1ехОЦ), тар(), гесІисеО, гесІисеРідІгІ:() 
и зоте() впервые появились в ЕСМА8сгірі 5, но были реализованы всеми броузерами, 
кроме ІЕ, до утверждения стандарта Е85. 

с о п с аі: () Присоединяет элементы к массиву. 

еѵегу() Проверяет, возвращает ли предикат значение Іігие для каждого эле¬ 

мента массива. 

Ш1:ег() Возвращает массив элементов, удовлетворяющих требованиям функ¬ 

ции-предиката. 

^огЕасИ() Вызывает функцию для каждого элемента массива. 

іпсІехОіЧ ) Выполняет поиск элемента в массиве. 

]оіп() Преобразует все элементы массива в строки и выполняет их конкате¬ 

нацию. 

1аз*ІпсІехОЦ ) Выполняет поиск в массиве в обратном порядке. 
тар() Вычисляет элементы нового массива из элементов данного массива. 

рор() Удаляет элемент из конца массива, 

р изР () Помещает элемент в конец массива. 

гесІисеО Вычисляет значение на основе элементов данного массива. 

геРисеРИдРЦ) Выполняет свертку массива справа налево. 

ге ѵе гзе() Меняет порядок следования элементов в массиве на противоположный. 

зііИі:( ) Сдвигает элементы к началу массива. 

з1ісе( ) Возвращает под массив массива. 




Аггау.сопсаЮ 
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зоте() 

зогі;() 

зрІісеО 

1 :оІ_оса1еЗі:гіпд() 
1 :оЗі:гіпд() 
ипзІіі^ІіС) 


Проверяет, возвращает ли предикат значение Іігііе хотя бы для одно¬ 
го элемента массива. 

Сортирует элементы массива. 

Вставляет, удаляет или заменяет элементы массива. 

Преобразует массив в локализованную строку. 

Преобразует массив в строку. 

Вставляет элементы в начало массива. 


Описание 


Массивы - это базовое средство Лѵабсгірі, подробно описанное в главе 7. 


См. также 

Глава 7 


Аггау.сопса1() 

выполняет конкатенацию массивов 

Синтаксис 

массив.сопсаЦзначение, ...) 

Аргументы 

значение, ... Любое количество значений, присоединяемых к массиву. 

Возвращаемое значение 

Новый массив, образуемый присоединением к массиву каждого из указанных аргу¬ 
ментов. 

Описание 

Метод сопсаі:() создает и возвращает новый массив, являющийся результатом присо¬ 
единения каждого из его аргументов к массиву. Этот метод не изменяет массив. Если 
какие-либо из аргументов сопсаШ сами являются массивами, то присоединяются 
элементы этих массивов, а не сами массивы. 

Пример 

ѵаг а = [1,2,3]; 

а.сопса1:(4, 5) // Вернет [1,2,3,4,5] 

а.сопсаТ([4,5]); // Вернет [1,2,3,4,5] 

а.сопсаТ([4,5],[6,7]) // Вернет [1,2,3,4,5,6,7] 
а.сопса1:(4, [5, [6,7]]) // Вернет [ 1,2,3,4, 5, [6,7]] 

См. также 

Аггау.]оіп(), Аггау.ризІіО, Аггау. зрІісеО 

Аггау.еѵегуО ЕстаБсгірІ: 5 

проверяет, возвращает ли предикат значение Ігие для каждого элемента массива 

Синтаксис 

массив, еѵегу (предикат) 
массив, еѵегу (предикат, о) 
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Аргументы 

предикат Функция-предикат, выполняющая проверку элементов массива 
о Необязательное значение ІіИіз, передаваемое предика ту. 

4 

Возвращаемое значение 

Іігие, если предикат вернет Іігие (или какое-либо истинное значение) для каждого эле¬ 
мента массива , или Шзе, если предикат вернет Шзе (или какое-либо ложное значение) 
хотя бы для одного элемента массива. 

Описание 

Метод еѵегуО проверяет соответствие всех элементов массива некоторому условию. 
Он обходит в цикле элементы массива в порядке возрастания индексов и для каждого 
элемента вызывает указанную функцию предикат. Если предикат вернет І'аізе (или лю¬ 
бое другое значение, которое в логическом контексте преобразуется в значение І'аізе), 
метод еѵегуО прекратит выполнение цикла и немедленно вернет ^аізе. Если для каж¬ 
дого элемента предикат вернет Іігие, то и метод еѵегуО вернет Іігие. При применении 
к пустому массиву еѵегуО возвращает Іігие. 

Для каждого индекса і в массиве функция предикат вызывается с тремя аргументами: 

предикат{массив[ і ], і, массив) 

Возвращаемое значение функции предиката интерпретируется как логическое значе¬ 
ние. Значение Іігие и все истинные значения указывают, что элемент массива прошел 
проверку или соответствует условию, описываемому этой функцией. Значение І'аізе 
или любое ложное значение означает, что элемент массива не прошел проверку. 

Дополнительные сведения приводятся в статье Аггау.'ГогЕасйО. 

Пример 

[1.2.3] . еѵе гу ( І'ипсіііоп ( х) { геііи гп х < 5; }) // => Іігие: все элементы < 5 

[1.2.3] . еѵе гу( ^ипсіііоп (х) { геііигп х < 3; })//=> ^аізе : не все элементы < 3 

П.еѵегу^ипсІііопСх) { геііигп Шзе; }); // => Іігие: всегда Іігие для [] 

См. также 

Аггау.-ГШегО, Аггау.-ГогЕасЮ, Аггау.зотеО 

Аггау.Шег() ЕСМА$сгірі 5 

возвращает элементы массива, пропущенные предикатом 

Синтаксис 

массив, тар (предикат) 
массив.№р(предикат о) 

Аргументы 

предикат Функция, которая определяет, может ли данный элемент массива быть 
включен в возвращаемый массив. 

о Необязательное значение ІіИіз, передаваемое предикату. 

Возвращаемое значение 

Новый массив, содержащий только те элементы массива , для которых предикат вернет 
Іігие (или истинное значение). 
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Описание 

Метод Ш1:ег( ) создает новый массив и заполняет его элементами массива , для которых 
функция предикат вернет Іігие (или истинное значение). Метод 1"іПіег() не изменяет сам 
массив (хотя функция предикат может делать это). 

Метод Шііег() выполняет цикл по индексам массива в порядке возрастания и вызыва¬ 
ет предикат для каждого элемента. Для каждого индекса і функция предикат вызыва¬ 
ется с тремя аргументами: 

предикат(массив[ і ], і , массив) 

Если предикат вернет Іігие или истинное значение, элемент с индексом і в массиве будет 
добавлен во вновь созданный массив. После того как метод ЕШегО проверит все эле¬ 
менты массива , он вернет новый массив. 

Дополнительные сведения приводятся в статье Аггау.'ГогЕасІіО* 

Пример 

[1,2,3]. Т : і11;ег('Гипс1;іоп(х) { геііигп х > 1; }); // => [2,3] 

См. также 

Аггау.еѵегуО, Аггау.-ГогЕасІіО, Аггау.іпсІехОІЧ), Аггау.тарО, Аггау.гесІисеО 

Аггау.{огЕасН() ЕСМАБсгір* 5 

вызывает функцию для каждого элемента массива 

Синтаксис 

массив. -ГогЕасй(0 
массив. -ГогЕ ас Іі(^ о) 

Аргументы 

Т Функция, вызываемая для каждого элемента массива, 
о Необязательное значение іііііз, передаваемое функции Т. 

Возвращаемое значение 

Этот метод ничего не возвращает. 

Описание 

Метод 1"огЕасІп() выполняет цикл по индексам массива в порядке возрастания и вызы¬ 
вает функцию /"для каждого элемента. Для каждого индекса і функция /"вызывается 
с тремя аргументами: 

/"( массив [ і ], і , массив ) 

Значение, возвращаемое функцией /", игнорируется. Обратите внимание, что метод 
1"огЕасІ"і() ничего не возвращает. В частности, он не возвращает массив. 

Особенности методов массивов 

Описываемые ниже особенности относятся к методу 1"огЕасИ(), а также к родственным 
ему методам тар(), ЕШегО, еѵегу() и зоте(). 

Каждый из этих методов принимает функцию в первом аргументе и необязательный 
второй аргумент. Если указан второй аргумент о, функция будет вызвана как метод 
объекта о. То есть в теле функции ключевое слово іііііз будет возвращать о. Если вто- 
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рой аргумент не указан, то функция будет вызываться как функция (а не как метод) 
и ключевое слово іііііз в ней будет ссылаться на глобальный объект при выполнении 
в нестрогом режиме или содержать значение пи 11 при выполнении в строгом режиме. 

Каждый из этих методов проверяет длину массива перед началом итераций. Если вы¬ 
зываемая функция добавляет новые элементы в конец массива , цикл по этим новым 
элементам выполняться не будет. Если функция изменяет существующие элементы, 
цикл по которым еще не выполнялся, на следующих итерациях она получит изменен¬ 
ные значения. 

При работе с разреженными массивами эти методы не вызывают функцию для ин¬ 
дексов с фактически отсутствующими элементами. 

Пример 

ѵаг а = [1,2,3]; 

а. ^огЕасИ( ^ипсІііопСх. і, а) { а[і]++; }); //а теперь будет [2,3,4] 

См. также 

Аггау.еѵегуО, Аггау.'РШегО, Аггау. іпсІехОІЧ), Аггау.тарО, Аггау. гесІисеО 

Аггау.ІПСІехО{() ЕСМАБсгірІ 5 

поиск в массиве 

Синтаксис 

массив. іпсІехОІ ''(значение) 
массив. іпсІехО^ (значение, начало) 

Аргументы 

значение Значение, которое ищется в массиве. 

начало Необязательный индекс элемента, с которого следует начать поиск. Если 
отсутствует, по умолчанию поиск начинается с индекса 0. 

Возвращаемое значение 

Первый индекс >= началу в массиве , где элемент === значению , или -1, если такой элемент 
не найден. 

Описание 

Этот метод выполняет поиск в массиве элемента, эквивалентного указанному значению , 
и возвращает индекс первого найденного элемента. Поиск начинается с индекса, опре¬ 
деляемого аргументом начало , или с 0 и продолжается в порядке последовательного уве¬ 
личения индексов, пока не будет найдено соответствие или пока не будут проверены 
все элементы. Для проверки эквивалентности используется оператор ===. Возвращает 
индекс первого соответствующего элемента или -1, если соответствие не было найдено. 

Пример 

['а', ' Ь ’, ’ с' ]. іпсІехОІЧ ' Ь ') // => 1 
['а', 'Ь', 'с']. іпсІехОІ^ 'сГ ) // => -1 
['а', Ь', ’с']. іпсІехОІЧ а', 1) // => -1 

См. также 

Аггау. ІазІІпсІехОІЧ), Зігіпд. ІпсІехОІЧ) 
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Аггау.іоіп() 

выполняет конкатенацию элементов массива в строку 

Синтаксис 

массив.] оіп () 

массив.] оі п ( разделитель) 

Аргументы 

разделитель Необязательный символ или строка, выступающая в качестве разде¬ 
лителя элементов в результирующей строке. Если аргумент опущен, 
используется запятая. 

Возвращаемое значение 

Строка, получающаяся в результате преобразования каждого элемента массива в стро¬ 
ку и объединения их с разделителем между элементами путем конкатенации. 

Описание 

Метод іоіп() преобразует каждый элемент массива в строку и затем выполняет конка¬ 
тенацию этих строк, вставляя указанный разделитель между элементами. Возвраща¬ 
ет полученную строку. 

Обратное преобразование (разбиение строки на элементы массива) можно выполнить 
с помощью метода $рШ() объекта Зіігіпд. Подробности см. в справочной статье Зіігіпд. 
$рШ(). 

Пример 

а = пеѵѵ Аггау(1, 2, 3, "Ііезіііпд"); 

5 = а.іоіп( "+■'); // 5 - это строка ”1+2+3+1:е5І:іпд" 

См. также 

З^гіпд.зрШО 

Аггау.Іа$іІпсІехО{() ЕСМАБсгір* 5 

выполняет поиск в массиве в обратном порядке 

Синтаксис 

массив. ІазТІпсІехОІ ''(значение) 
массив. ІазТІпсІехО {(значение, начало) 

Аргументы 

значение Искомое значение. 

начало Необязательный индекс элемента, с которого следует начать поиск. Если 
отсутствует, по умолчанию поиск начинается с последнего элемента массива . 

Возвращаемое значение 

Наибольший индекс <= начало в массиве , где элемент === значение , или -1, если такой 
элемент не найден. 

Описание 

Этот метод выполняет поиск элемента, эквивалентного указанному значению, в обрат¬ 
ном порядке, последовательно уменьшая индекс, и возвращает индекс первого най- 
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денного элемента. Если указан аргумент начало , его значение будет использоваться 
в качестве начальной позиции поиска; иначе поиск начнется с конца массива. Для 
проверки эквивалентности используется оператор ===. Возвращает индекс первого со¬ 
ответствующего элемента или -1, если соответствие не было найдено. 

4 

См. также 

Аггау.іпсІехОІЧ). Зітіпд.ІазТІпсІехОІЧ) 

Аггау.ІепдіЬ 

размер массива 

Синтаксис 

массив. ІепдііИ 

Описание 

Свойство ІепдІІп массива всегда на единицу больше индекса последнего элемента, оп¬ 
ределенного в массиве. Для традиционных «плотных» массивов, в которых определе¬ 
на непрерывная последовательность элементов и которые начинаются с элемента 0, 
свойство ІепдІіИ указывает количество элементов в массиве. 

Свойство ІепдІіИ инициализируется в момент создания массива с помощью метода- 
конструктора Аггау(). Добавление новых элементов изменяет значение Іепдіііп , если 
в этом возникает необходимость: 

а = пеѵѵ АггауО; // а.ІепдіЬ равно О 

Ь = пеѵѵ Аггау(Ю); // Ь.ІепдІЬ равно 10 

с = п еѵі АггауС'опе”, "Іѵю", "ІЬгее"); // с.ІепдііЬ равно 3 

с[3] = "’Гоиг"; // с. Іепдіііп изменяется на 4 

с[ 10 ] = "ЫазіоІ'Г'; // с.ІепдІЬ становится равным 11 

Чтобы изменить размер массива, можно установить значение свойства Іепдіііп. Если 
новое значение Іепдіііп меньше предыдущего, массив обрезается и элементы в его кон¬ 
це теряются. Если значение Іепдіііп увеличивается (новое значение больше старого), 
массив становится больше, а новые элементы, добавленные в конец массива, получа¬ 
ют значение ипсіеі'іпесі. 

Аггау.тарО ЕСМА$сгірі 5 

вычисляет элементы нового массива из элементов старого массива 

Синтаксис 

массив. тарС/ 1 ) 
массив, тар(Г, о) 

Аргументы 

Т Функция, вызываемая для каждого элемента массива. Возвращаемое ею зна¬ 

чение становится элементом возвращаемого массива. 

о Необязательное значение іііпіз, передаваемое функции Т. 

Возвращаемое значение 

Новый массив, элементы которого были вычислены функцией Т. 
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Описание 

Метод тар() создает новый массив той же длины, что и прежний массив , и вычисляет 
элементы этого нового массива, передавая элементы массива функции Т. Метод тар() вы¬ 
полняет цикл по индексам массива в порядке их возрастания и вызывает /"для каждого 
элемента. Для каждого индекса і функция Т вызывается с тремя аргументам, а ее воз¬ 
вращаемое значение сохраняется в элементе с индексом і вновь созданного массива: 

а[і] = Т{аггау[ і], і, аггау) 

После того как метод тар() передаст каждый элемент массива функции Т и сохранит 
результаты в новом массиве, он вернет новый массив. 

Дополнительные сведения приводятся в статье Аггау. ГогЕасІі(). 

Пример 

[1,2,3].тар( Гипсіііоп(х) { геііи гп х*х; }); // => [1,4,9] 

См. также 

Аггау. еѵегу(), Аггау.'РШегО, Аггау.ГогЕасМО, Аггау. іпсІехОІЧ), Аггау. гесІисе() 


Аггау.рорО 

удаляет и возвращает последний элемент массива 

Синтаксис 

массив. рор() 

Возвращаемое значение 

Последний элемент массива. 


Описание 

Метод рор( ) удаляет последний элемент массива , уменьшает длину массива на единицу 
и возвращает значение удаленного элемента. Если массив уже пуст, рор() его не изме¬ 
няет и возвращает значение ипсіе^іпесі. 


Пример 

Метод рор() и парный ему метод ризР() позволяют реализовать стек, работающий по 
принципу «первым вошел, последним вышел». Например: 


ѵаг зіаск = []; 

// зТаск: 

зіаск. ризІп( 1, 2); 

// зТаск: 

зіаск. рор(); 

// зіаск: 

зіаск. ризР([4,5]); 

// зіаск: 

зіаск. рор() 

// зіаск: 

зіаск. рор(); 

// зіаск: 


[] 

[1,2] Вернет 2 
[1] Вернет 2 
[1,[4,5]] Вернет 2 
[1] Вернет [4,5] 

[] Вернет 1 


См. также 

Аггау. ризІі() 


Аггау.ри$Іі() 

добавляет элементы массива 


Синтаксис 

массив, р и ^{значение, ...) 
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Аргументы 

значение , ... 

Одно или более значений, которые должны быть добавлены в конец массива. 

Возвращаемое значение 

Новая длина массива после добавления в него указанных значений. 

Описание 

Метод ризІі() добавляет свои аргументы в указанном порядке в конец массива. Он из¬ 
меняет существующий массив , а не создает новый. Метод ризІі() и парный ему метод 
рор() используют массив для реализации стека, работающего по принципу «первым 
вошел, последним вышел». Пример - в статье Аггау.рор(). 

См. также 

Аггау.рорО 

Аггау.гесІисе() ЕСМА$сгірі 5 

вычисляет значение из элементов массива 

Синтаксис 

массив, гесі и се (О 

массив. гесІисеС^, начальное_значение) 

Аргументы 

Т Функция, объединяющая два значения (два элемента массива) и возвращающая 
новое значение «свертки». 

начальное_значение 

Необязательное начальное значение свертки массива. Если этот аргумент указан, 
метод гесІисе() будет действовать, как если бы это значение было добавлено в нача¬ 
ло массива. 

Возвращаемое значение 

Значение свертки массива, которое является результатом последнего вызова функ¬ 
ции Т. 

Описание 

Метод гесІисе( ) в первом аргументе принимает функцию Т. Эта функция должна дейст¬ 
вовать как двухместный оператор: она должна принимать два значения, выполнять 
над ними некоторую операцию и возвращать результат. Если массив имеет п элемен¬ 
тов, функция Сбудет вызвана методом гесІисе() для свертки элементов в единственное 
значение п-1 раз. (Возможно, вы уже знакомы с операцией свертки массивов по дру¬ 
гим языкам программирования 1 .) 

При первом вызове функции Т передаются два первых элемента массива. При каждом 
следующем вызове функции Т передаются значение, полученное при предыдущем вы- 


1 В других языках программирования эта операция может называться «іоМ» или 
«ііцесі». Однако в русскоязычной литературе эти термины переводятся как «сверт¬ 
ка». - Прим, перев. 
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зове, и следующий элемент (в порядке возрастания индексов) массива. Возвращаемое 
значение последнего вызова становится возвращаемым значением метода гес1исе(). 

Методу гес1исе() может предаваться второй необязательный аргумент с начальным_зна- 
чением. Если начальное_значение указано, метод гес1исе() будет действовать так, как ес¬ 
ли бы значение этого аргумента было вставлено в начало массива (в реальности массив 
не модифицируется). Иными словами, если метод гесІисеО вызывается с двумя аргу¬ 
ментами, то начальное_значение будет использоваться, как если бы оно было получено 
ранее в результате вызова функции Т. В этом случаев при первом вызове функции Т 
будут переданы начальное_значение и первый элемент массива. Когда передается началь- 
ное_значение> создается свертка из п+1 элементов (п элементов массива плюс начальное_ 
значение ) и функция сбудет вызвана п раз. 

Если массив пуст и начальное_значение не указано, метод гесІисеО возбудит исключение 
ТуреЕггог. Если массив пуст и начальное_значение указано, метод гесІисеО вернет началь- 
ное_значение 9 не вызвав Т ни разу. Если массив имеет единственный элемент и началь- 
ное_значение не указано, метод гесІисеО вернет единственный элемент массива , не вызы¬ 
вая функцию Т. 

Выше говорится о двух аргументах функции Т 9 но в действительности метод гесІисеО 
передает этой функции четыре аргумента. В третьем аргументе передается индекс 
второго аргумента в массиве, а в четвертом - сам массив. Функция Т всегда вызывается 
как функция, а не как метод. 

Пример 

[1,2,3,4]. гесіисе ( І^ипсі:іоп (х.у) { геЕигп х*у; }) // => 24: ((1*2)*3)*4 

См. также 

Аггау.ЕогЕасМО, Аггау.тарО, Аггау. гес1исеПідІгІ:0 

Аггау.гесІисеКідН{() ЕСМАБсгірі 5 

выполняет свертку массива справа налево 

Синтаксис 

массив. гес1исеР1ідІгІ:(0 

массив. гесІисеВідІгІіСА начальное_значение) 

Аргументы 

Т Функция, объединяющая два значения (два элемента массива) и возвращающая 
новое значение «свертки». 

начальное_значение 

Необязательное начальное значение свертки массива. Если этот аргумент указан, 
метод гес1исеРідР1:0 будет действовать, как если бы это значение было добавлено 
в конец массива. 

Возвращаемое значение 

Значение свертки массива, которое является результатом последнего вызова функ¬ 
ции Т. 

Описание 

Метод гесІисеВідІгІ:() действует подобно методу гесІисеО: он вызывает п-1 раз функцию Т 
для свертки п элементов массива в единственное значение. Отличие гесІисеВідІИіО от 
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гес!исе() заключается только в том, что он выполняет обход элементов массива справа 
налево (от больших индексов к меньшим), а не слева направо. Подробности см. в ста¬ 
тье Аггау.гес1исе(). 

Пример 

[2, 10, 60]. гесіисеВідИІ: ( І^ипсі:іоп (х.у) { геііигп х/у }) // => 3: (60/10)/2 

См. также 

Аггау.гесІисеО 

Аггау.геѵегзе() 

изменяет порядок следования элементов в массиве на противоположный 

Синтаксис 

массив. геѵегзе() 

Описание 

Метод геѵегзе() объекта Аггау меняет порядок следования элементов в массиве на про¬ 
тивоположный. Он делает это «на месте», т. е. переупорядочивает элементы указанно¬ 
го массива , не создавая новый. Если есть несколько ссылок на массив , новый порядок 
следования элементов массива будет виден по всем ссылкам. 

Пример 

а = пем Аггау(1. 2, 3); // а[0] == 1, а[2] == 3; 
а.геѵегзеО; // Теперь а[0] == 3, а[2] == 1; 

Аггау.$Н№() 

сдвигает элементы к началу массива 

Синтаксис 

массив. зМіТТО 

Возвращаемое значение 

Бывший первый элемент массива. 

Описание 

Метод 5І"ііТ1:( ) удаляет и возвращает первый элемент массива, смещая все последующие 
элементы на одну позицию вниз для занятия освободившегося места в начале массива. 
Если массив пуст, зИіТТО не делает ничего и возвращает значение ипсІеТіпесІ. Обратите 
внимание: зІііТ1:() не создает новый массив, а непосредственно изменяет сам массив. 

Метод 5ІііТ1:( ) похож на Аггау. рор() за исключением того, что удаление элемента произво¬ 
дится из начала массива, а не с конца. зИіТІ: () часто используется в сочетании с ипзІ'іі'РІіС ). 

Пример 

ѵаг а = [1, [2,3], 4] 

а.зІііНО; // Вернет 1; а = [[2,3], 4] 

а.зІііНО; // Вернет [2,3]; а = [4] 

См. также 

Аггау.рор(), Аггау.ипзИШО 
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Аггау.зІісеО 

возвращает фрагмент массива 

Синтаксис 

массив, з Нее (начало, конец ) 

Аргументы 

начало Индекс элемента массива, с которого начинается фрагмент. Отрицательное 
значение этого аргумента указывает позицию, измеряемую от конца масси¬ 
ва. Другими словами, -1 обозначает последний элемент, -2 - второй элемент 
с конца и т. д. 

конец Индекс элемента массива, расположенного непосредственно после конца фраг¬ 
мента. Если этот аргумент не указан, фрагмент включает все элементы масси¬ 
ва от элемента, заданного аргументом начало , до конца массива. Если этот аргу¬ 
мент отрицателен, позиция элемента отсчитывается от конца массива. 

Возвращаемое значение 

Новый массив, содержащий элементы массива от элемента, заданного аргументом на¬ 
чало , до элемента, определяемого аргументом конец , но не включая его. 

Описание 

Метод з1ісе() возвращает фрагмент, или подмассив, массива. Возвращаемый массив 
содержит элемент, заданный аргументом начало , и все последующие элементы до эле¬ 
мента, заданного аргументом конец 9 но не включая его. Если аргумент конец не указан, 
возвращаемый массив содержит все элементы от элемента, заданного аргументом на¬ 
чало , до конца массива. 

Обратите внимание: з1ісе() не изменяет массив. Для удаления фрагмента массива 
следует использовать метод Аггау.зр1ісе(). 

Пример 

ѵаг а = [1,2,3,4,5]; 
а.5Іісе(0, 3); // Вернет [1,2,3] 

а.зІісе(З); // Вернет [4,5] 
а.з1ісе(1, -1); // Вернет [2,3,4] 

а.з1ісе(-3, -2); // Вернет [3]; в ІЕ 4 работает с ошибкой, возвращая [1,2,3] 

Ошибки 

В Іпіегпеі Ехріогег 4 начало не может быть отрицательным числом. В более поздних 
версиях ІЕ эта ошибка исправлена. 

См. также 

Аггау.зрІісеО 

Аггау.зотеО ЕСМАЗспр* 5 

проверяет, возвращает ли предикат значение Іше 
хотя бы для одного элемента массива 

Синтаксис 

массив, зоте {предикат) 
массив. 5от(предикат, о) 
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Аргументы 

предикат Функция-предикат для проверки элементов массива. 
о Необязательное значение ТПіз в вызове функции предиката. 

Возвращаемое значение 

Тгие, если предикат вернет Іігие (или истинное значение) хотя бы для одного элемента 
массива , или Еаізе, если предикат вернет 1"а1зе (или ложное значение) для всех элементов. 

Описание 

Метод зоте() проверяет, выполняется ли условие хотя бы для одного элемента массива. 
Он выполняет цикл по элементам массива в порядке возрастания индексов и вызывает 
указанную функцию предикат для каждого элемента. Если предикат вернет Тгие (или 
значение, которое в логическом контексте преобразуется в Іігие), то метод зоте() пре¬ 
кратит выполнение цикла и немедленно вернет Іігие. Если все вызовы предиката вернут 
1"а1зе (или значение, которое в логическом контексте преобразуется в 1"а1зе), то метод 
зоте() вернет Шзе. При применении к пустому массиву зоте() вернет Шзе. 

Этот метод очень похож на метод еѵегу(). Дополнительные сведения приводятся 
в статьях.Аггау.еѵегуО и Аггау.-ГогЕасМ(). 

Пример 

[1.2.3] . зоте( І^ипсІііопС х ) { геііигп х > 5; })//=> І^аізе : нет элементов > 5 

[1.2.3] . зоте( І^ипсіііопС х) { геііигп х > 2; })//=> 1:гие : некоторые > 3 

[].зоте( 1^ипс1:іоп( х) { геііигп ггие; }); // => Шзе: всегда Шзе для [] 

См. также 

Аггау.еѵегуО, Аггау.Ш1іег(), Аггау.'ГогЕасМО 

Аггау.зогіО 

сортирует элементы массива 

Синтаксис 

массив, зо г 1і () 
массив, зогіі (огбегТипс) 

Аргументы 

огбегТипс Необязательная функция, определяющая порядок сортировки. 

Возвращаемое значение 

Ссылка на массив. Обратите внимание, что массив сортируется на месте, копия мас¬ 
сива не создается. 

Описание 

Метод зогіі () сортирует элементы массива на месте без создания копии массива. Если 
зогіі () вызывается без аргументов, элементы массива располагаются в алфавитном 
порядке (точнее, в порядке, определяемом используемой в системе кодировкой симво¬ 
лов). Если необходимо, элементы сначала преобразуются в строки, чтобы их можно 
было сравнивать. 

Чтобы отсортировать элементы массива в каком-либо другом порядке, необходимо 
указать функцию сравнения, которая сравнивает два значения и возвращает число, 
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обозначающее их относительный порядок. Функция сравнения должна принимать 
два аргумента, а и 6, и возвращать одно из следующих значений: 

• Отрицательное число, если в соответствии с выбранным критерием сортировки 
значение а «меньше» значения Ь и должно находиться в отсортированном массиве 
перед Ь. 

• Ноль, если аиЬв смысле сортировки эквивалентны. 

• Положительное число, если значение а «больше» значения Ь. 

Следует отметить, что неопределенные элементы при сортировке всегда оказываются 
в конце массива. Это происходит, даже если указана специальная функция сортиров¬ 
ки: неопределенные значения никогда не передаются в заданную функцию огдегТипс. 

Пример 

Следующий фрагмент показывает, как написать функцию сравнения, сортирующую 
массив чисел в числовом, а не в алфавитном порядке: 

// Функция сортировки чисел в порядке возрастания 
^цпсіііоп питЬегогсІег(а, Ь) { геііигп а - Ь; } 
а = п еѵі Аггау(33, 4, 1111, 222); 

а.зогіі(); //Алфавитная сортировка: 1111, 222, 33, 4 

а.зо гі: (питЬе гогсіег); // Числовая сортировка: 4, 33, 222, 1111 

Аггау.5рІісе() 

вставляет, удаляет или замещает элементы массива 

Синтаксис 

массив. 5р1ісе(нача/70, удаляемое_количество, значение, ...) 

Аргументы 

начало 

Элемент массива, с которого следует начать вставку или удаление. 

удаляемое_количество 

Количество элементов, которые должны быть удалены из массива, начиная с эле¬ 
мента, заданного аргументом начало , и включая этот элемент. Чтобы выполнить 
вставку без удаления, в этом аргументе следует передать значение 0. 

значение, 

Ноль или более значений, которые должны быть вставлены в массив, начиная 
с индекса, указанного в аргументе начало. 

Возвращаемое значение 

Массив, содержащий удаленные из массива элементы, если они есть. 

Описание 

Метод 5р1ісе( ) удаляет указанное количество элементов массива, начиная с элемента, 
позиция которого определяется аргументом начало , включая его, и заменяет значе¬ 
ниями, перечисленными в списке аргументов. Элементы массива, расположенные по¬ 
сле вставляемых или удаляемых элементов, сдвигаются и образуют непрерывную по¬ 
следовательность с остальной частью массива. Однако следует заметить, что, в отли¬ 
чие от метода с похожим именем, з1ісе(), метод зр1ісе() непосредственно изменяет 
массив. 
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Пример 

Работу зр1ісе( ) проще всего понять на примере: 
ѵаг а = [1,2,3,4,5,6,7,8] 

а.зр1ісе(1, 2); // Вернет [2.3]; а равно [1.4] 

а.зр1ісе(1, 1); // Вернет [4]; а равно [1] 

а.зр1ісе( 1,0,2.3); // Вернет []; а равно [123] 

См. также 

Аггау.зІісеО 

Аггау.'іоІ.осаІеЗ'ІгіпдО 

преобразует массив в локализованную строку переопределяет ОЬ]есІ.ІоІ.осаІе$Іііпд() 

Синтаксис 

массив. 1:оІ_оса1еЗі:гіпд( ) 

Возвращаемое значение 

Локализованное строковое представление массива. 

Исключения 

ТуреЕггог Если метод вызывается для объекта, не являющегося массивом. 

Описание 

Метод 1:оІ_оса1еЗі:гіпд() массива возвращает локализованное строковое представление 
массива. Это делается путем вызова метода 1:оІ_оса1еЗі:гіпд() для всех элементов масси¬ 
ва и последующей конкатенации полученных строк с использованием символа-разде¬ 
лителя, определяемого региональными параметрами настройки. 

См. также 

АггауЛоЗШпдО, 0Ь]ес1:ЛоІ_оса1еЗі:гіпд() 

Аггау.іоЗігіпдО 

преобразует массив в строку переопределяет ОЬ]есі.іо$ігіпд() 

Синтаксис 

массив. 1:оЗі:гіпд() 

Возвращаемое значение 

Строковое представление массива. 

Исключения 

ТуреЕггог Если метод вызывается для объекта, не являющегося массивом. 

Описание 

Метод ТоЗТгіпд( ) массива преобразует массив в строку и возвращает эту строку. Когда 
массив используется в строковом контексте, ^ѵаЗсгірі автоматически преобразует 
его в строку путем вызова этого метода. Однако в некоторых случаях может потребо¬ 
ваться явный вызов 1:оЗі:гіпд(). 
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ІоЗі: г іпд () сначала преобразует в строку каждый элемент (вызывая их методы ІоЗі: гіпд ()). 
После преобразования все элементы выводятся в виде списка строк, разделенных за¬ 
пятыми. Это значение совпадает со значением, возвращаемым методом ]оіп() без ар¬ 
гументов. 

См. также 

Аггау.1:оІ_оса1еЗі:гіпд(), 0Ь]ес1:.1:оЗі:гіпд() 

Аггау.ип5Н№() 

вставляет элементы в начало массива 

Синтаксис 

массив. и пзЫТЦзначение, ...) 

Аргументы 

значение. Одно и более значений, которые должны быть вставлены в начало мас¬ 

сива. 

Возвращаемое значение 

Новая длина массива. 

Описание 

Метод ипзІ'ііІЧО вставляет свои аргументы в начало массива, сдвигая существующие 
элементы к верхним индексам для освобождения места. Первый аргумент ипзНі^О 
становится новым нулевым элементом массива, второй аргумент - новым первым эле¬ 
ментом и т. д. Обратите внимание: ипзІпі^ІіС ) не создает новый массив, а изменяет суще¬ 
ствующий. 

Пример 

Метод ипзМШО часто используется совместно с зИНЧО. Например: 

ѵаг а = []; // а:[] 

а. ипзМіІ^і: (1); // а:[ 1 ] Вернет: 1 

а. ипзМі^ІіС 22); // а: [22,1 ] Вернет: 2 

а.зМНО: // а:[ 1 ] Вернет: 22 

а. ипзІтіІ^ІіСЗЗ, [4. 5]); // а: [33, [4, 5], 1 ] Вернет: 3 

См. также 

Аггау. зГііГТ( ) 

Вооіеап 

поддержка логических значений 0Ь]ес1— ^Вооіеап 

Конструктор 

пе\л/ Вооіеап (значение) // Функция-конструктор 
Вооіеап(значеше) // Функция преобразования 

Аргументы 

Значение, которое должно быть сохранено в объекте Вооіеап или преоб¬ 
разовано в логическое значение. 


значение 
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Возвращаемое значение 

При вызове в качестве конструктора (с оператором пе\л/) Воо1еап() преобразует аргумент 
в логическое значение и возвращает объект Вооіеап, содержащий это значение. При 
вызове в качестве функции (без оператора пей) Вооіеап () просто преобразует свой аргу¬ 
мент в элементарное логическое значение и возвращает его. 

Значения О, №N1, пиіі, пустая строка "" и значение ипсіеііпесі преобразуются в Еаізе. Все 
остальные элементарные значения, за исключением Еаізе (но включая строку 'Таізе"), 
а также все объекты и массивы преобразуются в Ігие. 

Методы 

ІоЗігіпдО Возвращает 'Тгие" или Таізе" в зависимости от логического значения, 

представляемого объектом Вооіеап. 

ѵаІиеСТО Возвращает элементарное логическое значение, содержащееся в объек¬ 
те Вооіеап. 

Описание 

Логические значения - это базовый тип данных ^ѵа8сгірі. Объект Вооіеап представ¬ 
ляет собой «обертку» вокруг логического значения. Объектный тип Вооіеап в основ¬ 
ном существует для предоставления метода ІоЗігіпдО, который преобразует логиче¬ 
ские значения в строки. Когда метод 1оЗі:гіпд( ) вызывается для преобразования логи¬ 
ческого значения в строку (а он часто вызывается интерпретатором ЛѵаВсгірі неяв¬ 
но), логическое значение преобразуется во временный объект Вооіеап, для которого 
может быть вызван метод і:о8і:гіпд(). 

См. также 

ОЬ^есІ: 

ВооІеап.ІоЗігіпдО 

преобразует логическое значение в строку переопределяет 0Ь]ес1.іо$Ігіпд() 

Синтаксис 

Ь.ІоЗігіпдО 

Возвращаемое значение 

Строка ’Тгие" или Таізе" в зависимости от того, чем является Ь: элементарным логи¬ 
ческим значением или объектом Вооіеап. 

Исключения 

ТуреЕггог Если метод вызывается для объекта, не являющегося объектом Вооіеап. 

ВооІеап.ѵаІиеО^О 

логическое значение объекта Вооіеап переопределяет 0Ь]есі.ѵаІие0{() 

Синтаксис 

6. ѵаІиеСТО 

Возвращаемое значение 

Элементарное логическое значение, которое содержится в Ь, который является объек¬ 
том Вооіеап. 
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Исключения 

ТуреЕггог Если метод вызывается для объекта, не являющегося Вооіеап. 


йаіе 

работа с датами и временем 0Ь]ес1-»0а*е 


Конструктор 

пе\л/ 0а1:е() 

пе\л/ 0а1іе( миллисекунды) 
пе\л/ Оаііе (с трока_даты) 

пе\л/ Оаі :е(год, месяц , день , часы , минуты , секунды , мс) 

Конструктор Оаі:е( ) без аргументов создает объект ОаТе со значением, равным теку¬ 
щим дате и времени. Если конструктору передается единственный числовой аргу¬ 
мент, он используется как внутреннее числовое представление даты в миллисекун¬ 
дах, аналогичное значению, возвращаемому методом деШте(). Когда передается один 
строковый аргумент, он рассматривается как строковое представление даты в форма¬ 
те, принимаемом методом Оаііе. рагзе(). Кроме того, конструктору можно передать от 
двух до семи числовых аргументов, задающих индивидуальные поля даты и времени. 
Все аргументы, кроме первых двух - полей года и месяца, - могут отсутствовать. Об¬ 
ратите внимание: эти поля даты и времени задаются на основе локального времени, 
а не времени ІІТС (ІІпіѵегваІ Соогсііпаіегі Тіше - универсальное скоординированное 
время), аналогичного ОМТ (СгеетѵісЬ Меап Тіте - среднее время по Гринвичу). В ка¬ 
честве альтернативы может использоваться статический метод Оаііе. 1ЛС(). 

Оаііе () может также вызываться как функция (без оператора пе\л/). При таком вызове 
Оаііе() игнорирует любые переданные аргументы и возвращает текущие дату и время. 


Аргументы 

миллисекунды 

строка_даты 

год 

месяц 

день 

часы 

минуты 

секунды 

мс 


Количество миллисекунд между нужной датой и полночью 1 января 
1970 года (ІІТС). Например, передав в качестве аргумента число 5000, 
мы создадим дату, обозначающую пять секунд после полуночи 1 янва¬ 
ря 1970 года. 

Единственный аргумент, задающий дату и (необязательно) время в ви¬ 
де строки. Строка должна иметь формат, понятный для Оаііе. рагзе(). 

Год в виде четырех цифр. Например, 2001 для 2001 года. Для совмести¬ 
мости с более ранними реализациями ^ѵа8сгірі к аргументу добавля¬ 
ется 1900, если значение аргумента находится между 0 и 99. 

Месяц, заданный в виде целого от 0 (январь) до 11 (декабрь). 

День месяца, заданный в виде целого от 1 до 31. Обратите внимание, 
что наименьшее из значений этого аргумента равно 1, а остальных ар¬ 
гументов - 0. Необязательный аргумент. 

Часы, заданные в виде целого от 0 (полночь) до 23 (11 часов вечера). 
Необязательный аргумент. 

Минуты в часах, указанные в виде целого от 0 до 59. Необязательный 
аргумент. 

Секунды в минутах, указанные в виде целого от 0 до 59. Необязатель¬ 
ный аргумент. 

Миллисекунды в секунде, указанные в виде целого от 0 до 999. Необя¬ 
зательный аргумент. 
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Методы 

У объекта ОаТе нет доступных для записи или чтения свойств; вместо этого доступ 
к значениям даты и времени выполняется через методы. Большинство методов объек¬ 
та Бате имеют две формы: одна для работы с локальным временем, другая - с универ-» 
сальным временем (ІІТС или СМТ). Если в имени метода присутствует строка «ІІТС», 
он работает с универсальным временем. Эти пары методов указываются в приведен¬ 
ном далее списке вместе. Например, обозначение де1:[1ЛС]0ау() относится к двум мето¬ 
дам: деЮауО и де1:1ЛС0ау(). 

Методы объекта Эа1:е могут вызываться только для объектов типа Эа1:е и генерируют 
исключение Туре Е г го г, если вызывать их для объектов другого типа. 

де1:[ІІТС]0аі:е( ) 

Возвращает день месяца из объекта Баіе в соответствии с локальным или универ¬ 
сальным временем. 

де1:[(ЛС]0ау() 

Возвращает день недели из объекта ОаТе в соответствии с локальным или универ¬ 
сальным временем. 

де1:[(ЯС]Ри11Ѵеаг() 

Возвращает год даты в полном четырехзначном формате в локальном или универ¬ 
сальном времени. 

де1:[1ЯС]Ноигз() 

Возвращает поле часов в объекте ОаТе в локальном или универсальном времени. 

де!:[1ЛС]Мі11ізесопс1з() 

Возвращает поле миллисекунд в объекте Баіе в локальном или универсальном 
времени. 

де1:[ІЯС]Міпи1:е5() 

Возвращает поле минут в объекте ОаТе в локальном или универсальном времени. 

де!:[1ЛС]Моп1:Іі() 

Возвращает поле месяца в объекте 0а1:е в локальном или универсальном времени. 

де1:[ІІТС]ЗесопсІз( ) 

Возвращает поле секунд в объекте 0а1:е в локальном или универсальном времени. 

деШте() 

Возвращает внутреннее представление (миллисекунды) объекта Эаііе. Обратите 
внимание: это значение не зависит от часового пояса, следовательно, отдельный 
метод де1:ІЛСТіте() не нужен. 

деШтеіопеОРРзеІіО 

Возвращает разницу в минутах между локальным и универсальным представле¬ 
ниями даты. Обратите внимание: возвращаемое значение зависит от того, действу¬ 
ет ли для указанной даты летнее время. 

де1:Уеаг() 

Возвращает поле года в объекте Эаііе. Признан устаревшим, рекомендуется вместо 
него применять метод де!:Ри11Уеаг(). 

зе1:[1ЛС]0а1:е() 

Устанавливает день месяца в Оаііе в соответствии с локальным или универсаль¬ 
ным временем. 
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зе1:[ІІТС]Ри11Уеаг() 

Устанавливает год (и, возможно, месяц и день) в йаііе в соответствии с локальным 
или универсальным временем. 

зе1;[ІІТС]Ноигз() 

Устанавливает час (и, возможно, поля минут, секунд и миллисекунд) в йаііе в соот¬ 
ветствии с локальным или универсальным временем. 

зе1:[ІІТС]Мі11ізесопс1з( ) 

Устанавливает поле миллисекунд в йаііе в соответствии с локальным или универ¬ 
сальным временем. 

зе1:[ІІТС]Міпиі:ез() 

Устанавливает поле минут (и, возможно, поля секунд и миллисекунд) в 0а1:е в со¬ 
ответствии с локальным или универсальным временем. 

зе1:[ІІТС]Моп1:Іі() 

Устанавливает поле месяца (и, возможно, дня месяца) в Ѵаіе в соответствии с ло¬ 
кальным или универсальным временем. 

зе1;[ІІТС]Зесопс1з() 

Устанавливает поле секунд (и, возможно, поле миллисекунд) в йаііе в соответствии 
с локальным или универсальным временем. 

зеШте() 

Устанавливает поля объекта йаііе в соответствии с миллисекундным форматом. 

зе1:Уеаг() 

Устанавливает поле года объекта йаііе. Признан устаревшим, вместо него рекомен¬ 
дуется использовать зе1:Ри11Уеаг(). 

1:о0а1:еЗі:гіпд() 

Возвращает строку, представляющую дату из йаііе для локального часового пояса. 

ІіоОМТЗі: гіпд( ) 

Преобразует йаііе в строку, беря за основу часовой пояс СМТ. Признан устаревшим, 
вместо него рекомендован метод ІіоІІТСЗі:гіпд( ). 

1:оІ303і:гіпд() 

Преобразует йаііе в строку, используя стандарт 180-8601, объединяющий формат 
представления даты/времени и ІІТС. 

Ис^ЗСМО 

Сериализует объект йаііе в формат ^(Ж с помощью метода ІіоІЗОЗігіпдО. 
1:оІ_оса1е0а1:еЗі:гіпд() 

Возвращает строку, представляющую дату из 0а1:е в локальном часовом поясе в со¬ 
ответствии с локальными соглашениями по форматированию дат. 

1:оІ_оса1еЗі:гіпд() 

Преобразует 0а1:е в строку в соответствии с локальным часовым поясом и локаль¬ 
ными соглашениями о форматировании дат. 

1:оІ_оса1еТітеЗі:гіпд() 

Возвращает строку, представляющую время из Оаіе в локальном часовом поясе на 
основе локальных соглашений о форматировании времени. 

1:оЗі:гіпд() 

Преобразует йаііе в строку в соответствии с локальным часовым поясом. 
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ѣоТітеЗі: гіпд( ) Возвращает строку, представляющую время из йаііе в локальном часо¬ 
вом поясе. 

1оІЛС8ігіпд( ) Преобразует йаііе в строку, используя универсальное время. 
ѵа1ие0^( ) Преобразует объект йаііе в его внутренний миллисекундный формат. 

Статические методы 

В дополнение к перечисленным методам экземпляра в объекте йаііе определены два 
статических метода. Эти методы вызываются через сам конструктор Эа1:е(), а не через 
отдельные объекты Эаііе: 

Эаііе . поѵ/( ) Возвращает текущее время в миллисекундах с начала эпохи. 

йаІіе.рагзеО Анализирует строковое представление даты и времени и возвращает 

внутреннее представление этой даты в миллисекундах. 

Эаііе . ІІТС () Возвращает представление указанной даты и времени ІІТС в миллисе¬ 

кундах. 

Описание 

Объект йа1:е - это тип данных, встроенный в язык ^ѵаВсгірі. Объекты йаііе создаются 
с помощью представленного ранее синтаксиса пей/ йа1:е(). 

После создания объекта йаііе можно воспользоваться его многочисленными метода¬ 
ми. Многие из методов позволяют получать и устанавливать поля года, месяца, дня, 
часа, минуты, секунды и миллисекунды в соответствии либо с локальным временем, 
либо с временем ІІТС (универсальным, или СМТ). Метод ІоЗі:гіпд( ) и его варианты 
преобразуют даты в понятные для восприятия строки. деІТіте( ) и зеШте() преобразу¬ 
ют количество миллисекунд, прошедших с полуночи (СМТ) 1 января 1970 года, во 
внутреннее представление объекта Эаііе и обратно. В этом стандартном миллисекунд¬ 
ном формате дата и время представляются одним целым, что делает дату очень про¬ 
стой арифметически. Стандарт ЕСМАВсгірі требует, чтобы объект йаііе мог предста¬ 
вить любые дату и время с миллисекундной точностью в пределах 100 миллионов 
дней до и после 01.01.1970. Этот диапазон равен ±273 785 лет, поэтому ^ѵа8сгірі-часы 
будут правильно работать до 275 755 года. 

Пример 

Известно множество методов, позволяющих работать с созданным объектом Эаііе: 
сі = п еѵі Ра1:е(); // Получает текущую дату и время 

сіосилпепі: . ѵ\/гіі:е( ' Сегодня: "+Р. 1:оІ_оса1е0а1:е5і:гіпд( ) + ');// Показывает дату 

Роситепі:.\л/гііе (' Время: '+ Р. ІіоІосаІеТітеЗігіпд ()); // Показывает время 

ѵаг РауОШеек = р.деЮауО; // День недели 

ѵаг юеекепр = (РауОШеек == 0) || (РауОШеек == 6); // Сегодня выходной? 

Еще одно типичное применение объекта Эаііе - это вычитание миллисекундного пред¬ 
ставления текущего времени из другого времени для определения относительного ме¬ 
стоположения двух временных меток. Следующий пример клиентского кода показы¬ 
вает два таких применения: 

<зсгірі: 1апдиаде="Раѵа5сгірі:"> 

ІоРау = п еѵі Эаііе(); // Запомнить сегодняшнюю дату 

сіігізіітаз = пе\ѵ Ра1:е(); // Получить дату из текущего года 
сіігізіітаз.зеІМоп1:Н(11); // Установить месяц декабрь... 
сПгізІтаз.зеЮа1:е(25); // и 25-е число 

// Если Рождество еще не прошло, вычислить количество миллисекунд между текущим моментом 
// и Рождеством, преобразовать его в количество дней и вывести сообщение 
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(Іюбау.де1іТіте() < сІігізІітаз.деІіТітеС)) { 
сіі^егепсе = сіігізіітаз.де1іТіте() - Іюбау. де1іТіте(); 
сіі^егепсе = Маіііп. ^1оог(сіі^^егепсе / (1000 * 60 * 60 * 24)); 
сіосилпепі;. \л/гі1:е(' Всего ' + сіі^^егепсе + ' дней до Рождества! <р>'); 

} 

</зсгіріі> 

// ... остальная часть НТМІ_-документа ... 

<зс гірі: 1апдиаде="баѵаЗсгіріі"> 

// Здесь мы используем объекты Оаііе для измерения времени 
// Делим на 1000 для преобразования миллисекунд в секунды 
пои/ = пе\ѵ 0а1іе(); 

сіоситепі:.\л/гі!:е( ’<р>Страница загружалась’ + 

(по\ѵ.де1:Тіте( )-1:ос1ау. деІТіте( ))/1000 + 

'секунд. '); 
ѵзсг ірі> 

См. также 

ОаТе. рагзе(), Оаііе.ІІТС() 

Оа1е.деЮа1е() 

возвращает значение поля дня месяца объекта йаіе 

Синтаксис 

дата. де'ШаіеО 

Возвращаемое значение 

День месяца даты , представляющей собой объект Оаііе, в соответствии с локальным 
временем. Возвращаемые значения могут находиться в интервале между 1 и 31. 

Оаіе.деЮау() 

возвращает значение поля дня недели объекта йаіе 

Синтаксис 

дата. деЮауО 

Возвращаемое значение 

День недели даты 9 представляющей собой объект Оаііе, в соответствии с локальным 
временем. Возвращает числа от 0 (воскресенье) до 6 (суббота). 

Оаіе.деіРиІІѴеагО 

возвращает значение поля года объекта Оаіе 

Синтаксис 

дата. де1:Ри11Ѵеаг() 

Возвращаемое значение 

Год, получаемый, когда дата выражена в локальном времени. Возвращает четыре 
цифры, а не сокращение из двух цифр. 
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Оа*е.де1Ноиг5() 

возвращает значение поля часа объекта йаіе 

Синтаксис 

дата. де1:Ноигз() 

Возвращаемое значение 

Значение поля часа в дате , представляющей собой объект йаііе, в локальном времени. 
Возвращаемое значение находится в диапазоне между 0 (полночь) и 23 (11 часов ве¬ 
чера). 

Оаіе.деІМіІІізесопсІзО 

возвращает значение поля миллисекунд объекта йаіе 

Синтаксис 

дата. деШПізесопсІзО 

Возвращаемое значение 

Поле миллисекунд в дате , представляющей собой объект 0а1:е, вычисленное в локаль¬ 
ном времени. 

Оаіе.деІМіпиіезО 

возвращает значение поля минут объекта йаіе 

Синтаксис 

дата. деШгш1:ез() 

Возвращаемое значение 

Поле минут в дате, представляющей собой объект ОаТе, вычисленное в локальном вре¬ 
мени. Возвращаемое значение может принимать значения от 0 до 59. 

ОаІе.деІМопіН() 

возвращает значение поля месяца объекта йаіе 

Синтаксис 

дата. деТМопТ^ () 

Возвращаемое значение 

Поле месяца в дате, представляющей собой объект Оаіе, вычисленное в локальном вре¬ 
мени. Возвращаемое значение может принимать значения от 0 (январь) до 11 (де¬ 
кабрь). 

Оа{е.деІ$есопсІ5() 

возвращает значение поля секунд объекта йаіе 

Синтаксис 

дата. де1:8есопс1$() 
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Возвращаемое значение 

Поле секунд в дате , представляющем собой объект йаііе, в локальном времени. Возвра¬ 
щаемое значение может принимать значения от 0 до 59. 

ОаІе.деІТіте() 

возвращает значение даты в миллисекундах 

Синтаксис 

дата.деШтеО 

Возвращаемое значение 

Миллисекундное представление даты , представляющей собой объект Оаіе, т.е. число 
миллисекунд между полночью 01.01.1970 и датой/временем, определяемыми датой . 

Описание 

Метод деШте( ) преобразует дату и время в одно целое значение. Это удобно, когда тре¬ 
буется сравнить два объекта Эаііе или определить время, прошедшее между двумя да¬ 
тами. Обратите внимание: миллисекундное представление даты не зависит от часово¬ 
го пояса, поэтому отсутствует метод де1:ІІТСТіте(), дополняющий данный. Не путайте 
метод деШтеО с методами деЮауО и деЮаіеО, возвращающими, соответственно, день 
недели и день месяца. 

Методы 0а1:е.рагзе() и ОаІе.ІІТСО позволяют преобразовать спецификацию даты и вре¬ 
мени в миллисекундное представление, обходя избыточное создание объекта 0а1:е. 

См. также 

0а1:е, 0а1:е.рагзе(), Оаіе.зеШтеО, Эаііе. 1ЛС( ) 

Оа1е.деіТіте2опеО№е(() 

определяет смещение относительно СМТ 

Синтаксис 

дата. деШтеіопеОІ^зеІ: () 

Возвращаемое значение 

Разница в минутах между временем по Гринвичу (СМТ) и локальным временем. 

Описание 

Функция деШгпеіопеОІ^зеШ возвращает разницу в минутах между универсальным 
и локальным временем, сообщая, в каком часовом поясе выполняется ^ѵа8сгірі-код 
и действует ли (или будет ли действовать) летнее время для указанной даты. 

Возвращаемое значение измеряется в минутах, а не в часах, поскольку в некоторых 
странах имеются часовые пояса, не занимающие целого часового интервала. 

ОаІе.деШТСОаІе() 

возвращает значение поля дня месяца объекта йаіе (универсальное время) 

Синтаксис 

дата. деІІЛСОаІеО 
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Возвращаемое значение 

День месяца (значение между 1 и 31), полученный при вычислении даты в универ¬ 
сальном времени. 

Оаіе.деШТСОауО 

возвращает значение поля дня недели объекта йаіе (универсальное время) 

Синтаксис 

дата. де1:ІІТС0ау() 

Возвращаемое значение 

День недели, получаемый, когда дата выражена в универсальном времени. Возвра¬ 
щаемые значения могут находиться в интервале между 0 (воскресенье) и 6 (суббота). 

ОаІе.деШТСРиІІѴеаг() 

возвращает значение поля года объекта йаіе (универсальное время) 

Синтаксис 

дата. де1:ІІТСРіі11Ѵеаг() 

Возвращаемое значение 

Год, получаемый, когда дата вычисляется в универсальном времени. Возвращаемое 
значение - четырехзначный номер года, а не сокращение из двух цифр. 

Оаіе.деіІІТСНоигзО 

возвращает значение поля часов объекта йаіе (универсальное время) 

Синтаксис 

дата. де1:1ЛСНоигз() 

Возвращаемое значение 

Поле часов для даты , вычисленное в универсальном времени. Возвращаемое значе¬ 
ние - целое между 0 (полночь) и 23 (11 часов вечера). 

ОаІе.деШТСМіІІі$есопсІ$() 

возвращает значение поля миллисекунд объекта йаіе (универсальное время) 

Синтаксис 

дата. де1:ІІТСМі11ізесопс1з() 

Возвращаемое значение 

Поле миллисекунд для даты , выраженное в универсальном времени. 

Оаіе.деШТ С М і п и!ез() 

возвращает значение поля минут объекта йаіе (универсальное время) 

Синтаксис 

дата. де1:ІІТСМіпи1:ез() 
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Возвращаемое значение 

Поле минут для даты , вычисленное в универсальном времени. Возвращает целое меж¬ 
ду 0 и 59. 

ОаІе.деШТСМопІІі() 

возвращает значение поля месяца года объекта йаіе (универсальное время) 

Синтаксис 

дата. де11ІТСМоп1:М() 

Возвращаемое значение 

Месяц года, получающийся, когда дата вычислена в универсальном времени. Возвра¬ 
щает целое между 0 (январь) и 11 (декабрь). Обратите внимание: объект йаііе обознача¬ 
ет первый день месяца цифрой 1, но первому месяцу года соответствует цифра 0. 

Оа1е.де11ІТС5есопсІ5() 

возвращает значение поля секунд объекта йаіе (универсальное время) 

Синтаксис 

дата.де1;ІІТСЗесопс1з() 

Возвращаемое значение 

Поле секунд даты , вычисленное в универсальном времени. Возвращает целое между 0 
и 59. 

Оаіе.деіѴеагО устарел 

возвращает значение поля года объекта йаіе 

Синтаксис 

дата. де1:Уеаг() 

Возвращаемое значение 

Поле года для указанного даты , представляющей собой объект Оаіе, минус 1900. 

Описание 

Метод де1Ѵеаг() возвращает поле года для указанного объекта Оаіе минус 1900. Со¬ 
гласно спецификации ЕСМАВсгірі ѵЗ, этот метод не является обязательным в совмес¬ 
тимых реализациях ^ѵаВсгірі; используйте вместо него метод деТРи11Уеаг(). 

Оа1е.по\л/() ЕСМАБсгірі 5 

возвращает текущее время в миллисекундах 

Синтаксис 

ОаІе.помО 

Возвращаемое значение 

Текущее время в миллисекундах, прошедшее с полуночи 1 января 1970 года по Грин¬ 
вичу. 
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Описание 

До выхода спецификации ЕСМАВсгірі 5 этот метод можно было реализовать следую¬ 
щим образом: 

Оаііе . поѵу/ = іипсІіоп() { геііигп (пеѵѵ 0а1:е()).де1:Тіте(); } 

См. также 

Оаііе, Оаііе. деШтеО 

Оа1е.раг$е() 

синтаксический разбор строки даты/времени 

Синтаксис 

Оаііе. рагзе( дата) 

Аргументы 

дата Строка для разбора, содержащая дату и время. 

Возвращаемое значение 

Количество миллисекунд между указанными датой/временем и полночью 1 января 
1970 года по Гринвичу. 

Описание 

Метод Оаііе.рагзе() - это статический метод объекта Оаііе. Метод Оаііе.рагзе() принима¬ 
ет один строковый аргумент, анализирует дату, содержащуюся в строке, и возвраща¬ 
ет ее в виде числа миллисекунд, прошедших с начала эпохи. Это возвращаемое значе¬ 
ние может использоваться непосредственно для создания нового объекта Оаііе или для 
установки даты в существующем объекте Оаііе с помощью Оаііе. зеШтеО. 

Стандарт ЕСМАВсгірі 5 требует, чтобы этот метод мог разбирать строки, возвращае¬ 
мые методом Оаііе.1іоІ303іігіпд(). В ЕСМАВсгірі 5 и более ранних версиях специфика¬ 
ции требовалось также, чтобы этот метод мог разбирать строки, возвращаемые мето¬ 
дами ІіоЗіігіпдО и 1іоІІТСЗіігіпд(). 

См. также 

Оаііе, Оаііе. зеШтеО, Оаііе.ІіоІЗОЗіігіпдО, Оаііе.ІіоЗіігіпдО 

Оаіе.5еЮаІе() 

устанавливает поле дня месяца объекта йаіе 

Синтаксис 

дата. зеІіОаІі е(день_месяца) 

Аргументы 

день_месяца Целое между 1 и 31, используемое как новое значение (в локальном 

времени) поля дня месяца объекта дата . 

Возвращаемое значение 

Миллисекундное представление измененной даты. До выхода стандарта ЕСМА8сгірі 
этот метод ничего не возвращал. 
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Оаіе.зеіРиІІѴеагО 

устанавливает поля года и, если явно указано, месяца и дня месяца объекта йаіе 

Синтаксис 

дата. зеТ Ри1ІУеаг( год) 

дата. зе1:Ри11Уеаг(гс)л, месяц) 

дата. зе1:Ри11Уеаг(гол, месяц, день) 

Аргументы 

гол Год, выраженный в локальном времени, который должен быть установлен 

в дате. Этот аргумент должен быть целым, включающим век, например 
1999; не может быть сокращением, таким как 99. 

месяц Необязательное целое между 0 и 11, используемое для установки нового 
значения поля месяца (в локальном времени) для даты. 

день Необязательное целое между 1 и 31, используемое как новое значение поля 
дня месяца для даты (в локальном времени). 

Возвращаемое значение 

Внутреннее миллисекундное представление измененной даты. 


Оаіе.зеіНоигзО 

устанавливает значения полей часов, минут, секунд и миллисекунд объекта йаіе 

Синтаксис 

д а та. з еі: Н о и г з ( часы) 

дата.зеХНоигз(часы, минуты) 

дата.зеХ\\оигз(часы, минуты, секунды) 

дата, земнойгз(чась/, минуты, секунды, миллисекунды) 


Аргументы 


часы 

минуты 


секунды 


миллисекунды 


Целое между 0 (полночь) и 23 (11 часов вечера) локального времени, 
устанавливаемое в качестве нового значения часов в дате. 

Необязательное целое между 0 и 59, используемое в качестве нового 
значения поля минут в дате (в локальном времени). Этот аргумент не 
поддерживался до выхода стандарта ЕСМАВсгірі. 

Необязательное целое между 0 и 59. Представляет собой новое значе¬ 
ние поля секунд в дате (в локальном времени). Этот аргумент не под¬ 
держивался до выхода стандарта ЕСМА8сгірі. 

Необязательное целое между 0 и 999, используемое как новое значе¬ 
ние поля миллисекунд в дате (в локальном времени). Этот аргумент не 
поддерживался до выхода стандарта ЕСМАВсгірі. 


Возвращаемое значение 

Миллисекундное представление измененной даты. До выхода стандарта ЕСМА8сгірі 
этот метод ничего не возвращал. 
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Оа{е.5еІМіІІі$есопсІ5() 

устанавливает значение поля миллисекунд объекта йаіе 

Синтаксис 

да та. зе1:Мі11ізесопс1з( миллисекунды) 

Аргументы 

миллисекунды Поле миллисекунд, выраженное в локальном времени, для установки 

в дате . Этот аргумент должен быть целым между 0 и 999. 

Возвращаемое значение 

Миллисекундное представление измененной даты. 

Оаіе.зеІМіпиіезО 

устанавливает значения полей минут, секунд и миллисекунд объекта йаіе 

Синтаксис 

дата. зеТМіпиІіез {минуты) 

дата. зеТМіпиІіез (минуты, секунды) 

дата.$еХМіг\иХе$(минуты, секунды , миллисекунды) 

Аргументы 

минуты Целое между 0 и 59, устанавливаемое в качестве значения минут (в ло¬ 

кальном времени) в дате, представляющей собой объект йаііе. 

секунды Необязательное целое между 0 и 59, используемое как новое значение 

поля секунд даты (в локальном времени). Этот аргумент не поддержи¬ 
вался до выхода стандарта ЕСМАВсгірі. 

миллисекунды Необязательное целое между 0 и 999, представляющее собой новое 

значение (в локальном времени) поля миллисекунд даты . Этот аргу¬ 
мент не поддерживался до выхода стандарта ЕСМА8сгірі. 

Возвращаемое значение 

Миллисекундное представление измененной даты. До выхода стандарта ЕСМАВсгірі 
этот метод ничего не возвращал. 

Оаіе.$еіМоп{Ь() 

устанавливает поля месяца и дня месяца объекта Оаіе 

Синтаксис 

дата. зе1:Моп1:М (месяц) 
дата. зе1:Моп1:Іі (месяц, день) 

Аргументы 

месяц Целое между 0 (январь) и 11 (декабрь), устанавливаемое в качестве значе¬ 
ния поля месяца (в локальном времени) в дате, представляющей собой объ¬ 
ект Оаіе. Обратите внимание: месяцы нумеруются, начиная с 0, а дни в ме¬ 
сяце - с 1. 
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день Необязательное целое между 1 и 31, используемое как новое значение 

поля дня месяца в дате (в локальном времени). Этот аргумент не под¬ 
держивался до выхода стандарта ЕСМА8сгірі. 

Возвращаемое значение 

Миллисекундное представление измененной даты. До выхода стандарта ЕСМАЗсгірі 
этот метод ничего не возвращал. 

ОаІе.5еІ$есопсІ5() 

устанавливает значения полей секунд и миллисекунд объекта Оаіе 

Синтаксис 

дата. зеІіЗесопсІз (секунды) 

дата. зеХ^>есоп6з(секунды, миллисекунды) 

Аргументы 

секунды Целое между 0 и 59, устанавливаемое как значение секунд в дате, 

представляющей собой объект Эаііе. 

миллисекунды Необязательное целое между 0 и 999, используемое как новое значе¬ 
ние поля миллисекунд в дате (в локальном времени). Этот аргумент не 
поддерживался до выхода стандарта ЕСМАЗсгірі. 

Возвращаемое значение 

Миллисекундное представление измененной даты. До выхода стандарта ЕСМАЗсгірі 
этот метод ничего не возвращал. 

Оаіе.БеіТітеО 

устанавливает значение даты в миллисекундах 

Синтаксис 

дата. зеТТіт ^{миллисекунды) 

Аргументы 

миллисекунды Количество миллисекунд между требуемыми датой/временем и пол¬ 
ночью 1 января 1970 года по Гринвичу. Подобное миллисекундное зна¬ 
чение может быть также передано конструктору Эа1:е( ) и получено при 
вызове методов ОаІе.ІЛСО и Ра1:е.рагзе(). Представление даты в милли¬ 
секундном формате делает ее независимой от часового пояса. 

Возвращаемое значение 

Аргумент миллисекунды . До выхода стандарта ЕСМАЗсгірі метод ничего не возвращал. 

ОаІе.БеШТСОаІеО 

устанавливает значение поля дня месяца объекта Оаіе (универсальное время) 

Синтаксис 

дата. зеІУТСОаІ :е(день_месяца) 
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Аргументы 

день_месяца День месяца, выраженный в универсальном времени и устанавливае¬ 
мый в дате. Этот аргумент должен быть целым между 1 и 31. 

Возвращаемое значение 

Внутреннее миллисекундное представление измененной даты. 

ОаІе.БеІІІТСРиІІѴеагО 

устанавливает значения полей года, месяца 
и дня месяца объекта Оаіе (универсальное время) 

Синтаксис 

дата. зеІіІЛСРиІІУеаг (год) 

дата. зеІІЛ СР иІІУеаг (год, месяц) 

дата. зеІіІЛСРиІІУеаг (год, месяц, день) 

Аргументы 

год Год, выраженный в универсальном времени, для установки в дате. Этот ар¬ 

гумент должен быть целым, включающим век, например 1999, а не сокра¬ 
щением, как 99. 

месяц Необязательное целое между 0 и 11, используемое как новое значение поля 
месяца даты (в универсальном времени). Обратите внимание: месяцы нуме¬ 
руются, начиная с 0, тогда как нумерация дней месяцев начинается с 1. 

день Необязательное целое между 1 и 31; используется как новое значение 
(в универсальном времени) поля «день месяца» в дате. 

Возвращаемое значение 

Внутреннее миллисекундное представление измененной даты. 

ОаІе.БеІІІТСНоигБО 

устанавливает значения полей часов, минут, секунд и миллисекунд 
объекта Раіе (универсальное время) 

Синтаксис 

да та. з еТ ІЛ С И о и г з (часы) 
дата.зеІіІЛСНоигзСчась/, минуты) 
дага.зеІіІЛСНоигзСчась/, минуты, секунды) 
дата.$еТ[)ТСНоиг$(часы, минуты, секунды, миллисекунды) 

Аргументы 

часы Значение поля часов, выраженное в универсальном времени, для установки 

в дате. Этот аргумент должен быть целым между 0 (полночь) и 23 (11 часов 
вечера). 

минуты Необязательное целое между 0 и 59, используемое как новое значение поля 
минут в дате (в универсальном времени). 

секунды Необязательное целое между 0 и 59, используемое как новое значение поля 
секунд в дате (в универсальном времени). 
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миллисекунды Необязательное целое между 0 и 999, используемое как новое значе¬ 
ние поля миллисекунд в дате (в универсальном времени). 

Возвращаемое значение 

Внутреннее миллисекундное представление измененной даты. 

Оаіе.5еШТСМіІІІ5есопсІ5() 

устанавливает значение поля миллисекунд объекта Оаіе (универсальное время) 

Синтаксис 

да та. зе1:ІЛСМі11і5есопсІ5( миллисекунды) 

Аргументы 

миллисекунды Значение поля миллисекунд, выраженное в универсальном времени, 

для установки в дате . Этот аргумент должен быть целым между 0 и 999. 

Возвращаемое значение 

Внутреннее миллисекундное представление измененной даты. 

Оаіе.БеШТСМіпиіеБО 

устанавливает значения полей минут, секунд и миллисекунд 
объекта Оаіе (универсальное время) 

Синтаксис 

д а та . 5 е 1: ІЯ С М і п и 1 е з (ми ну ты ) 

дата.зеХ\)ТСШпиХев(минуты, секунды) 

дага.зе1:ІЛСМіпи1:ез(мшугь/ , секунды, миллисекунды) 

Аргументы 

минуты Значение поля минут в универсальном времени для установки в дате . 

Этот аргумент должен принимать значение между 0 и 59. 

секунды Необязательное целое между 0 и 59, используемое как новое значение 

поля секунд в дате (в универсальном времени). 

миллисекунды Необязательное целое между 0 и 999, используемое как новое значе¬ 
ние поля миллисекунд в дате (в универсальном времени). 

Возвращаемое значение 

Внутреннее миллисекундное представление измененной даты. 

Оа1е.5еіІІТСМоіПН() 

устанавливает поля месяца и дня месяца объекта Оаіе (универсальное время) 

Синтаксис 

дата. зеІІЛСМопіІ ^(месяц) 
дата.зеТ[)ТСМопХ\\(месяц, день) 

Аргументы 

месяц Месяц, выраженный в универсальном времени, для установки в дате . Этот 
аргумент должен быть целым между 0 (январь) и 11 (декабрь). Обратите 
внимание: месяцы нумеруются, начиная с 0, а дни в месяце - с 1. 
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день Необязательное целое между 1 и 31, используемое как новое значение поля 
дня месяца в дате (в универсальном времени). 

Возвращаемое значение 

Внутреннее миллисекундное представление измененной даты. 

ОаІе.зеІІІТСбесопсІБО 

устанавливает значения полей секунд и миллисекунд объекта Оаіе (универсальное время) 

Синтаксис 

дата. зеІІЛСЗесопсІз (секунды) 

дата. зеІІЛСЗесопсІз (секунды, миллисекунды) 

Аргументы 

секунды Значение поля секунд в универсальном времени для установки в дате. 

Этот аргумент должен быть целым между 0 и 59. 

миллисекунды Необязательное целое между 0 и 999, используемое как новое значе¬ 
ние поля миллисекунд даты (в универсальном времени). 

Возвращаемое значение 

Внутреннее миллисекундное представление измененной даты. 

Оа1е.$е!Уеаг() устарел 

устанавливает поле года объекта Оаіе 

Синтаксис 

дата. зеІУеа г (год) 

Аргументы 

год Целое, устанавливаемое как значение поля года (в локальном времени) в дате , 
представляющей собой объект Раііе. Если это значение находится между 0 и 99, 
к нему добавляется 1900, и оно рассматривается как год между 1900 и 1999. 

Возвращаемое значение 

Миллисекундное представление измененной даты. До выхода стандарта ЕСМАбсгірі 
этот метод ничего не возвращал. 

Описание 

Метод зеІУеагО устанавливает поле года в указанном объекте Раііе, особым образом 
обрабатывая интервал времени между 1900 и 1999 годами. 

Согласно спецификации ЕСМАбсгірі ѵЗ, этот метод не является обязательным в со¬ 
вместимых реализациях ^ѵабсгірі; вместо него рекомендован метод зеІРиІІУеагО. 

Оа1е.1оОа1е5ігіпд() 

возвращает дату из объекта Оаіе в виде строки 

Синтаксис 

дата. ІоОаІеЗігіпдО 
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Возвращаемое значение 

Зависящее от реализации и понятное человеку строковое представление даты (без 
времени), представленной объектом дата в локальном времени. 

См. также 

0аі:е.1:оЗі:гіпд(), 0а1:е.1:оТітеЗі:гіпд() 

Оа1е.1оСМТ$1гтд() устарел 

преобразует объект Раіе в строку универсального времени 

Синтаксис 

дата. 1:оСМТЗі:гіпд() 

Возвращаемое значение 

Строковое представление даты и времени, указанное в объект едата. Перед преобразо¬ 
ванием в строку, дата переводится из локального времени во время по Гринвичу. 

Описание 

Метод ІіоОМТЗі: г іпд( ) признан устаревшим, вместо него рекомендуется использовать 
аналогичный метод Ра1:е.1:оІЯСЗі:гіпд(). 

Согласно спецификации ЕСМАЗсгірі ѵЗ совместимые реализации ^ѵабсгірі больше 
не обязаны предоставлять этот метод; используйте вместо него метод ТоІЛСЗТгіпдС ). 

См. также 

Ра1:е.1:оІЛСЗі:гіпд() 

0а*е/ІоІ505*гіпд() ЕСМАЗсгірі 5 

преобразует объект Оаіе в строку в формате 1508601 

Синтаксис 

дата. ІоІЗОЗіхіпдО 

Возвращаемое значение 

Строковое представление даты , отформатированное в соответствии со стандартом 
180-8601 и выраженное как точная комбинация даты и времени в ІІТС с указанием 
часового пояса «2». Возвращаемая строка имеет следующий формат: 

уууу-тт-сІсЛ'М :тт:зз. ззз2 

См. также 

Ра1:е.рагзе(), Ра1:е.1:оЗі:гіпд() 

0а1е.1о150Г\І() ЕСМАЗсгірі: 5 

сериализует объект Оаіе в формат 350И 

Синтаксис 

дата.ТоЛ§Ои{ключ) 
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Аргументы 

ключ Метод 1:с^30М() не использует этот аргумент и просто передает его функции 

^(ЖзІігіпдНуО. 

Возвращаемое значение 

Строковое представление даты, полученное вызовом метода 1;оІ303Тгіпд( ). 

Описание 

Для преобразования объекта дате в строку этот метод использует функцию ^(Ж зігіп- 
дНуО- Он не предназначен для широкого использования. 

См. также 

ОаТе .1:оІ808і:гіпд( ), ^(ЖзІігіпдНуО 

Оа*е.*оІосаІеОа*е5*гіпд() 

возвращает дату из йаіе в виде строки с учетом региональных настроек 

Синтаксис 

дата .1:оІ_ос аІеРаІіеЗі: г іпд() 

Возвращаемое значение 

Зависящее от реализации и понятное человеку строковое представление даты (без 
времени) из объекта дата , выраженное в локальном времени и отформатированное 
в соответствии с региональными настройками. 

См. также 

Ра1:е.1:о0а1:еЗі:гіпд(), Ра1:е.1:оІ_оса1еЗі:гіпд(), Ра1:е.1:оІоса1еТітеЗі:гіпд(), Ра1:е.1:оЗі:гіпд(), Раііе. 
ТоТітеЗТгіпдО 

Оаіе.'ІоІ.осаІеЗігіпдО 

преобразует дату в строку с учетом региональных настроек 

Синтаксис 

дата. 1:оІ_оса1еЗі:гіпд () 

Возвращаемое значение 

Строковое представление даты и времени в объекте дата . Дата и время представлены 
в локальном часовом поясе и отформатированы в соответствии с региональными на¬ 
стройками. 

Порядок использования 

Метод 1:оІ_оса1еЗі:гіпд() преобразует дату в строку в соответствии с локальным часо¬ 
вым поясом. При форматировании даты и времени используются региональные на¬ 
стройки, поэтому формат может отличаться на разных платформах и в разных стра¬ 
нах. Метод 1:оІ_оса1еЗі:гіпд() возвращает строку, отформатированную в соответствии 
с предпочтительным для пользователя форматом представления даты и времени. 

См. также 

Ра1:е.1:оІ303і:гіпд(), Ра1:еЛоІ_оса1е0а1:еЗі:гіпд(), ОаІіе.ІіоІосаІеТітеЗі:гіпд ( ), 0а1:е.1:о8і:гіпд(), 
Ра1:е.1:оІЛСЗі:гіпд() 
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Оа1е.1оІосаІеТіте$1гіпд() 

возвращает время из Оаіе в виде строки с учетом региональных настроек 

Синтаксис 

дата. 1:оІоса1еТітеЗі:гіпд() 

Возвращаемое значение 

Зависящее от реализации и понятное человеку строковое представление данных 
о времени из объекта дата, выраженное в локальном часовом поясе и отформатирован¬ 
ное в соответствии с региональными настройками. 

См. также 

Оаііе.1:о0а1:е31:гіпд(), Оаііе.1іоІ_оса1е0а1іеЗіігіпд(), Оаііе.1іоІ_оса1еЗіігіпд(), ОаІіе.ІіоЗіігіпдО, Оаііе. 
ІіоТітеЗіігіпдО 

Оа*е.*о5*гіпд() 

преобразует объект Раіе в строку переопределяет 0Ь]ес1.іо$ігіпд() 

Синтаксис 

дата. іоЗіігіпдО 

Возвращаемое значение 

Понятное человеку строковое представление даты в локальном часовом поясе. 

Описание 

Метод 1іоЗіігіпд( ) возвращает понятное человеку и зависящее от реализации строковое 
представление даты . В отличие от ІіоІЛСЗіігіпдО, метод ТоЗі:гіпд( ) вычисляет дату в ло¬ 
кальном часовом поясе. В отличие от 1іоІ_оса1еЗіігіпд(), метод ІіоЗіігіпдО может пред¬ 
ставлять дату и время без учета региональных настроек. 

См. также 

Оаііе. рагзе(), Оаііе.ІіоОаІіеЗіігіпдО, 0а1:е.1:оІ303і:гіпд( ), Оаііе. 1:оІ_оса1еЗі:гіпд(), ОаІе.ІіоТіте- 
Зі:гіпд(), Ра1:е.1:оиТСЗі:гіпд() 

Оа*е.*оТіте5*гіпд() 

возвращает время из объекта Оаіе в виде строки 

Синтаксис 

дата. ІіоТітеЗі: г іпд () 

Возвращаемое значение 

Зависящее от реализации, понятное человеку строковое представление данных о вре¬ 
мени из объекта дата, выраженное в локальном часовом поясе. 

См. также 

Ра1:е.1:оЗі:гіпд(), Ра1:е.1:о0а1:еЗі:гіпд(), Оаііе.1:оІоса1еТітеЗі:гіпд() 
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Оа*е/ІоІЛС5*гіпд() 

преобразует объект Раіе в строку (универсальное время) 

Синтаксис 

дата. 1оІДСЗі:гіпд() 

Возвращаемое значение 

Понятное человеку строковое представление даты, выраженное в универсальном вре¬ 
мени. 

Описание 

Метод 1:оІЛСЗі:гіпд() возвращает зависящую от реализации строку, представляющую 
дату в универсальном времени. 

См. также 

Ра1:е.1:оІ303і:гіпд(), Ра1:е.1:оІ_оса1еЗі:гіпд(), 0а1:е.1:оЗі:гіпд() 

Ра1е.ІІТС() 

преобразует спецификацию даты в миллисекунды 

Синтаксис 

РаІіе.ІЛССгод, месяц, день, часы, минуты, секунды, мс) 

Аргументы 

год Год в четырехзначном формате. Если аргумент находится между 0 и 99, 

к нему добавляется 1900, и он рассматривается как год между 1900 и 1999. 

месяц Месяц в виде целого числа от 0 (январь) до 11 (декабрь). 

день День месяца в виде целого числа от 1 до 31. Обратите внимание: наимень¬ 

шее значение этого аргумента равно 1, наименьшее значение других аргу¬ 
ментов - 0. Этот аргумент не является обязательным. 

часы Час в виде целого числа от 0 (полночь) до 23 (11 часов вечера). Этот аргумент 

может отсутствовать. 

минуты Минуты в часе в виде целого числа от 0 до 59. Этот аргумент может отсутст¬ 
вовать. 

секунды Секунды в минутах в виде целого числа от 0 до 59. Этот аргумент может от¬ 
сутствовать. 

мс Количество миллисекунд. Этот аргумент может отсутствовать; игнориро¬ 

вался до выхода стандарта ЕСМАбсгірі. 

Возвращаемое значение 

Миллисекундное представление указанного универсального времени. Метод возвра¬ 
щает количество миллисекунд между полночью по Гринвичу 1 января 1970 года 
и указанным временем. 

Описание 

Метод Эа1:е. 1ЛС() — это статический метод, который вызывается через конструктор 
Ра1:е(), а не через отдельный объект Эаііе. 
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Аргументы Оаііе.ІІТС() определяют дату и время и подразумевают время в формате 
ЦТС. Указанное время ЦТС преобразуется в миллисекундный формат, который мо¬ 
жет использоваться методом-конструктором 0а1іе() и методом Оаііе. зеШте(). 

Метод-конструктор Оаііе () может принимать аргументы даты и времени, идентичные 
тем, что принимает метод Оаііе.ІЛС(). Разница в том, что конструктор 0а1іе() подразу¬ 
мевает локальное время, а Оаііе. ІЛС() - время по Гринвичу (СМТ). Создать объект Баіе, 
используя спецификацию времени в ЦТС, можно следующим образом: 

сі = пем Ра1:е( Оаііе. ІЛС( 1996, 4, 8, 16, 30)); 

См. также 

Оаііе, Оаііе.рагзе(), Оаііе. зеШтеО 

Оаіе.ѵаІиеО{() 

преобразует объект Оаіе в миллисекунды переопределяет ОЬ]есі.ѵаІиеО(() 

Синтаксис 

дата.ѵ аІиеОЮ 

Возвращаемое значение 

Миллисекундное представление даты . Возвращаемое значение совпадает со значени¬ 
ем, возвращаемым Оаііе.деШте(). 

сІесосІеІІШ() 

декодирует символы в ІШ 

Синтаксис 

сІесосіеІШ (і/гі) 

Аргументы 

іігі Строка, содержащая в закодированном виде ЦКІ (ЦпіГогт Кезоигсе ІбепіШег - 
унифицированный идентификатор ресурса) или другой текст, подлежащий де¬ 
кодированию. 

Возвращаемое значение 

Копия аргумента і ігі, в которой все шестнадцатеричные управляющие последова¬ 
тельности заменены на символы, которые они представляют. 

Исключения 

ІШІЕггог Означает, что одна или несколько управляющих последовательностей в игі 
имеют неверный формат и не могут быть правильно декодированы. 

Описание 

сІесосІеІШО - это глобальная функция, возвращающая декодированную копию аргу¬ 
мента игі. Она выполняет действие, обратное действию функции епсосІеІШО; подроб¬ 
ности см. в описании этой функции. 

См. также 

сІесосІеІШСотропеп1і()> епсосІеІШО, епсосІеІШСотропеп1і()> езсаре(), ипезсаре() 




802 


Справочник по базовому ^ѵаБсгір* 


сІесос!еІІРІСотропепІ() 

декодирует управляющие последовательности символов в компоненте IIКI 

4 

Синтаксис 

сІесосІеІШСотропеп1:(5) 

Аргументы 

5 Строка, содержащая закодированный компонент ІІКІ или другой текст, кото¬ 
рый должен быть декодирован. 

Возвращаемое значение 

Копия аргумента 5, в которой шестнадцатеричные управляющие последовательности 
заменены представляемыми ими символами. 

Исключения 

ІШЕггог Означает, что одна или несколько управляющих последовательностей в ар¬ 
гументе 5 имеют неверный формат и не могут быть правильно декодированы. 

Описание 

сІесосІеІШСотропепІіО - глобальная функция, возвращающая декодированную копию 
своего аргумента 5. Ее действие обратно кодированию, выполняемому функцией 
епсосІеІШСотропепііО; подробности см. в справочной статье по этой функции. 

См. также 

сІесосІеІШО, епсосІеІШО, епсосІеІШСотропепііО, езсаре(), ипезсареО 

епсос!еІІКІ() 

выполняет кодирование ІШІ с помощью управляющих последовательностей 

Синтаксис 

епсос!еІШ(і/гі) 

Аргументы 

і/гі Строка, содержащая ІІКІ или другой текст, который должен быть закодирован. 

Возвращаемое значение 

Копия аргумента игі , в которой некоторые символы заменены шестнадцатеричными 
управляющими последовательностями. 

Исключения 

ІШЕггог Указывает, что строка игі содержит искаженные суррогатные пары симво¬ 
лов Юникода и не может быть закодирована. 

Описание 

епсосІеІШО - это глобальная функция, возвращающая закодированную копию аргу¬ 
мента і/Г2. Не кодируются символы, цифры и следующие знаки пунктуации А8СІІ: 

Функция епсосІеІШО кодирует ІІКІ целиком, поэтому следующие символы пунктуа¬ 
ции, имеющие в ІІКІ специальное значение, также не кодируются: 
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Любые другие символы в игі заменяются путем преобразования символа в его код 
ІЛТ-8 и последующего кодирования каждого из полученных байтов шестнадцати¬ 
ричной управляющей последовательностью в формате %хх. В этой схеме кодирования 
А8СІІ-символы заменяются одной последовательностью %хх, символы с кодами от 
\и0080 до ХиОТ^ - двумя управляющими последовательностями, а все остальные 16-раз- 
рядные символы Юникода - тремя управляющими последовательностями. 

При использовании этого метода для кодирования ІЛІІ необходимо быть уверенным, 
что ни один из компонентов ІЛИ (например, строка запроса) не содержит символов- 
разделителей ШН, таких как ? и #. Если компоненты могут содержать эти символы, 
необходимо кодировать каждый компонент отдельно с помощью функции епсосІеІІВІ- 
Сотропеп1:(). 

Метод с!есос1еІІРІ() предназначен для выполнения действия, обратного кодированию. 
До выхода ЕСМА8сгірі ѵЗ с помощью методов е$саре() и ипезсаре(), сейчас признан¬ 
ных устаревшими, выполнялись сходные кодирование и декодирование. 

Пример 

// Возвращает МПр ://тѵі. ізр.сот/арр. сді?агд1 =1&агд2=Ие11о%20\л/ог1с1 
епсосІеІІВІ("Мі:1:р://ш\л/. ізр. сот/арр. сді?агді =1&агд2=1ге11о ѵіог ІсІ"); 
епсосІеІІВІ(''\іі00а9"); // Символ копирайта кодируется в %С2%А9 

См. также 

с1есос1еІШ(), с!есос1еІІВІСотропеп1:(), епсосІеІІРІСотропепі:(), езсаре(), ипезсареО 

епсосІеІЖІСотропеітІ() 

выполняет кодирование компонентов ІШ с помощью управляющих последовательностей 

Синтаксис 

епсойеШСотропеп-Цз) 

Аргументы 

з Строка, содержащая фрагмент ШИ или другой текст, подлежащий кодирова¬ 
нию. 

Возвращаемое значение 

Копия з, в которой определенные символы заменены шестнадцатеричными управ¬ 
ляющими последовательностями. 

Исключения 

ІІВІЕггог Указывает, что строка з содержит искаженные суррогатные пары символов 
Юникода и не может быть закодирована. 

Описание 

епсос1еІІВІСотропеп1:() - это глобальная функция, возвращающая закодированную ко¬ 
пию своего аргумента з. Не кодируются буквы, цифры и следующие знаки пунктуа¬ 
ции А8СІІ: 


Все остальные символы, в том числе такие символы пунктуации, как / : #, служащие 
для разделения различных компонентов ШН, заменяются одной или несколькими 
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шестнадцатеричными управляющими последовательностями. Описание используе¬ 
мой схемы кодирования см. в статье, посвященной функции епсос!еІІВІ(). 

Обратите внимание на разницу между епсос!еІІВІСоглропеп1:() и епсос!еІІВІ(): функция 
епсос!еІІРІСотропеп1:() предполагает, что ее аргументом является фрагмент ІШІ (такой* 
как протокол, имя хоста, путь или строка запроса). Поэтому она преобразует симво¬ 
лы пунктуации, используемые для разделения фрагментов ТЛИ. 

Пример 

епсосІеІІВІСотропепі:("Ме11о ѵюгісі?"); // Вернет Ие11о%20\л/ог1с1%ЗР 

См. также 

сІесосІеІІВІО, с!есос1еШСоглропеп1:(), епсосІеІІВІО, езсаре(), ипезсаре() 

Еггог 

обобщенное исключение 0Ь]ес1—>Еггог 

Конструктор 

пеѵі ЕггогО 

пе\л/ Еггог (сообщение) 

Аргументы 

сообщение Необязательное сообщение об ошибке с дополнительной информацией 

об исключении. 

Возвращаемое значение 

Вновь созданный объект Еггог. Если задан аргумент сообщение , объект Еггог будет ис¬ 
пользовать его в качестве значения своего свойства глеззаде; в противном случае он 
возьмет в качестве значения этого свойства строку по умолчанию, определенную реа¬ 
лизацией. Когда конструктор Еггог() вызывается как функция (без оператора п еѵі), он 
ведет себя так же, как при вызове с оператором пе\л/. 

Свойства 

глеззаде 

пагле 

Методы 

ТоЗТгіпд( ) 

Описание 

Экземпляры класса Еггог представляют ошибки или исключения и обычно использу¬ 
ются с инструкциями ТМ го ѵі и Тгу/саТсИ. Свойство пагле определяет тип исключения, 
а посредством свойства глеззаде можно создать и отправить пользователю сообщение 
с подробной информацией об исключении. 

Интерпретатор ^ѵаВсгірі никогда не создает объект Еггог непосредственно. Вместо 
этого он создает экземпляры одного из подклассов Еггог, таких как ЗупІіахЕггог или 


Сообщение об ошибке с дополнительной информацией об исключении. 
В этом свойстве хранится строка, переданная конструктору, или стро¬ 
ка по умолчанию, определяемая реализацией. 

Строка, задающая тип исключения. Для экземпляров класса Еггог 
и всех его подклассов это свойство задает имя конструктора, с помо¬ 
щью которого был создан экземпляр. 

Возвращает строку, определенную в реализации, которая представля¬ 
ет этот объект Еггог. 




Еггог.теззаде 
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РапдеЕггог. В ваших программах для предупреждения об исключении может быть 
удобнее создавать объекты Еггог или просто выдавать сообщение об ошибке или ее код 
в виде элементарного строкового или числового значения. 

Обратите внимание: спецификация ЕСМАЗсгірі определяет для класса Еггог метод 
1:оЗі:гіпд() (он наследуется всеми подклассами Еггог), но не требует, чтобы этот метод 
возвращал строку, содержащую значение свойства глеззаде. Поэтому не следует ожи¬ 
дать, что метод 1:оЗі:гіпд() преобразует объект Еггог в строку, понятную человеку. Что¬ 
бы отобразить для пользователя сообщение об ошибке, необходимо явно использовать 
свойства пате и теззаде объекта Еггог. 

Пример 

Предупредить об исключении можно так: 

^ііпсііоп 1 = ас1:огіа1(х) { 

Н (х < 0) ХЬгоѵ) пем Е г го г (” ^асііо гіаі : х должно быть >= О"); 

Н (х <= 1) геііігп 1; еізе геіііігп х * ^асіогіаі(хі); 

} 

Перехватывая исключение, можно сообщить о нем пользователю следующим спосо¬ 
бом (с помощью клиентского метода Міпйом.аІегіО): 

Ігу { &*(&/* здесь возникает ошибка */ } 
саТсІі(е) { 

Н (е іпзіапсеоі 1 Еггог) { // Это экземпляр класса Еггог или его подкласса? 
аІегКе. пате + ": " + е. теззаде); 

} 

} 

См. также 

ЕѵаІЕггог, РапдеЕггог, Ре^егепсеЕггог, ЗупІіахЕггог, ТуреЕггог, ІІРІЕггог 

Еггог.теззаде 

сообщение об ошибке 

Синтаксис 

еггог.теззаде 

Описание 

Свойство теззаде объекта Еггог (или экземпляра любого подкласса Еггог) предназначе¬ 
но для хранения понятной человеку строки, содержащей подробные сведения о воз¬ 
никшей ошибке или исключении. Если конструктору Еггог() передан аргумент теззаде , 
он становится значением свойства теззаде. Если аргумент теззаде передан не был, объ¬ 
ект Еггог наследует для этого свойства значение по умолчанию, определенное реали¬ 
зацией (которое может быть пустой строкой). 

Еггог.пате 

тип ошибки 

Синтаксис 


еггог.пате 
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Описание 

Свойство пате объекта Еггог (или экземпляра любого подкласса Еггог) задает тип про¬ 
изошедшей ошибки или исключения. Все объекты Еггог наследуют это свойство от* 
своего конструктора. Значение свойства совпадает с именем конструктора. Другими 
словами, у объектов ЗупІіахЕггог свойство пате равно «ЗупіахЕггог», а у объектов Еѵаі- 
Е г го г - «ЕѵаІЕггог». 

Еггог.іо5ігіпд() 

преобразует объект Еггог в строку переопределяет 0Ь]ес1.1о51гіпд() 

Синтаксис 

еггог.1:оЗі:гіпд() 

Возвращаемое значение 

Строка, определенная реализацией. Стандарт ЕСМА8сгірі ничего не говорит о значе¬ 
нии, возвращаемом этим методом, за исключением того, что оно должно быть стро¬ 
кой. Стоит отметить, что он не требует, чтобы возвращаемая строка содержала имя 
ошибки или сообщение об ошибке. 

е$саре() устарело 

кодирует строку 

Синтаксис 

езсаре(з) 

Аргументы 

5 Строка, которая должна быть закодирована (с применением управляющих по¬ 
следовательностей). 

Возвращаемое значение 

Закодированная копия 5, в которой определенные символы заменены шестнадцате¬ 
ричными управляющими последовательностями. 

Описание 

езсаре() - глобальная функция, которая возвращает новую строку, содержащую зако¬ 
дированную версию аргумента 5. Сама строка 5 не изменяется. Функция езсаре() воз¬ 
вращает строку, в которой все символы, имеющиеся в строке 5 , отличные от букв, 
цифр и символов пунктуации (@, *, _, +, -,. и /) набора А8СІІ, заменены управляющи¬ 
ми последовательностями в формате %хх или %ихххх (где х обозначает шестнадцатерич¬ 
ную цифру). Символы Юникода от \и0000 до УЮО^ заменяются управляющей последо¬ 
вательностью %хх, все остальные символы Юникода - последовательностью %ихххх. 

Строка, закодированная с помощью езсаре(), декодируется функцией ипезсаре(). 

Хотя функция езсаре() стандартизована в первой версии ЕСМАЗсгірі, она была при¬ 
знана устаревшей и удалена из стандарта в ЕСМАЗсгірі ѵЗ. Реализации ЕСМА8сгірі 
обычно поддерживают эту функцию, хотя это необязательно. Вместо езсаре() следует 
использовать функции епсосІеІШО и епсосІе1ШСотропеп1:(). 

Пример 

езсаре(”Не11о іл/огісі! "); // Вернет ”Не11о%201л/ог1с!%21" 




еѵаІО 
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См. также 

епсосІеІІВІО, епсосІеІІВІСотропепІіО 

еѵаІ() 

исполняет содержащийся в строке ЛаѵаБсгірІ-код 

Синтаксис 

еѵаі (код) 

Аргументы 

код Строка, содержащая выполняемое выражение или инструкции. 

Возвращаемое значение 

Значение, полученное в результате выполнения кода, если оно есть. 

Исключения 

Функция еѵаі () возбуждает исключение ЗупІахЕггог, если аргумент код содержит не¬ 
корректный программный код на языке ^ѵаЗсгірі. Если исключение будет возбуж¬ 
дено самим программным кодом в аргументе код, функция еѵа1() передаст его выше 
по стеку вызовов. 

Описание 

еѵаі () - это метод глобального объекта, вычисляющий строку, в которой содержится 
программный код на языке ^ѵаЗсгірі. Если код содержит ^ѵаЗсгірі-выражение, 
еѵаі () вычислит выражение и вернет его значение. Если код содержит одну или не¬ 
сколько ^ѵаЗсгірі-инструкций, еѵа1() выполнит эти инструкции и вернет то значе¬ 
ние (если оно есть), которое вернет последняя инструкция. Если код не возвращает 
никакого значения, еѵаІО вернет значение ипсіе^іпесі. И наконец, если код сгенерирует 
исключение, еѵаІО передаст это исключение вызывающей программе. 

В спецификациях ЕСМАЗсгірі 3 и ЕСМАЗсгірі 5 определяется различное поведение 
функции еѵа1( ). Кроме того, в спецификации ЕСМАЗсгірі 5 для нее определяется раз¬ 
личное поведение в строгом и нестрогом режимах. Чтобы объяснить эти различия, 
необходимо немного отклониться от темы. Реализовать эффективный интерпретатор 
намного проще, когда язык программирования определяет еѵаі как оператор, а не 
как функцию. В языке ЛѵаВсгірі еѵаі является функцией, но ради обеспечения эф¬ 
фективности в нем различаются непосредственные и косвенные вызовы еѵа1(). В не¬ 
посредственном вызове используется идентификатор еѵаі, и, если убрать скобки, вы¬ 
зов функции будет выглядеть как применение оператора еѵаі. Любые другие вызовы 
еѵа1() являются косвенными. Если присвоить функцию еѵаІО переменной с другим 
именем и вызвать по имени переменной, это будет косвенный вызов. Аналогично, ес¬ 
ли вызвать еѵаІО как метод глобального объекта, это также будет косвенный вызов. 

Определив понятия непосредственного и косвенного вызова, поведение функции 
еѵаІО можно описать следующим образом: 

Непосредственный вызов , Е83 и нестрогий режим Е85 

еѵа1() выполняет код в текущей лексической области видимости. Если код объявля¬ 
ет переменную или функцию, она будет определена в локальной области видимо¬ 
сти. Это обычный случай использования функции еѵа1(). 
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Косвенный вызов, Е83 

Спецификация ЕСМА8сгірі 3 позволяет интерпретаторам возбуждать исключе¬ 
ние ЕѵаІЕггог для любых косвенных вызовов еѵа1(). На практике реализации Е83 
обычно этого не делают, тем не менее в них следует избегать косвенных вызовов. 

Косвенный вызов , Е85 

Согласно спецификации ЕСМА8сгірі 5, вместо того чтобы возбудить исключение 
ЕѵаІЕггог, косвенный вызов еѵа1() должен выполнить код в глобальной области ви¬ 
димости, игнорируя любые локальные переменные в текущей лексической облас¬ 
ти видимости. В Е85 можно выполнить присваивание ѵаг деѵаі = еѵаі; и затем 
использовать деѵа1() для выполнения кода в глобальной области видимости. 

Непосредственный и косвенный вызов , строгий режим 

В строгом режиме объявления переменных и функций в коде определяют их в ча¬ 
стной области видимости, которая действует только в данном вызове функции 
еѵа1(). Это означает, что в строгом режиме непосредственный вызов еѵа1() не мо¬ 
жет изменить лексическую область видимости, а косвенный вызов не может изме¬ 
нить глобальную область видимости. Эти правила действуют, если вызов еѵа1() 
выполняется в строгом режиме или если код начинается с директивы «изе зігісі». 

Функция еѵа1( ) в языке ^ѵа8сгірі предоставляет очень мощные возможности, тем не 
менее она не часто используется в реальных программах. Очевидной областью ее при¬ 
менения являются программы, работающие как рекурсивные интерпретаторы ^ѵа- 
8сгірі или динамически генерирующие и выполняющие Лѵа8сгірі-код. 

Большинство ^ѵа8сгірі-функций, принимающих строковые аргументы, могут так¬ 
же принимать аргументы других типов и перед обработкой просто преобразуют эти 
значения в строки. Метод еѵа1() ведет себя иначе. Если аргумент код не является эле¬ 
ментарным строковым значением, он возвращается в неизменном виде. Поэтому будь¬ 
те внимательны, чтобы случайно не передать функции еѵа1() объект Зіігіпд вместо 
элементарного строкового значения. 

Пример 

еѵа1( "1+2”); // Вернет 3 

// Этот фрагмент использует клиентские ЭаѵаЗсгірі-методы для запроса выражения 
// от пользователя и вывода результатов его вычисления. 

// Подробности см. в описаниях клиентских методов \л/іпс!о\л/. а1егі:( ) и Іл/іпсіом. рготрК). 
ігу { 

аіе ПС Результат: " + еѵаі (рготріС Введите выражение:",""))); 

} 

са1:сН(ехсер1:іоп) { 
а1еП(ехсер1:іоп); 

} 

ЕѵаІЕггог 

генерируется при некорректном использовании еѵаІ() ОЬ]есі-*Еггог->ЕѵаІЕггог 

Конструктор 

пе\л/ Еѵа1Еггог() 

пе\л/ ЕѵаІЕггог (сообщение) 
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Аргументы 

сообщение Необязательное сообщение об ошибке с дополнительной информацией 

об исключении. Если этот аргумент указан, он принимается в качестве 
значения свойства глеззаде объекта ЕѵаІЕггог. 

Возвращаемое значение 

Вновь созданный объект ЕѵаІЕггог. Если задан аргумент сообщение , объект Еггог возь¬ 
мет его в качестве значения своего свойства глеззаде; в противном случае в качестве 
значения этого свойства будет использована строка по умолчанию, определенная реа¬ 
лизацией. Когда конструктор Еѵа1Еггог() вызывается как функция (без оператора 
пем), он ведет себя точно так же, как при вызове с оператором пеѵѵ. 

Свойства 

глеззаде 

пагле 

Описание 

Экземпляры класса ЕѵаІЕггог могут создаваться, когда глобальная функция еѵа1() вы¬ 
зывается с любым другим именем. Ограничения на способы вызова функции еѵа1() 
рассматриваются в ее описании. Информация о генерации и перехвате исключений 
приводится в статье, посвященной классу Еггог. 

См. также 

Еггог, Еггог.глеззаде, Еггог.пагле 

Рипсііоп 

функция ЗаѵаБсгірІ 0Ь]ес1->Рипс1іоп 

Синтаксис 

І^ипсТіоп имя_функции(имена_аргументов) // Инструкция определения функции 

{ 

тело 

} 

І^ипсТіоп (имена _аргументов) { тело } // Литерал неименованной функции 
имя_функции{значения_аргументов) // Вызов функции 

Конструктор 

пеѵ\/ РипсИоп (имена_аргументов.тело) 

Аргументы 

имена_аргументов... 

Любое количество строковых аргументов, которые присваивают имя одному или 
нескольким аргументам создаваемого объекта РипсТіоп. 


Сообщение об ошибке с дополнительной информацией об исключении. 
В этом свойстве хранится строка, переданная конструктору, или строка 
по умолчанию, определенная реализацией. Подробности см. в статье 
с описанием свойства Еггог.глеззаде. 

Строка, определяющая тип исключения. Для всех объектов ЕѵаІЕггог 
значение этого свойства равно «ЕѵаІЕггог». 
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тело 

Строка, определяющая тело функции. Она может содержать любое количество 
инструкций на языке ^ѵа8сгірі, разделенных точками с запятой, и ссылаться на 
любые имена аргументов, указанные ранее в конструкторе. 

Возвращаемое значение 

Вновь созданный объект Рипсіііоп. Вызов функции приводит к выполнению Лѵа- 
8сгірі-кода, составляющего аргумент тело . 


Исключения 


ЗупІіахЕггог Указывает, что в аргументе тело или в одном из аргументов из перечня 

имена_аргументов имеется синтаксическая ошибка. 


Свойства 


агдитепТз[] 
саііег 


ІепдТМ 

ргоТоТуре 


Массив аргументов, переданных функции. Признано устаревшим. 

Ссылка на объект Рипсіііоп, вызвавший данную функцию, или пиіі, если 
функция была вызвана из программного кода верхнего уровня. Призна¬ 
но устаревшим. 

Число именованных аргументов, указанных при объявлении функции. 

Объект, определяющий свойства и методы конструктора, совместно ис¬ 
пользуемые всеми объектами, созданными с помощью этого конструк¬ 
тора. 


Методы 

аррІуО 

ЫпР() 

са11() 

ТоЗТгіпдО 


Вызывает функцию как метод указанного объекта, передавая ей ука¬ 
занный массив аргументов. 

Возвращает новую функцию, которая вызывает данную как метод ука¬ 
занного объекта с указанными аргументами. 

Вызывает функцию как метод указанного объекта, передавая ей ука¬ 
занные аргументы. 

Возвращает строковое представление функции. 


Описание 

Функция в языке ^ѵа8сгірі - это фундаментальный тип данных. В главе 8 рассказы¬ 
вается, как определять и использовать функции, а в главе 9 рассматриваются близ¬ 
кие темы, касающиеся методов, конструкторов и свойства ргоіоііуре функций. Под¬ 
робности см. в этих главах. Обратите внимание: функциональные объекты могут соз¬ 
даваться с помощью описанного здесь конструктора РипсііопО, но это неэффективно, 
поэтому в большинстве случаев предпочтительным способом определения функции 
является инструкция определения функции или функциональный литерал. 

В ^ѵа8сгірі 1.1 и более поздних версиях тело функции автоматически получает ло¬ 
кальную переменную по имени агдитепііз, которая ссылается на объект Агдитепііз. Этот 
объект представляет собой массив значений, переданных функции в качестве аргу¬ 
ментов. Не путайте его с устаревшим свойством агдитепІізП, описанным ранее. Под¬ 
робности см. в статье об объекте Агдитепііз. 


См. также 

Агдитепііз; главы 8 и 9 
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Рипсііоп.аррІуО 

вызывает функцию как метод объекта 

Синтаксис 

функция, арріу (этот_объект, аргументы) 

Аргументы 

этот_объект Объект, к которому должна быть применена функция. В теле функции 

аргумент этот_объект становится значением ключевого слова ТГііз. Если 
указанный аргумент содержит значение пи 11, используется глобальный 
объект. 

аргументы Массив значений, которые должны передаваться функции в качестве ар¬ 
гументов. 

Возвращаемое значение 

Значение, возвращаемое при вызове функции . 

Исключения 

ТуреЕггог Генерируется, если метод вызывается для объекта, не являющегося 

функцией, или с аргументом аргументы , не являющимся массивом или 
объектом Агдитепіз. 


Описание 

Метод аррІуО вызывает указанную функцию , как если бы она была методом объекта, 
заданного аргументом этот_объект , передавая ей аргументы, которые содержатся 
в массиве аргументы . Он возвращает значение, возвращаемое функцией. В теле функции 
ключевое слово ІМіз ссылается на объект этот_объект. 

Аргумент аргументы должен быть массивом или объектом Агдиглепііз. Если аргументы 
должны передаваться функции в виде отдельных аргументов, а не в виде массива, 
следует использовать вызов РипсІіоп.саІІО. 

Пример 

// Применяет метод ОЬ^ есі . 1оЗі:гіпд( ), предлагаемый по умолчанию для объекта, 

// переопределяющего его собственной версией метода. Обратите внимание 
// на отсутствие аргументов. 

ОЬ^есІ:. ргоіоіуре. ІоЗігіпд. арріу (о) ; 

// Вызывает метод МаІП.тахО, используемый для нахождения максимального элемента 
// в массиве. Обратите внимание: в этом случае первый аргумент не имеет значения, 
ѵаг сіаііа = [1,2,3,4, 5,6,7,8]; 

МаІП. тах. арріу ( пиіі, Раіа); 

См. также 

РипсІіоп.саІІО 

РипсІіоп.агдитеп{$[] устарело 

аргументы, переданные функции 

Синтаксис 

функция, а гд и гл е пі з [і ] 
функция, агдиглепііз. ІепдІР 
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Описание 

Свойство агдитепііз объекта Рипсііоп представляет собой массив аргументов, передан¬ 
ных функции. Этот массив определен только во время выполнения функции. Свойст; 
во агдитепііз. Іепдіііі позволяет определить количество элементов в массиве. 

Это свойство признано устаревшим, и его никогда не следует использовать в новых 
^ѵаВсгірі-сценариях; вместо него рекомендуется использовать объект Агдитепііз. 

См. также 

Агдитепііз 

Рипс(іоп.Ьіпсі() ЕСМАБсгірг 5 

возвращает функцию, которая вызывается как метод 

Синтаксис 

функция. Ыпб(объект) 

функция. Ыпсі (объект, аргументы ...) 

Аргументы 

объект Объект, к которому должна быть привязана функция. 

аргументы... Ноль или более значение аргументов, которые также должны быть свя¬ 
заны с функцией. 

Возвращаемое значение 

Новая функция, которая будет вызывать эту функцию как метод объекта и передавать 
ей указанные аргументы. 

Описание 

Метод ЫпсІ( ) возвращает новую функцию, которая будет вызывать эту функцию как ме¬ 
тод объекта. В качестве аргументов эта функция будет получать аргументы , переданные 
методу Ыпсі (), за которыми будут следовать аргументы, переданные новой функции. 

Пример 

Допустим, что имеется функция Іив программе вызывается ее метод Ыпс1(), как по¬ 
казано ниже: 

ѵаг д = Р.ЫпсКо, 1, 2); 

В результате этого будет создана новая функция д, вызов д(3) которой эквивалентен 
следующему вызову: 

Р.саЩо, 1, 2, 3); 

См. также 

Рипсіііоп. арр1у(), Рипсіііоп. са11(), раздел 8.7.4 

Рипс1іоп.саІІ() 

вызывает функцию как метод объекта 

Синтаксис 

функция, саіі (этот_объект, аргументы ...) 
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Аргументы 

этот_объект Объект, относительно которого должна быть вызвана функция. В теле 

функции аргумент этот_объект становится значением ключевого слова 
Шз. Если этот аргумент содержит значение пиіі, используется глобаль¬ 
ный объект. 

аргументы... Любое количество аргументов, передаваемых функции. 

Возвращаемое значение 

Значение, возвращаемое вызовом функции. 

Исключения 

ТуреЕггог Генерируется, если метод вызывается для объекта, не являющегося 

функцией. 


Описание 

са11( ) вызывает указанную функцию , как если бы она была методом объекта, указанно¬ 
го в аргументе этот_объект , передавая ей любые аргументы, расположенные в списке 
аргументов после аргумента этот_объект. Вызов са11() возвращает то, что возвращает 
вызываемая функция. В теле функции ключевое слово ІМіз ссылается на объект этот_ 
объект или на глобальный объект, если аргумент этот_объект содержит значение пиіі. 

Если аргументы для передачи в функцию требуется указать в виде массива, исполь¬ 
зуйте метод РипсІіоп.аррІуО. 

Пример 

// Вызывает метод 0Ь]есІ.Іо81гіпд(), по умолчанию предлагаемый для объекта, 

// переопределяющего его собственной версией метода. Обратите внимание 
// на отсутствие аргументов. 

ОЬ] есі .р гоіоіуре . ІоЗІгіпд . саіі ( о); 

См. также 

РипсІіоп.аррІуО 

РипсІІОП.саІІег устарело; не определено в строгом режиме 

функция, вызвавшая данную 

Синтаксис 

функция, саііег 

Описание 

В ранних версиях ^ѵа8сгірІ свойство саііег объекта РипсЕіоп представляло собой 
ссылку на функцию, вызвавшую текущую функцию. Если функция вызывается из 
^ѵа8сгірІ-программы верхнего уровня, свойство саііег будет иметь значение пиіі. 
Это свойство может использоваться только внутри функции (т. е. свойство саііег опре¬ 
делено для функции, только пока она выполняется). 

Свойство Рипсііоп.саііег не является частью стандарта ЕСМА8сгір1 и не обязательно 
для совместимых реализаций, поэтому не следует использовать его. 
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Рипсііоп.ІепдіН 

количество аргументов в объявлении функции 

Синтаксис 

функция. ІепдІіМ 

Описание 

Свойство ІепдТИ функции указывает количество именованных аргументов, объявлен¬ 
ных при определении функции. Фактически функция может вызываться с большим 
или меньшим количеством аргументов. Не путайте это свойство объекта РипсЕіоп со 
свойством ІепдТМ объекта АгдитеггЕз, указывающим количество аргументов, фактиче¬ 
ски переданных функции. Пример имеется в статье о свойстве Агдитеп1:з.1епд1:М. 

См. также 

Агдитеп1:з.1епд1:М 

Рипсііоп.ргоіоіуре 

прототип класса объектов 

Синтаксис 

функция. ргоТоТуре 

Описание 

Свойство ргоТоТуре применяется, когда функция вызывается как конструктор. Оно 
ссылается на объект, являющийся прототипом для целого класса объектов. Любой 
объект, созданный с помощью конструктора, наследует все свойства объекта, на кото¬ 
рый ссылается свойство ргоТоТуре. 

Обсуждение функций-конструкторов, свойства ргоТоТуре и определений классов в язы¬ 
ке ^ѵаВсгірѣ находится в главе 9. 

См. также 

Глава 9 

Рипсііоп.ІоБігіпдО 

преобразует функцию в строку 

Синтаксис 

функция. 1:оЗі:гіпд() 

Возвращаемое значение 

Строка, представляющая функцию. 

Исключения 

ТуреЕггог Генерируется, если метод вызывается для объекта, не являющегося 

функцией. 


Описание 

Метод То8і:гіпд() объекта РипсТіоп преобразует функцию в строку способом, завися¬ 
щим от реализации. В большинстве реализаций, например в Гіге&х и ІЕ, данный ме- 
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тод возвращает строку ^ѵа8сгірІ-кода, которая включает ключевое слово ^ипсЕіоп, 
список аргументов, полное тело функции и т. д. В этих реализациях результат работы 
метода і:оЗі:гіпд() может передаваться в виде аргумента функции еѵа1(). Однако такое 
поведение не оговаривается спецификациями, и на него не следует полагаться. 

СІоЬаІ 

глобальный объект ОЬ^есІ—>СІоЬаІ 

Синтаксис 

Шз 

Глобальные свойства 

Глобальный объект - это не класс, поэтому для следующих глобальных свойств име¬ 
ются отдельные справочные статьи под собственными именами. То есть подробные 
сведения о свойстве ипсіеГіпесі можно найти под заголовком «ипсІеНпесІ», а не «СІоЬаІ. 
ипбейпеб». Обратите внимание, что все переменные верхнего уровня также представ¬ 
ляют собой свойства глобального объекта. 

ІпГіпіІіу Числовое значение, обозначающее положительную бесконечность. 

ИаИ Нечисловое значение. 

ипсіеГіпесІ Значение ипсІеГіпесІ. 

Глобальные функции 

Глобальный объект - это объект, а не класс, поэтому перечисленные далее глобаль¬ 
ные функции не являются методами какого-либо объекта и справочные статьи приве¬ 
дены под именами функций. Так, функция рагзеІгЦО подробно описывается в статье 
под заголовком «рагзеІпІО», а не «ОІоЬаІ.рагзеІпІО». 

с1есос1еиВІ( ) Декодирует строку, закодированную с помощью функции епсо- 

йеШЩ). 

десодеШСотропегЦС ) Декодирует строку, закодированную с помощью функции епсо- 


епсоРеІШ 

йеІШСотропеп1:(). 

Кодирует ШИ, заменяя определенные символы управляющи¬ 

епсодеІІРІСотропепІ: 

ми последовательностями. 

Кодирует компонент ІІКІ, заменяя определенные символы 

езсаре() 

управляющими последовательностями. 

Кодирует строку, заменяя определенные символы управляю¬ 

еѵа1() 

щими последовательностями. 

Вычисляет строку с программным кодом на языке ^ѵабсгірі 

ізРіпі1:е() 

и возвращает результат. 

Проверяет, является ли значение конечным числом. 

ізМаМ 

Проверяет, является ли значение нечисловым (И а И). 

рагзеРІоаШ 

Выбирает число из строки. 

рагзеІгЦО 

Выбирает целое из строки. 

ипезсаре() 

Декодирует строку, закодированную вызовом езсаре(). 


Глобальные объекты 

В дополнение к перечисленным ранее глобальным свойствам и функциям, глобаль¬ 
ный объект определяет свойства, ссылающиеся на все остальные предопределенные 
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^ѵа8сгірі-объекты. Большинство из этих свойств являются функциями-конструкто¬ 
рами: 

Аггау 

Вооіеап 

0а1:е 

Еггог 

ЕѵаІЕггог 

РипсЕіоп 

Ма1:Н 
ИитЬег 
ОЬ^есІ: 

ВапдеЕггог 
ВеІ'егепсеЕггог 
ВедЕхр 
81: гіпд 
8уп1:ахЕггог 
ТуреЕггог 
ІІВІЕггог 

Описание 

Глобальный объект - это предопределенный объект, который в языке ^ѵа8сгірі слу¬ 
жит для размещения глобальных свойств и функций. Все остальные предопределен¬ 
ные объекты, функции и свойства доступны через глобальный объект. Глобальный 
объект не является свойством какого-либо другого объекта, поэтому у него нет имени. 
(Заголовок справочной статьи выбран просто для удобства и не указывает на то, что 
глобальный объект имеет имя «СІоЪаІ».) В ^ѵа8сгірі-коде верхнего уровня можно 
ссылаться на глобальный объект посредством ключевого слова ІіМіз. Однако этот спо¬ 
соб обращения к глобальному объекту требуется редко, т.к. глобальный объект вы¬ 
ступает в качестве начала цепочки областей видимости, поэтому поиск неуточненных 
имен переменных и функций выполняется среди свойств этого объекта. Когда ^ѵа- 
8сгірі-код ссылается, например, на функцию рагзеітО, он ссылается на свойство 
рагзеіпі: глобального объекта. Тот факт, что глобальный объект находится в начале 
цепочки областей видимости, означает также, что все переменные, объявленные в 
ѵа8сгірі-коде верхнего уровня, становятся свойствами глобального объекта. 

Глобальный объект - это просто объект, а не класс. У него нет конструктора 01оЬа1() 
и нет способа создать новый экземпляр глобального объекта. 

Когда ^ѵа8сгір!-код встраивается в определенную среду, глобальному объекту обыч¬ 
но придаются дополнительные свойства, специфические для этой среды. На самом 
деле тип глобального объекта в стандарте ЕСМА8сгірі не указан, и в конкретной реа¬ 
лизации ^ѵа8сгір1 в качестве глобального может выступать объект любого типа, ес¬ 
ли этот объект определяет перечисленные здесь основные свойства и функции. В кли¬ 
ентском ^ѵа8сгір1, например, глобальным объектом является объект Міпсіом, пред¬ 
ставляющий окно веб-броузера, внутри которого выполняется Лѵа8сгір1-код. 


Конструктор Аггау(). 

Конструктор Воо1еап(). 

Конструктор йа1:е(). 

Конструктор Еггог(). 

Конструктор Еѵа1Еггог(). 

Конструктор Рипс1:іоп(). 

Ссылка на объект, определяющий функции для сериализации объек¬ 
тов в формат ^(Ж и обратно. 

Ссылка на объект, определяющий математические функции. 
Конструктор МитЬег(). 

Конструктор 0Ь]ес1:(). 

Конструктор НапдеЕггог(). 

Конструктор КеІ'егепсеЕггогО. 

Конструктор НедЕхрО. 

Конструктор 8і:гіпд(). 

Конструктор 8уп1:ахЕггог(). 

Конструктор ТуреЕггог(). 

Конструктор 1)НІЕггог(). 
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Пример 

В базовом ^ѵабсгірі ни одно из предопределенных свойств глобального объекта не 
является перечислимым, поэтому можно получить список всех явно и неявно объяв¬ 
ленных глобальных переменных с помощью следующего цикла 'Гог/іп: 

ѵаг ѵагіаЬІез = 

Рог(ѵаг пате іп іЬіз) 

ѵагіаЬІез += пате + "\п"; 

См. также 

Міпсісм (часть IV книги); глава 3 

Іггііпііу 

числовое свойство, обозначающее бесконечность 
Синтаксис 

Іп^іпіТу 

Описание 

Іп^іпіТу — это глобальное свойство, содержащее специальное числовое значение, кото¬ 
рое обозначает положительную бесконечность. Свойство I п ^ і п 11:у не перечисляется 
циклами 'Гог/іп и не может быть удалено с помощью оператора сІеІеТе. Следует отме¬ 
тить, что ІпГіпііу не является константой и может быть установлено равным какому- 
либо другому значению, но лучше этого не делать. (В то же время МитЬег.Р03ІТІѴЕ_ 
ІИРШТУ- это константа.) 

См. также 

ізРіпііеО, ИаИ, МитЬег.Р03ІТІѴЕ_ІМРШТУ 

і5РіпіІе() _ 

определяет, является ли число конечным 
Синтаксис 

ізРіпііеСл) 

Аргументы 

п Проверяемое число. 

Возвращаемое значение 

Если п является конечным числом (или может быть преобразовано в него), возвраща¬ 
ет Ггие, если п не является числом (ИаМ) или плюс/минус бесконечностью - Гаізе. 

См. также 

Іп-ГіпіТу, ізМаІ\І(), ИаИ, МитЬегМаИ, МитЬегЖОАТІѴЕ.ІМРШТѴ, МитЬег.Р03ІТІѴЕ_ІМРШТѴ 

І5МаІЧ() 

определяет, является ли аргумент нечисловым значением 
Синтаксис 

ізМаМ(х) 
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Аргументы 

х Проверяемое значение. 

Возвращаемое значение 

Если х является специальным нечисловым значением (или может быть в него преоб¬ 
разовано), возвращает {гие, если х является любым другим значением - ^аізе. 

Описание 

Название «КаЫ» является аббреквиатурой от «Ыо^-а-МишЬег» (не число). Глобальная 
переменная ИаИ хранит специальное числовое значение (которое также называется 
ИаИ), представляющее недопустимое число (например, результат деления на ноль). 
ізМаМ() проверяет свой аргумент, чтобы определить, является ли он нечисловым. Эта 
функция возвращает ^аізе, если аргумент х является или может быть преобразован 
в числовое значение, отличное от ИаИ. Она возвращает 1:гие, если аргумент х не являет¬ 
ся или не может быть преобразован в числовое значение или если он равен ИаМ. 

Важной особенностью ИаИ является то обстоятельство, что это значение не равно ни¬ 
какому значению, даже самому себе. Поэтому, если потребуется проверить некоторое 
значение на равенство ИаИ, нельзя будет использовать привычную проверку х === №№ 
она всегда будет возвращать 1"а1зе. Вместо этого следует использовать выражение 
х !== х: оно возвращает 1:гие, только когда х равно ИаИ. 

Обычно функция ізМаМ() служит для проверки результатов, возвращаемых функция¬ 
ми рагзеР1оа1:() и рагзеІггЦ), с целью определить, представляют ли эти результаты кор¬ 
ректные числа. 

Пример 

ізМаМ(О); // => Раізе 

із№М(0/0); // => 1: гие 

із№М(раг5еІп1:("3")); // => Шзе 

ізЫаЫ( ра гзеіпі: (**Ие11о" )); // => {гію 

ізЫаЫС " 3 " ); // => Шзе 

ізМаМ("Ре11о"); // => Ігие 

ізЫаМ(1:гие); // => Раізе 

ізМаЫ( ипсІеГіпесІ); // => 1: гие 

См. также 

ізРіпі1:е(), ИаИ, МитЬег.МаМ, рагзеР1оа1:(), рагзеІпШ 

.ІБОМ ЕСМАЗспр* 5 

выполняет преобразование в формат ЛБОМ и обратно 

Описание 

^30N — это простой объект, который играет роль пространства имен для глобальных 
функций ^(Ж рагзе() и ^(ЖзІігіпдіРуО, определяемых стандартом ЕСМА8сгірі 5. Свой¬ 
ство не является конструктором. Ранее, до появления стандарта ЕСМАВсгірі 5, 
совместимые функции преобразования в формат ^(Ж и обратно были доступны 
в библиотеке кир://] 80 П.ог&/] 80 п 2 .] 8 . 

Аббревиатура <^8(Ж» происходит от ^ѵа8сгірІ ОЬіесі ІЧоІаііоп (форма записи ^ѵа- 
8сгірі-объектов). ^(Ж - это формат сериализации данных, основанный на синтакси¬ 
се литералов в языке ^ѵаЗсгірі;, который может представлять значение пиіі, логиче¬ 
ские значения 1:гие и ^аізе, вещественные числа (с использованием формы записи чи- 





^ОГМ.рагзеО 


819 


еловых литералов в языке ^ѵабсгірі), строки (с использованием формы записи стро¬ 
ковых литералов), массивы значений (с использованием формы записи литералов 
массивов) и отображения строк в значения (с использованием формы записи литера¬ 
лов объектов). Элементарное значение ипсіе'ГіпесІ, а также числовые значения ИаИ и ІггГі- 
піііу не могут быть представлены в формате ^(Ж. Функции, объекты Эаііе, ВедЕхр 
и Еггог также не поддерживаются. 

Пример 

// Создает полную копию любого объект или массива, который может быть 
// представлен в формате 

1чіпс*іоп Реерсору(о) { геіюгп рагБе^ЗОМ.гіпді-Гу(о) ); } 

См. также 

^(Жрагзе(), ^(Жз'1:гіпді1 : у(), раздел 6.9, Мір://] 80 П.огё 

і50Ы.раг$е() ЕСМА$сгірі 5 

выполняет анализ строки в формате Л50Ы 

Синтаксис 

^(Жрагзе($) 

^(ЖрагзеСз, геѵіѵег ) 

Аргументы 

5 Анализируемая строка. 

геѵіѵег Необязательная функция, способная преобразовывать значения, получен¬ 
ные в ходе анализа. 

Возвращаемое значение 

Объект, массив или элементарное значение, полученное в результате анализа строки $ 
(и, возможно, измененное функцией геѵіѵег). 

Описание 

^(ЖрагзеО - глобальная функция, предназначенная для анализа строк в формате 
^(Ж. Обычно ей передается единственный строковый аргумент, и она возвращает 
значение, представленное строкой. 

Необязательный аргумент геѵіѵег можно использовать для фильтрации или заклю¬ 
чительной обработки значения перед тем, как оно будет возвращено вызывающей 
программе. Если этот аргумент указан, функция геѵіѵег будет вызвана для каждого 
элементарного значения (но не для объектов или массивов, содержащих эти элемен¬ 
тарные значения), полученного в ходе анализа строки 5. При вызове функции геѵіѵег 
будет передано два аргумента. Первый - имя свойства, т. е. имя свойства объекта или 
индекс массива в виде строки. Второй - элементарное значение этого свойства объек¬ 
та или элемента массива. Кроме того, функция геѵіѵег будет вызываться как метод 
объекта или массива, содержащего элементарное значение. Особый случай, когда 
строка 5 является представлением элементарного значения, а не объекта или массива. 
В этом случае элементарное значение будет сохранено во вновь созданном объекте 
в свойстве, именем которого является пустая строка, и функция геѵіѵег будет вызвана 
для относительно этого вновь созданного объекта с пустой строкой в первом аргумен¬ 
те и элементарным значением - во втором. 
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Возвращаемое значение функции геѵіѵег станет новым значением заданного свойст¬ 
ва. Если функция геѵіѵег вернет значение своего второго аргумента, то значение свой¬ 
ства не изменится.* Если функция геѵіѵег вернет значение ипсІе-ГіпесІ (или вообще не 
вернет никакого значения), то данное свойство будет удалено из объекта или массива^ 
перед тем, как ^ОПрагзеО вернет его вызывающей программе. 

Пример 

Во многих случаях использование ^(ЖрагзеО выглядит достаточно просто: 

ѵаг сіаііа = ^ОМ. рагзе(іехі); 

Функция ^(Жз1:гіпді1 : у() преобразует объекты Оаііе в строки, а вы с помощью собст¬ 
венной функции геѵіѵег можете выполнять обратное преобразование. Пример ниже 
также фильтрует свойства по их именам и возвращает ипйе^іпесі, чтобы удалить опре¬ 
деленные свойства из полученного объекта: 

ѵаг сіаіа рагзе(*ех*, -Гипс1:іоп(пате, ѵаіье) { 

// Удалить свойства, имена которых начинаются с символа подчеркивания 
іТ (пате[0] == геіигп ипсіе^іпесі; 

// Если значение является строкой в формате представления дат 130 8601, 

// преобразовать его в объект Оаіе. 
іТ (Ііуреоі 1 ѵаіье === "зіігіпд" && 

/ л \сі\сі\сі\сі-\сі\сі-\сі\сіТ\сі\сі : \сі\сі : \сі\сІ. \сі\сі\сі2$/ . Іезі (ѵаіье)) 
геіигп пем ба1:е(ѵа1ие); 

// Иначе вернуть неизмененное значение 
геіюгп ѵаіье 

}); 

См. также 

ОЗОИ.зІігіпді-ГуС), раздел 6.9 

^ОМ.БІХІПдИУО ЕСМАБсгірІ 5 

сериализует объект, массив или элементарное значение 

Синтаксис 

^(Жз1:гіпді1 : у(о) 

ОЗОИ.зІігіпді^уСо, ТіНег) 

ОЗОИ. зі:гіпді^уСо, ТИТег, іпсіепі:) 

Агдшпепіз 

о Объект, массив или элементарное значение, которое требуется преобразо¬ 

вать в строку в формате ^(Ж. 

ТИТег Необязательная функция, которая может изменять значения перед сериа¬ 
лизацией, или массив имен свойств, подлежащих сериализации. 

іпсіепі: Необязательный аргумент, определяющий строку или число пробелов для 

оформления отступов, когда требуется применить форматирование для 
удобочитаемости. Если отсутствует, возвращаемая строка не содержит до¬ 
полнительных пробелов, но вполне понятна для человека. 

Возвращаемое значение 

Строка в формате ^(Ж, представляющая значение о после применения фильтра 
ГіІТег и отформатированная с применением іпсіепі:. 
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Описание 

Функция ^(Жз1:гіпді1 : у() преобразует элементарное значение, объект или массив 
в строку в формате ^(Ж, которая позднее сможет быть преобразована обратно в зна¬ 
чение с помощью функции ^(Ж рагзе(). Обычно эта функция вызывается с единствей- 
ным аргументом и возвращает соответствующую строку. 

Когда функция ^(Ж 5І:гіпді1 : у( ) вызывается с единственным аргументом и когда в нем 
передается объект, массив, строка, число, логическое значение или значение гшіі, се¬ 
риализация выполняется очень просто. Однако, когда значение для сериализации со¬ 
держит объекты, являющиеся экземплярами класса, процесс сериализаци усложня¬ 
ется. Если функция ^(ЖзІігіпді^уО встретит объект (или массив) с методом 1:с^30М(), 
она вызовет этот метод и выполнит сериализацию полученного в результате значения, 
а не самого объекта. Она вызывает метод Іс^ЗСЩ ) с единственным строковым аргумен¬ 
том, в котором передается имя свойства объекта или индекс массива. Класс Оаіе опре¬ 
деляет метод Іс^ЗОМО, преобразующий объекты 0а1:е в строки с помощью метода Оаііе. 
ІоІЗОЗітіпдО. Никакие другие классы, встроенные в язык ^ѵаВсгірІ, не определяют 
метод Іс^ЗОМО, но вы можете определить его в своих классах. Помните, что несмотря 
на свое имя, метод 1:сиЗОМ() не выполняет сериализацию объекта: он просто возвраща¬ 
ет значение, которое будет подвергнуто сериализации вместо оригинального объекта. 

Второй аргумент функции ^(ЖзІгіпдіІ'уО позволяет добавить в процесс сериализаци 
второй слой фильтрации. Этот необязательный аргумент может быть функцией или 
массивом и предоставляет возможность реализации двух разных способов фильтра¬ 
ции. Если передать во втором аргументе функцию, она будет использоваться как инст¬ 
румент замены, подобно методу Іс^ЗОМО, описанному выше. Эта функция будет вызы¬ 
ваться для каждого значения, подлежащего сериализации. Ключевое слово 1:Піз внут¬ 
ри этой функции замены будет ссылаться на объект или массив, в котором определено 
текущее значение. Первым аргументом функции замены будет передаваться имя свой¬ 
ства объекта или индекс в массиве для текущего значения, а во втором - само значе¬ 
ние. Это значение будет замещено возвращаемым значением функции. Если функция 
вернет ипсіе^іпесі или вообще ничего не вернет, то это значение (и соответствующее ему 
свойство объекта или элемент массива) будет исключено из сериализации. 

Если во втором аргументе передать массив строк (или чисел - они будут преобразова¬ 
ны в строки), эти строки будут использоваться как имена свойств объекта. Любое 
свойство, имя которого отсутствует в массиве, будет исключено из сериализации. Кро¬ 
ме того, возвращаемая строка будет содержать свойства в том же порядке, в каком они 
перечислены в массиве. 

Функция ^(ЖзІігіпді^уО обычно возвращает строку без дополнительных пробелов 
и символов перевода строки. Если желательно сделать результат более удобочитае¬ 
мым, можно передать третий агумент. Если указать в нем число от 1 до 10, функция 
^(ЖзІгіпдіІ'уО вставит символы перевода строки и будет использовать указанное 
число пробелов для оформления отступов на каждом «уровне» вложенности. Если 
в этом аргументе передать непустую строку, функция ^(ЖзІгіпдіІ'уО вставит симво¬ 
лы перевода строки и будет использовать указанную строку (но не более 10 первых 
символов из нее) для оформления отступов. 

Примеры 

// Простая сериализация 

ѵаг Іехі = ^(Ж 31 гіпді^у(сіаіа ); 

// Указать точно, какие поля подлежат сериализации 

ѵаг Іехі: = ^(Ж зі:гіпді^у(асІсІ гезз. ["сііу”, "зіаіе", "соипіігу"]); 
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// Указать функцию замены, чтобы можно было сериализовать объекты ПедЕхр 
ѵаг {ехі = 31 гіпді^у ( раііііе гпз, ^ипсіііоп (кеу, ѵаіие) { 

і? (ѵаіие.сопзігисіог === ПедЕхр) геіигп ѵаіие.І 08 І:гіпд(); 
геіигп ѵаіие; 

}); 

// Того же эффекта можно добиться иначе: 

ПедЕхр.ргоіоіуре.Іс^ЗОИ = ^цпсііопО { геііигп ІРіз.ІоЗІ:гіпд(); } 

См. также 

^(ЖрагзеО, раздел 6.9 


Махи 

математические функции и константы 

Синтаксис 

МаТМ .константа 
МаТН. функция () 


Константы 

МаТМ . Е Константа е 9 основание натуральных логарифмов. 

МаТІз . ЬИЮ Натуральный логарифм числа 10. 

МаТМ . ЕИ2 Натуральный логарифм числа 2. 

МаТМ. І_0С10Е Десятичный логарифм числа е, 

МаТИ. Ю02Е Логарифм числа е по основанию 2. 

МаТМ . РІ Константа л. 

Ма 1 :И. 30ПТ1_2 Единица, деленная на корень квадратный из 2. 

МаТИ . 30ПТ2 Квадратный корень из 2. 


Статические 

МаТМ.аЬзО 

МаІМ.асозО 

МаІМ.азіпО 

МаТМ.аІапО 

МаИі.а1:ап2() 

МаТИ.сеіІО 

МаІМ.созО 

МаТМ.ехрО 

МаТИ.-ГІоогО 

МаТИ.ІодО 

МаІМ.тахО 

МаТМ.тіпО 

МаТМ.рсмО 

МаТМ. гапсІот() 

МаТМ. гоипсК) 

МаТМ.зіпО 


функции 

Вычисляет абсолютное значение. 
Вычисляет арккосинус. 

Вычисляет арксинус. 

Вычисляет арктангенс. 

Вычисляет угол между осью X и точкой. 
Округляет число вверх. 

Вычисляет косинус. 

Вычисляет степень числа е. 

Округляет число вниз. 

Вычисляет натуральный логарифм. 
Возвращает большее из двух чисел. 
Возвращает меньшее из двух чисел. 
Вычисляет х в степени у . 

Возвращает случайное число. 

Округляет до ближайшего целого. 
Вычисляет синус. 
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Маііі'і.здг1і( ) Вычисляет квадратный корень. 

Маііі'і.1іап() Вычисляет тангенс. 

Описание 

МаІіМ - это объект, определяющий свойства, которые ссылаются на математические 
функции и константы. Эти функции и константы вызываются с помощью следующе¬ 
го синтаксиса: 

у = Маіііі. зіп(х); 

агеа = гасііиз * гасііиз * МаІМ . РІ: 

Ма1:М - это не класс объектов, как Эаііе и Зіігіпд. Объект Ма1:И не имеет конструктора 
Ма1:М( ), поэтому такие функции, как Маііі'і. зіп( ), - это просто функции, а не методы объ¬ 
екта. 

См. также 

ИитЬег 

МаіН.аЬ$() 

вычисляет абсолютное значение 

Синтаксис 

Маііі'і. аЬз(х) 

Аргументы 

х Любое число. 

Возвращаемое значение 

Абсолютное значение х. 

МаіИ.асо5() 

вычисляет арккосинус 

Синтаксис 

Маііі'і. ас 05 (х) 

Аргументы 

х Число от -1,0 до 1,0. 

Возвращаемое значение 

Арккосинус указанного числа х. Возвращаемое значение может находиться в интер¬ 
вале от 0 до 7і радиан. 

МаіН.азіпО 

вычисляет арксинус 

Синтаксис 

Маііі'і. азіп(х) 

Аргументы 

Число от -1,0 до 1,0. 


X 
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Возвращаемое значение 

Арксинус указанного значения х. Это возвращаемое значение может находиться в ин¬ 
тервале от -7і/2 до 7і/2 радиан. 

МаіН.аІап() 

вычисляет арктангенс 

Синтаксис 

МаТМ. а1:ап(х) 

Аргументы 

х Любое число. 

Возвращаемое значение 

Арктангенс указанного значения х. Возвращаемое значение может находиться в ин¬ 
тервале от -7і/2 до 7і/2 радиан. 

Ма{Н.аіап2() 

вычисляет угол между осью X и точкой 

Синтаксис 

МаТИ. аТапгСу, х) 

Аргументы 

у Координата У точки, 

х Координата X точки. 

Возвращаемое значение 

Значение, лежащее между -пип радиан и указывающее на угол по направлению, об¬ 
ратному часовой стрелке, между положительной осью X и точкой (х,у). 

Описание 

Функция МаТИ.аТап2( ) вычисляет арктангенс отношения у/х. Аргумент у может рас¬ 
сматриваться как координата У (или «рост») точки, а аргумент х - как координата X 
(или «пробег») точки. Обратите внимание на необычный порядок следования аргу¬ 
ментов этой функции: координата У передается до координаты X. 

Ма(Н.сеМ() 

округляет число вверх 

Синтаксис 

Маііі'і.сеіі(х) 

Аргументы 

х Числовое значение или выражение. 

Возвращаемое значение 

Ближайшее целое, большее или равное х. 
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Описание 

Функция МаіІі.сеіІО вычисляет наименьшее целое, т.е. возвращает ближайшее целое, 
большее или равное аргументу функции. Функция МаіІі.сеіІО отличается от Ма1:И. 
гоипсІО тем, что округляет всегда вверх, а не к ближайшему целому. Обратите внима¬ 
ние также, что Ма1:И. сеі1( ) округляет отрицательные числа не к большим по абсолютно¬ 
му значению отрицательным целым; функция округляет их по направлению к нулю. 

Пример 

а = МаІИ . сеіі ( 1.99); // Результат равен 2.0 

Ь = МаІИ . сеіі ( 1.01); // Результат равен 2.0 

с = МаІ^.сеіІ(І.О); // Результат равен 1.0 
сі = МаИі. сеіі (-1.99); // Результат равен -1.0 

МаіН.со5() 

вычисляет косинус 

Синтаксис 

Ма1:0.со5(х) 

Аргументы 

х Угол в радианах. Чтобы преобразовать градусы в радианы, нужно умножить 
значение в градусах на 0,017453293 (2я/360). 

Возвращаемое значение 

Косинус указанного значения х. Это возвращаемое значение может находиться в ин¬ 
тервале от -1,0 до 1,0. 

МаіН.Е 

математическая константа е 

Синтаксис 

МаіО.Е 

Описание 

МаііО.Е- это математическая константа е, база натуральных логарифмов, приблизи¬ 
тельно равная 2,71828. 

МаіН.ехр() 

вычисляете* 

Синтаксис 

МаТИ.ехр(х) 

Аргументы 

х Число или выражение, которое должно использоваться как экспонента. 

Возвращаемое значение 

е х - это число е, возведенное в степень указанной экспоненты х, где е - это основание 
натуральных логарифмов, примерно равное 2,71828. 







826 


Справочник по базовому .ІаѵаБсгірІ: 


МаіН.ЛоогО 

округляет число рниз 

Синтаксис 

МаІіІ'і.'ГІоог(х) 


Аргументы 

х Числовое значение или выражение. 

Возвращаемое значение 

Ближайшее целое, меньшее или равное х. 

Описание 

Округление вниз, т. е. функция возвращает ближайшее целое значение, меньшее или 
равное аргументу функции. 

Функция МаТИ .‘Г1оог( ) округляет вещественное число вниз, в отличие от функции МаТИ. 
гоипс1(), выполняющей округление до ближайшего целого. Обратите внимание: МаТИ. 
Иоог( ) округляет отрицательные числа вниз (т. е. дальше от нуля), а не вверх (т. е. бли¬ 
же к нулю). 


Пример 

а = МаІМ. Иоог(1.99); 

Ь = МаІЬ. Иоог(1.01); 
с = МаІМ. Иоог(1.0); 
й = МаТН. -Г1оог(-1.01); 


// Результат равен 1.0 
// Результат равен 1.0 
// Результат равен 1.0 
// Результат равен -2.0 


Магн.ычю 

математическая константа 1од е 10 

Синтаксис 

Маимто 

Описание 

МаТИ. ЬИЮ - это Іо^ІО, натуральный логарифм числа 10. Эта константа имеет значение, 
приблизительно равное 2,3025850929940459011. 

Ма*Н.ЫЧ2 

математическая константа 1од е 2 

Синтаксис 

Описание 

Ма1:0.І_М2 - это 1о& е 2, натуральный логарифм числа 2. Эта константа имеет значение, 
приблизительно равное 0,69314718055994528623. 
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МаіН.ІодО 

вычисляет натуральный логарифм 

Синтаксис 

МаТМ . 1од(х) 

Аргументы 

х Любое числовое значение, большее нуля. 

Возвращаемое значение 

Натуральный логарифм х. 

Описание 

МаТИ. Іод () вычисляет натуральный логарифм своего аргумента. Аргумент должен 
быть больше нуля. 

Логарифмы числа по основанию 10 и 2 можно вычислить по следующим формулам: 

1од 10 х = 1од 10 е • Іод/ 

Іод/ = Іод/ • Іод/ 

Эти формулы транслируются в следующие ^ѵаЗсгірі-функции: 

^ипсі:іоп 1од10(х) { геіигп МаТІі.Ю010Е * МаІМ. 1од(х); } 

^ипсііоп 1од2(х) { геіигп МаІй.!_002Е * МаІЬ. 1од(х); } 

МаіН.ЮСІОЕ 

математическая константа Іод 10 е 

Синтаксис 

МаИМ.ЮСЮЕ 

Описание 

МаТГ». ЮСІ10Е - это 1о& 10 е, логарифм по основанию 10 константы е. Его значение прибли¬ 
зительно равно 0,43429448190325181667. 

Ма{Н.ЮС2Е 

математическая константа 1од 2 е 

Синтаксис 

МаИІі.І_0С2Е 

Описание 

МаТМ. Ю02Е - это 1о& 2 е, логарифм по основанию 2 константы е. Его значение приблизи¬ 
тельно равно 1,442695040888963387. 

МаіН.тах() 

возвращает наибольший аргумент 

Синтаксис 

МаІІі.та ^(аргументы...) 
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Аргументы 

аргументы... Ноль или более значений. 

Возвращаемое значение 

Наибольший из аргументов. Возвращает -Іп'ГіпіІіу, если аргументов нет. Возвращает 
№М, если какой-либо из аргументов равен ИаИ или является нечисловым значением, 
которое не может быть преобразовано в число. 

Ма{Н.тіп() 

возвращает наименьший аргумент 

Синтаксис 

МаТМ. тіп (аргументы...) 

Аргументы 

аргументы... Любое количество аргументов. 

Возвращаемое значение 

Наименьший из указанных аргументов. Возвращает Іп'ГіпіІіу, если аргументов нет. 
Возвращает №М, если какой-либо из аргументов представляет собой значение №М или 
нечисловое значение, которое не может быть преобразовано в число. 

МаіН.РІ 

математическая константа к 

Синтаксис 

МаіІі.РІ 

Описание 

Маііі. РІ - это константа п, т. е. отношение длины окружности к ее диаметру. Имеет зна¬ 
чение, примерно равное 3,14159265358979. 

Ма1Іі.роѵѵ() 

вычисляет у? 

Синтаксис 

МаТГі. роѵ/(х, у) 

Аргументы 

х Число, которое должно быть возведено в степень, 
у Степень, в которую должно быть возведено число х. 

Возвращаемое значение 

х в степени у (х у ). 

Описание 

МаТГі. роѵу/( ) вычисляет х в степени у. Значения х и у могут быть любыми. Однако если ре¬ 
зультат является мнимым или комплексным числом, МаТГі.роѵ/() возвращает №М. На 
практике это означает, что если значение х отрицательно, то значение у должно быть 
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положительным или отрицательным целым. Также имейте в виду, что большие экспо¬ 
ненты легко приводят к вещественному переполнению и возвращают значение Іп^іпіііу. 

МаіН.гапсІот() 

возвращает псевдослучайное число 

Синтаксис 

МаТИ. гапс!от() 

Возвращаемое значение 

Псевдослучайное число от 0,0 до 1,0. 

МаіН.гоипсІО 

округляет число до ближайшего целого 

Синтаксис 

МаТМ. гоипсі(х) 

Аргументы 

х Любое число. 

Возвращаемое значение 

Целое, ближайшее к х. 

Описание 

МаТМ. гоипс1() округляет аргумент вверх или вниз до ближайшего целого. Число 0,5 ок¬ 
ругляется вверх. Например, число 2,5 округляется до 3, а число -2,5 округляется до -2. 

Ма{Н.$іп() 

вычисляет синус 

Синтаксис 

МаТМ. зіп (х) 

Аргументы 

х Угол в радианах. Для преобразования градусов в радианы умножьте число на 
0,017453293 (2ті/360). 

Возвращаемое значение 

Синус х - число в диапазоне от -1,0 до 1,0. 

Ма{Н.$яг{() 

вычисляет квадратный корень 

Синтаксис 

МаТМ. зд гі:(х) 

Аргументы 

Числовое значение, большее или равное 0. 


х 
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Возвращаемое значение 

Квадратный корень из х. Возвращает №М, если х меньше нуля. 

Описание 

МаІІі.здгіО вычисляет квадратный корень числа. Следует заметить, что произволь¬ 
ные корни чисел можно вычислять посредством функции Маіііі . роѵ\/( ). Например: 

МаІіИ.сиЬегооІ: = ^ипсіііоп(х) { геііигп МаіМ.роѵѵ(х. 1 /3); } 

Маіііз. сиЬе гооі (8); // Вернет 2 

Ма*Н.5(}КТ1_2 

математическая константа 1/Ѵ2 

Синтаксис 

Ма1М.50ВТ1_2 

Описание 

МаТИ . 30ВТ1_2 - это 1/л/2, величина, обратная корню квадратному из 2. Эта константа 
примерно равна 0,7071067811865476. 

магн.зоктг 

математическая константа л/2 
Синтаксис 

Ма1И.50ВТ2 

Описание 

МаТИ. 30ВТ2 - это л/2, корень квадратный из 2. Эта константа имеет значение, примерно 
равное 1,414213562373095. 

МаіН.іапО 

вычисляет тангенс 

Синтаксис 

МаТИ .і:ап(х) 

Аргументы 

х Угол, измеряемый в радианах. Чтобы преобразовать градусы в радианы, нуж¬ 
но умножить значение в градусах на 0,017453293 (271/360). 

Возвращаемое значение 

Тангенс указанного угла х. 

свойство «нечисло» 

Синтаксис 







ЫитЬег 
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Описание 

№М - это глобальное свойство, ссылающееся на специальное числовое значение «не¬ 
число». Свойство ИаИ не перечисляется циклами ^ог/іп и не может быть удалено опера¬ 
тором сіеіеііе. Обратите внимание: ИаИ - это не константа, и оно может быть установле¬ 
но в любое значение, но лучше этого не делать. 

Определить, является ли значение нечислом, можно с помощью функции і$МаМ(), т. к. 
ИаИ всегда при сравнении оказывается неравным любой другой величине, включая 
само себя! 

См. также 

Іп'ГіпіІіу, ізМаМ(), МитЬегМаИ 

ЫитЬег 

поддержка чисел ОЦесІ— >МитЬег 

Конструктор 

пеѵѵ ИитЬег (значение) 

ИитЬег (значение) 

Аргументы 

значение Числовое значение создаваемого объекта ИитЬег или значение, которое мо¬ 
жет быть преобразовано в число. 

Возвращаемое значение 

Когда функция ИитЬегО используется в качестве конструктора (с оператором пем), она 
возвращает вновь созданный объект ИитЬег. Когда функция ИитЬегО вызывается как 
функция (без оператора пеѵѵ), она преобразует свой аргумент в элементарное числовое 
значение и возвращает это значение (или №М, если преобразование не удалось). 

Константы 

МитЬег.МАХ_ѴАІ_ІІЕ 

Наибольшее представимое число. 

МитЬег.МІОАШЕ 

Наименьшее представимое число. 

МитЬег.МаМ 

Нечисло. 

ИитЬег. МЕ6АТІѴЕ_ІМРІМІТУ 

Отрицательная бесконечность, возвращается при переполнении. 

ІМитЬег. Р05ІТІѴЕ_ІМРШТѴ 

Положительная бесконечность; возвращается при переполнении. 

Методы 

ТоЗі;гіпд() 

Преобразует число в строку в указанной системе счисления. 

1:оІ_оса1еЗі:гіпд() 

Преобразует число в строку, руководствуясь локальными соглашениями о форма¬ 
тировании чисел. 
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іоРіхесК) 

Преобразует число в строку, содержащую указанное число цифр после десятичной 
точки. * 

1:оЕхропеп1:іа1() 

Преобразует числа в строки в экспоненциальной нотации с указанным количест¬ 
вом цифр после десятичной точки. 

ІіоРгесізіопО 

Преобразует число в строку, записывая в нее указанное количество значащих 
цифр. Используется нотация экспоненциальная или с фиксированной точкой в за¬ 
висимости от размера числа и заданного количества значащих цифр. 

ѵаІиеОН) 

Возвращает элементарное числовое значение объекта МитЬег. 

Описание 

Числа - это базовый элементарный тип данных в ^ѵаЗсгірІ. В ^ѵаЗсгірІ поддержи¬ 
вается также объект МитЬег, представляющий собой обертку вокруг элементарного чи¬ 
слового значения. Интерпретатор ^ѵаЗсгір! при необходимости автоматически вы¬ 
полняет преобразование между элементарной и объектной формами. Существует воз¬ 
можность явно создать объект МитЬег посредством конструктора МитЬег(), хотя в этом 
редко возникает необходимость. 

Конструктор МитЬег() может также вызываться как функция преобразования (без 
оператора пеѵѵ). В этом случае функция пытается преобразовать свой аргумент в число 
и возвращает элементарное числовое значение (или МаМ), полученное при преобразо¬ 
вании. 

Конструктор МитЬег() используется также для размещения пяти полезных числовых 
констант: максимального и минимального представимых чисел, положительной 
и отрицательной бесконечности, а также специального значения «нечисло». Обратите 
внимание: эти значения представляют собой свойства самой функции-конструктора 
МитЬег(), а не отдельных числовых объектов. Например, свойство МАХ_ѴАІ_ЬЕ можно ис¬ 
пользовать следующим образом: 

ѵаг Ьіддезі: = МитЬег. МАХ_ѴАШЕ 

А такая запись неверна: 

ѵаг п = пей ЫитЬег(2); 
ѵаг Ьіддезі: = п. МАХ_ѴАІ_ЬЕ 

В то же время іоЗігіпдО и другие методы объекта МитЬег являются методами каждого 
объекта МитЬег, а не функции-конструктора МитЬег(). Как уже говорилось, ^ѵаЗсгірі; 
при необходимости автоматически выполняет преобразования между элементарны¬ 
ми числовыми значениями и объектами МитЬег. То есть методы класса МитЬег могут 
работать с элементарными числовыми значениями так же, как с объектами МитЬег: 

ѵаг ѵаіие = 1234; 

ѵаг Ьіпагу_ѵа1ие = п.ІоЗІгіпд(2); 

См. также 

ІітГіпіІіу, МаіЬ, МаМ 




ІЧитЬег.МАХ ѴАШЕ 
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ІЧитЬег.МАХ.ѴАШЕ 

максимальное числовое значение 

Синтаксис 

МитЬег. МАХ_ѴАІ_ЬЕ 

Описание 

МитЬег. МАХ_ѴАІ_ЬЕ - это наибольшее число, представимое в ^ѵаЗсгірі. Его значение 
примерно равно 1,79Е+308. 

МитЬег.МІГ\І_ѴАШЕ 

минимальное числовое значение 

Синтаксис 

МитЬег. МІМ_ѴАІ_ЬЕ 

Описание 

МитЬег. МІМ_ѴАІ_ЬЕ - это наименьшее число (ближайшее к нулю, а не самое отрицатель¬ 
ное), представимое в ^ѵаЗсгірі. Его значение примерно равно 5Е-324. 

ГМитЬег.МаМ 

специальное нечисловое значение 

Синтаксис 

МитЬег.МаМ 

Описание 

МитЬег. ИаИ - это специальное значение, указывающее, что результат некоторой мате¬ 
матической операции (например, извлечения квадратного корня из отрицательного 
числа) не является числом. Функции рагзеІпі:() и рагзеЕІоаШ возвращают это значе¬ 
ние, когда не могут преобразовать указанную строку в число; программист может ис¬ 
пользовать МитЬег. аналогичным образом, чтобы указать на ошибочное условие для 
какой-либо функции, обычно возвращающей допустимое число. 

^ѵаЗсгірі выводит значение МитЬег.как МаМ. Обратите внимание: при сравнении 
значение МаМ всегда не равно любому другому числу, включая само значение МаМ. Сле¬ 
довательно, невозможно проверить значение на «нечисло», сравнив его с МитЬег. МаМ. 
Для этого предназначена функция ізМаМ(). В стандарте ЕСМАЗсгірі ѵі и более позд¬ 
них версиях вместо МитЬег. МаМ допускается использование предопределенного гло¬ 
бального свойства МаМ. 

См. также 

ізМаМ(), МаМ 

МитЬег.МЕСАТІѴЕ_ІМРІІѴИТѴ 

отрицательная бесконечность 

Синтаксис 

МитЬег. МЕСАТІѴЕ ІМРШТѴ 
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Описание 

МитЬег. МЕСАТІѴЕ_ІМРІМІТѴ - специальное числовое значение, возвращаемое, если ариф¬ 
метическая операция или математическая функция генерирует отрицательное чис¬ 
ло, большее чем максимальное представимое в ЛѵаЗсгірі число (т. е. отрицательное* 
число, меньшее чем -МитЬег. МАХ_ѴАІ_ЬЕ). 

^ѵаЗсгірі выводит значение МЕСАТІѴЕ_ІМРШТѴ как -ІпРіпіГу. Это значение математиче¬ 
ски ведет себя как бесконечность. Например, все что угодно, умноженное на бесконеч¬ 
ность, является бесконечностью, а все, деленное на бесконечность, - нулем. В ЕСМА- 
Зсгірі ѵі и более поздних версиях можно также использовать предопределенную гло¬ 
бальную константу -ІпРіпііу вместо МитЬег. МЕСАТІѴЕ_ІМРІМІТѴ. 

См. также 

ІпРіпіГу, ізРіпііеО 

МитЬег.РО$ІТІѴЕ_ІМРІМІТѴ 

бесконечность 

Синтаксис 

МитЬег. Р03ІТІѴЕ_ІМРШТѴ 

Описание 

МитЬег. Р03ІТІѴЕ_ІМРІМІТѴ - это специальное числовое значение, возвращаемое, когда 
арифметическая операция или математическая функция приводит к переполнению 
или генерирует значение, превосходящее максимальное представимое в ^ѵаЗсгірі 
число (т.е. МитЬег. МАХ_ѴАІ_ЬЕ). Обратите внимание: если происходит потеря значимости 
или число становится меньше, чем МитЬег. МІМ_ѴАІ_ЬЕ, ^ѵаЗсгірі преобразует его в ноль. 

^ѵаЗсгірі выводит значение РОЗІТІѴЕ.ІМРШТѴ как ІпРіпііу. Это значение ведет себя 
математически так же, как бесконечность. Например, что-либо, умноженное на беско¬ 
нечность, - это бесконечность, а что-либо, деленное на бесконечность, - ноль. В ЕСМА- 
Зсгірі ѵі и более поздних версиях вместо МитЬег. Р03ІТІѴЕ_ІМРІМІТУ можно также ис¬ 
пользовать предопределенную глобальную константу ІггГіпіііу. 

См. также 

ІггГіпіііу, ізРіпіГеО 

МитЬег.іоЕхропеіг(іаІ() 

форматирует число в экспоненциальную форму представления 

Синтаксис 

число . ГоЕхропепГіаЦ разрядность ) 

Аргументы 

разрядность Количество цифр после десятичной точки. Может быть значением от О 

до 20 включительно, конкретные реализации могут поддерживать боль¬ 
ший диапазон значений. Если аргумент отсутствует, то цифр будет 
столько, сколько необходимо. 






І\ІитЬегЛоРіхесІ() 
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Возвращаемое значение 

Строковое представление числа в экспоненциальной нотации с одной цифрой перед 
десятичной точкой и с количеством цифр, указанным в аргументе разрядность , после 
нее. Дробная часть, если это необходимо, округляется или дополняется нулями, что¬ 
бы она имела указанную длину. 


Исключения 

ВапдеЕггог Генерируется, если аргумент разрядность слишком велик или слишком 

мал. Значения между 0 и 20 включительно не приводят к ошибке 
ВапдеЕггог. Реализациям также разрешено поддерживать большее или 
меньшее количество цифр. 

Ту реЕ г го г Генерируется, если метод вызывается для объекта, не являющегося объ¬ 

ектом МитЬег. 


Пример 

ѵаг п = 12345.6789; 
п.1:оЕхропеп1:іа1(1); 
п. ІіоЕхропепІііаІ (5); 
п. ІіоЕхропепІііаІ (10); 
п. ІіоЕхропепІііаІ (); 


// Вернет 1.2е+4 
// Вернет 1.23457е+4 
// Вернет 1.2345678900е+4 
// Вернет 1.23456789е+4 


См. также 

МитЬег. 1:оЕіхесі(), МитЬег. 1:оІ_оса1еЗі:гіпд(), МитЬег. 1:оРгесі5іоп(), МитЬег.ТоЗіігіпдО 


МитЬег.іоРіхесІ() 

форматирует число в форму представления с фиксированной точкой 

Синтаксис 

число X о Р і хе сі ( разрядное ть) 

Аргументы 

разрядность Количество цифр после десятичной точки; оно может быть значением от 

0 до 20 включительно; конкретные реализации могут поддерживать 
больший диапазон значений. Если этот аргумент отсутствует, он счита¬ 
ется равным 0. 

Возвращаемое значение 

Строковое представление числа , которое не использует экспоненциальную нотацию 

и в котором количество цифр после десятичной точки равно аргументу разрядность . 

При необходимости число округляется, а дробная часть дополняется нулями до ука¬ 
занной длины. Если число больше, чем Іе+21, этот метод вызывает функцию МитЬег. 

1:оЗі:гіпд() и возвращает строку в экспоненциальной нотации. 

Исключения 

ВапдеЕггог Генерируется, если аргумент разрядность слишком велик или слишком 

мал. Значения от 0 до 20 включительно не приводят к исключению 
ВапдеЕггог. Конкретные реализации могут поддерживать большие или 
меньшие значения. 

Ту реЕ г го г Генерируется, если метод вызывается для объекта, не являющегося объ¬ 

ектом МитЬег. 
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Пример 

ѵаг п = 12345.6789; 
п. 1:оРіхесІ( ); 

п.ІоРіхесІ(І); 
п. ІіоРіхесІ(б); 

(1.23е+20). 1:оРіхесІ(2); 
(1.23е-10). 1:оРіхесІ(2) 


// Вернет 12346: обратите внимание на округление 
// и отсутствие дробной части 

// Вернет 12345.7: обратите внимание на округление 
// Вернет 12345.678900: обратите внимание на добавление нулей 
// Вернет 123000000000000000000.00 
// Вернет 0.00 


См. также 

МитЬег. 1;оЕхропеп1:іа1(), МитЬег. 1:оІ_оса1еЗі:гіпд(), МитЬег. ІоРгесізіопО, МитЬег. ТоЗТгіпдО 


ІЧитЬег.іоІ-осаІе5ігіпд() 

преобразует число в строку в соответствии с региональными настройками 

Синтаксис 

число.ІоІосаІеЪігіпдО 

Возвращаемое значение 

Зависящее от реализации строковое представление числа, отформатированное в со¬ 
ответствии с региональными настройками, на которое могут влиять, например, сим¬ 
волы пунктуации, выступающие в качестве десятичной точки и разделителя тысяч. 

Исключения 

ТуреЕггог Генерируется, если метод вызван для объекта, не являющегося объек¬ 
том МитЬег. 

См. также 

МитЬег. ІоЕхропегЦіаІО, МитЬег. 1:оРіхесі(), МитЬег. ІоРгесізіопО, МитЬег. ІоЗігіпдО 

ЫитЬег.ІоРгесІ5Іоп() 

форматирует значащие цифры числа 

Синтаксис 

число . 1: о Р ге с і з і о п ( точность) 

Аргументы 

точность Количество значащих цифр в возвращаемой строке. Оно может быть значе¬ 
нием от 1 до 21 включительно. Конкретные реализации могут поддержи¬ 
вать большие и меньшие значения точности . Если этот аргумент отсутствует, 
для преобразования в десятичное число используется метод ІоЗігіпдО. 

Возвращаемое значение 

Строковое представление числа, содержащее количество значащих цифр, определяе¬ 
мое аргументом точность . Если точность имеет достаточно болыцое значение, чтобы 
включить все цифры целой части числа, возвращаемая строка записывается в нота¬ 
ции с фиксированной точкой. В противном случае запись осуществляется в экспонен¬ 
циальной нотации с одной цифрой перед десятичной точкой и количеством цифр точ¬ 
ность -1 после десятичной точки. Число при необходимости округляется или дополня¬ 
ется нулями. 





ЫитЬег/ІоБиіпдО 
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Исключения 

ПапдеЕггог Генерируется, если аргумент точность слишком мал или слишком ве¬ 
лик. Значения от 1 до 21 включительно не приводят к исключению Вап- 
деЕггог. Конкретные реализации могут поддерживать большие и мень¬ 
шие значения. 

Ту реЕ г го г Генерируется, если метод вызывается для объекта, не являющегося объ¬ 

ектом МитЬег. 


Пример 

ѵаг п = 12345.6789; 
п. ІіоРгесізіоп (1); // Вернет 

п. ІіоРгесізіоп (3); // Вернет 

п. ІіоРгесізіоп (5); // Вернет 

п. ІіоРгесізіоп (10); // Вернет 


1е+4 
1.23е+4 

12346: обратите внимание на округление 
12345.67890: обратите внимание на добавление нуля 


См. также 

МитЬег. ТоЕхропепТіаІО, МитЬег. ІоЕіхесК), МитЬег. 1:оІ_оса1еЗі:гіпд(), МитЬег. ІоЗТгіпдО 


ЫитЬег.іо5ігіпд() 

преобразует число в строку переопределяет 0Ь]есі.іо5ігіпд() 

Синтаксис 

число. ТоЗі; г і пд ( основание) 

Аргументы 

основание Необязательный аргумент, определяющий основание системы счисле¬ 
ния (между 2 и 36), в которой должно быть представлено число. Если ар¬ 
гумент отсутствует, то основание равно 10. Следует заметить, что специ¬ 
фикация ЕСМАЗсгірі разрешает реализациям возвращать любое значе¬ 
ние, если этот аргумент равен любому значению, отличному от 10. 

Возвращаемое значение 

Строковое представление числа. 

Исключения 

Ту реЕ г го г Генерируется, если метод вызывается для объекта, не являющегося объ¬ 

ектом МитЬег. 

Описание 

Метод ІіоЗТгіпдО объекта МитЬег преобразует число в строку. Если аргумент основание 
опущен или указано значение 10, число преобразуется в строку по основанию 10. Хо¬ 
тя спецификация ЕСМАЗсгірі не требует от реализаций корректно реагировать на 
любые другие значения аргумента основание , тем не менее все распространенные реа¬ 
лизации принимают значения основания в диапазоне от 2 до 36. 

См. также 

МитЬег. 1:оЕхропеп1:іа1(), МитЬег. ТоЕіхесК), МитЬег. 1:оІ_оса1еЗі:гіпд(), МитЬег. ТоРгесізіопО 
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МитЬег.ѵаІиеО{() 

преобразует число в строку переопределяет 0Ь]ес1.ѵаІие0{() 

Синтаксис 

ч^/сло.ѵаІиеОІЧ) 

Возвращаемое значение 

Элементарное числовое значение объекта МитЬег. В явном вызове этого метода редко 
возникает необходимость. 

Исключения 

Ту реЕ г го г Генерируется, если метод вызывается для объекта, не являющегося объ¬ 

ектом МитЬег. 

См. также 

ОЬзесІ.ѵаІиеОІО 

ОЬіесІ 

надкласс, реализующий общие возможности всех ЗаѵаБсгірі-объектов 

Конструктор 

пем 0Ь]ес1:() 

пем ОЬ]есЦ значение) 

Аргументы 

значение Этот необязательный аргумент определяет элементарное значение- 

число, логическое значение или строку, которое должно быть преобразо¬ 
вано в объект МитЬег, Вооіеап или ЗТгіпд. 

Возвращаемое значение 

Если аргумент значение указан, конструктор возвращает вновь созданный экземпляр 
ОЬ^есІ:. Если указан аргумент значение элементарного типа, конструктор создаст объ¬ 
ект-обертку МитЬег, Вооіеап или Зігіпд для указанного элементарного значения. Если 
конструктор 0Ь]ес1:() вызывается как функция (без оператора пеѵі), он действует точно 
так же, как при вызове с оператором пеѵѵ. 

Свойства 

сопзігисіог Ссылка на функцию, которая была конструктором объекта. 

Методы 

ЬазОѵѵпРгорегіуО 

Проверяет, имеет ли объект собственное (не унаследованное) свойство с указан¬ 
ным именем. 

ізРгоІоІіуреОІО 

Проверяет, является ли данный объект прототипом для указанного объекта. 

ргореПуІзЕпитегаЫеО 

Проверяет, существует ли свойство с указанным именем и будет ли оно перечисле¬ 
но циклом Іог/іп. 





ОЬіесІ 
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1:оІ_оса1еЗі:гіпд() 

Возвращает локализованное строковое представление объекта. Реализация по 
умолчанию этого метода просто вызывает метод 1:оЗі:гіпд(), но подклассы могут пе¬ 
реопределять его для выполнения локализации. 

1:оЗі:гіпд() 

Возвращает строковое представление объекта. Реализация этого метода в классе 
0Ь]ес1: является очень общей и возвращает немного полезной информации. Под¬ 
классы ОЬ^есІ: обычно переопределяют этот метод собственным методом іоЗігіпдО, 
возвращающим более полезный результат. 

ѵаІиеОЮ 

Возвращает элементарное значение объекта, если оно существует. Для объектов 
типа 0Ь]ес1: этот метод просто возвращает сам объект. Подклассы ОЬ^есІ:, такие как 
МитЬег и Вооіеап, переопределяют этот метод, чтобы можно было получить элемен¬ 
тарное значение, связанное с объектом. 

Статические методы 

В ЕСМАЗсгірІ 5 конструктор ОЬ^есІ: служит пространством имен для следующих гло¬ 
бальных функций: 

0Ь]ес1:.сгеаі:е() 

Создает новый объект с указанным прототипом и свойствами. 

ОЬ^есІ: . с!е1 = іпеРгорег1:іез( ) 

Создает или настраивает одно или более свойств в указанном объекте. 

ОЬ^есІ: . сІе^іпеРгорегІіуС ) 

Создает или настраивает свойство в указанном объекте. 

0 Ь]ес 1 :.'Ггее 2 е() 

Делает указанный объект неизменяемым. 

0Ь]ес1:.де1:0\л/пРгорег1:у0езсгір1:ог() 

Возвращает атрибуты указанного свойства в указанном объекте. 

0Ь]ес1:.де1:0\л/пРгорег1:уМатез() 

Возвращает массив имен всех неунаследованных свойств в указанном объекте, 
включая свойства, не перечисляемые циклом 1 = ог/іп. 

0Ь]ес1:.де1:Рго1:о1:уре0Е() 

Возвращает прототип указанного объекта. 

0Ь]ес1:.ізЕх1:епзіЫе() 

Определяет, могут ли добавляться новые свойства в указанный объект. 

0Ь]ес1:.ізРго2еп() 

Определяет, является ли указанный объект фиксированным. 

0Ь]ес1:.ізЗеа1ес1() 

Определяет, является ли указанный объект нерасширяемым, а его свойства недос¬ 
тупными для настройки. 

0Ь]ес1:.кеуз() 

Возвращает массив имен неунаследованных перечислимых свойств в указанном 
объекте. 

0Ь]ес1:.ргеѵеп1:Ех1:епзіопз() 

Предотвращает возможность добавления новых свойств в указанный объект. 
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0Ь]ес1:.зеа1() 

Предотвращает возможность добавления новых и удаления существующих свойств 
в указанном объекте. 

Описание 

Класс 0Ь]ес1: - это встроенный тип данных языка ^ѵаЗсгірі. Он играет роль надклас¬ 
са для всех остальных ^ѵаЗсгірі-объектов; следовательно, методы и поведение клас¬ 
са 0Ь]ес1: наследуются всеми остальными объектами. Об основных особенностях ^ѵа- 
8сгірІ-объектов рассказывается в главе 6. 

В дополнение к показанному ранее конструктору 0Ь]ес1:() объекты могут создаваться 
и инициализироваться с помощью синтаксиса объектных литералов, описанного 
в разделе 6.1. 

См. также 

Аггау, Вооіеап, Рипсіііоп, Рипсііоп.ргоіоііуре, МитЬег, Зігіпд; глава 6 

ОЬіесІ.сопзІгисіог 

функция-конструктор объекта 
Синтаксис 

объект, сопзі: гисіог 

Описание 

Свойство сопзігисіог любого объекта - это ссылка на функцию, являющуюся конст¬ 
руктором этого объекта. Например, если создать массив а с помощью конструктора 
АггауО, то значением свойства а.сопзігисііог будет Аггау: 

а = пе\ѵ Аггау(1,2,3); // Создать объект 

а.сопзі: гисТог == Аггау // Равно Іігііе 

Одно из распространенных применений свойства сопзігисііог состоит в определении 
типа неизвестных объектов. Оператор Іуреоі" позволяет определить, является ли неиз¬ 
вестный объект элементарным значением или объектом. Если это объект, то посред¬ 
ством свойства сопзігисіог можно определить тип этого объекта. Например, следую¬ 
щая функция позволяет узнать, является ли данное значение массивом: 

Рьпсіііоп ізАггау(х) { 

геііи гп ((ІіуреоР х == "оЬ^есІ:") && (х. сопзі:гисііо г == Аггау)); 

} 

Однако следует отметить, что, хотя этот прием эффективен для объектов, встроенных 
в базовый ^ѵаЗсгірі, его работа с объектами среды выполнения клиентского ^ѵа- 
8сгірі, такими как объект Міпсіоѵѵ, не гарантируется. Реализация по умолчанию метода 
ОЦесІ.ЮЗігіпдО представляет другой способ определения типа неизвестного объекта. 

См. также 

ОЬзесІ.ІоЗігіпдО 


ОЬіесІ.сгеаІеО 
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ОЬіес1.сгеаіе() ЕСМАБсгірі 5 

создает объект с указанным прототипом и свойствами 

Синтаксис 

ОЪіесІ.сгеаІе(прототип) 

ОЬ] есі:. с геаііе (прототип, дескрипторы) 

Аргументы 

прототип Прототип создаваемого объекта или п и 11. 

дескрипторы Необязательный объект, отображающий имена свойств в их дескрип¬ 
торы. 

Возвращаемое значение 

Вновь созданный объект, наследующий прототип и обладающий свойствами, описы¬ 
ваемыми дескрипторами. 

Исключения 

ТуреЕггог Генерируется, если прототип не является объектом или значением пиіі 

или если указанные дескрипторы заставляют метод ОЬ^есІ: . сІеГіпеРгорег- 
ТіезО сгенерировать исключение ТуреЕггог. 


Описание 

Функция ОЬ^есІ: . сгеа1:е( ) создает и возвращает новый объект с прототипом, определяе¬ 
мым аргументом прототип. Это означает, что новый объект наследует свойства от прото¬ 
типа. 

Если указан необязательный аргумент дескрипторы , функция 0Ь]ес1:.сгеа1:е() добавит 
в новый объект свойства, как если бы был вызван метод ОЬ^есІ:.с!еТіпеРгорег1:іез( ). То 
есть вызов функции ОЬ^есІ:.сгеаііеСр,сі) с двумя аргументами эквивалентен вызовам: 

ОЬ іесі: . сіе^і пеРгоре гі:іез( ОЬ] есі: . с геаіе (р), Р); 

Дополнительную информацию об аргументе дескрипторы можно найти в справочной 
статье ОЬ^есІ:.РеГіпеРгорег1:іез( ), а описание дескрипторов свойств в справочной статье 
ОЬ^есІ: . де1:0\л/пРгорег1:у0езсгір1:ог( ). 

Обратите внимание, что эта функция вызывается не как метод объекта: это глобаль¬ 
ная функция, которая принимает объект в виде аргумента. 

Пример 

// Создать объект, который имеет собственные свойства х и у и наследует свойство г 
ѵаг р = 0Ь]ес1:.сгеа1:е({г:0}, { 

х: { ѵаіье: 1, мгііаЬІе: Гаізе , егштегаЫе^гие, соп^ідигаЬІе: 1:гие}, 
у: { ѵаіие: 2, мгіЛаЬІе: 1"а1зе, егштегаЫе^гие, сопНдигаЫе: {гье}, 

}): 

См. также 

0Ьзес1:.Ре1 : іпеРгорегі:у(), ОЬ^есІ:.РеГіпеРгорег1:іез( ), 0Ь]ес1:.де1:0\л/пРгорег1:у0езсгірі:ог(), раз¬ 
делы 6.1, 6.7 
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ОЬ]есЫеЛпеРгорегйе5() ЕСМА$сгірі5 

создает или настраивает свойства объекта 

Синтаксис 

ОЬ^есІ: . с1е1 = іпеРгорег1:іез(о, дескрипторы) 

Агдитепіз 

о Объект, в котором будут создаваться или настраиваться свойства. 

дескрипторы Объект, отображающий имена свойств в их дескрипторы. 

Возвращаемое значение 

Объект о . 

Исключения 

ТуреЕггог Генерируется, если аргумент о не является объектом или если какое-ли¬ 
бо из указанных свойств не может быть создано или настроено. Эта 
функция не является атомарной: она может создать или настроить часть 
свойств и затем возбудить исключение, не создав или не настроив другие 
свойства. Перечень ошибок, которые могут вызвать исключение ТуреЕг- 
гог, приводится в разделе 6.7. 

Описание 

Функция ОІэ^есІ: . сіеГіпеРгорег1:іез( ) создает или настраивает свойства объекта о, ука¬ 
занные и описанные в аргументе дескрипторы . Имена свойств объекта дескрипторы явля¬ 
ются именами свойств, которые будут созданы или настроены в объекте о, а значе¬ 
ниями этих свойств являются объекты дескрипторов свойств, которые определяют 
атрибуты создаваемых или настраиваемых свойств. 

Функция ОЬ^есІ:. с!еГіпеРгорег1:іез( ) действует подобно функции ОЬзесІі . с!еГіпеРгорегі:у( ); 
дополнительные подробности смотрите в описании этой функции. Дополнительные 
сведения об объектах дескрипторов свойств приводятся в справочной статье ОЦесІ. 
деІіОѵѵпРгорегііуОезсгірІіогО. 

Пример 

// Добавить в новый объект свойства х и у, доступные только для чтения 
ѵаг р = ОЬз есі: . йеГіпеРгорег1:іез( {}, { 

х: { ѵаіие: 0, мгііаЬІе: Гаізе, епитегаЫе: Іігие, сопІідигаЬІе: Іігие}, 
у: { ѵаіие: 1, мгіІаЫе: Шзе, епитегаЫе: Іігие, сопІідигаЬІе: Іігие}, 

}); 

См. также 

0Ь]ес1і.сгеа1іе(), ОЬ^есІ:.сіеГіпеРгорег1:у(), 0Ь]ес1і.де1і0\л/пРгорегііу0езсгір1іог(), раздел 6.7 

ОЬіесІ.сІеЛпеРгорегІуО ЕСМА$сгірі 5 

создает или настраивает одно свойство в объекте 

Синтаксис 

ОЬ^есІ:. сіеГіпеРгорег1:у(о, имя, дескриптор) 

Аргументы 

Объект, в котором будет создаваться или настраиваться свойство. 


о 






ОЬіесІігеегеО 
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имя Имя создаваемого или настраиваемого свойства. 

дескриптор Объект дескриптора свойства, описывающий новое свойство или изме¬ 
нения, которые должны быть выполнены в существующем свойстве. 

Возвращаемое значение 

Объект о. 

Исключения 

ТуреЕггог Генерируется, если аргумент о не является объектом или если свойство 

не может быть создано (из-за того, что объект о является нерасширяе¬ 
мым) или настроено (например, из-за того, что уже существующее свой¬ 
ство является ненастраиваемым). Перечень ошибок, которые могут вы¬ 
звать исключение ТуреЕггог, приводится в разделе 6.7. 


Описание 

Функция ОЬ^еЩ.сіе^іпеРгорег-ЕуО создает или настраивает свойство с именем имя в объ¬ 
екте о, используя описание свойства в аргументе дескриптор. Дополнительные сведе¬ 
ния об объектах дескрипторов свойств приводятся в справочной статье ОЬ^есІ:. де1:0\л/п- 
Ргорег1:у0езсгір1:ог(). 

Если объект о еще не имеет свойства с именем имя, эта функция просто создаст новое 
свойство с атрибутами и значением, указанными в дескрипторе. Если в дескрипторе не 
указаны какие-либо атрибуты, соответствующие им атрибуты получат значение ^аізе 
или ипсІеГіпесІ. 

Если значение аргумента имя совпадает с именем существующего свойства объекта о, 
то функция ОЬ^ес^.сіе^іпеРгорегІуО настроит это свойство, изменив его значение или 
атрибуты. В этом случае в дескрипторе достаточно указать только атрибуты, которые 
должны быть изменены: атрибуты, отсутствующие в дескрипторе, сохранят свои преж¬ 
ние значения. 

Обратите внимание, что эта функция вызывается не как метод объекта: это глобаль¬ 
ная функция, которая принимает объект в виде аргумента. 

Пример 

І^псіііоп соп5ІапІ(о, п, ѵ) { // Определить константу о.п со значением ѵ 
О^есі.сІеІ^іпеРгоре г1:у(о, п, { ѵаіие: ѵ, мгНаЫе: Шзе 

епитегаЫе: Іігие, сопІ'ідигаЫеіІ'аІзе}); 

} 

См. также 

0Ь]ес1:.сгеа1:е(), ОЬ^есІі.сіе^іпеРгорегІіезО, 0уес1:.де1:0мпРгорег1:у0е5Сгір1:ог(), раздел 6.7 

ОЬіесіТгееге() ЕСМА$сгірі 5 

делает объект неизменяемым 

Синтаксис 

0Ь^ес1:.-Ггее2е(о) 

Аргументы 

о Объект, который должен быть зафиксирован. 
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Возвращаемое значение 

Зафиксированный объект о. 

Описание 

Функция ОЬ^еЫ.-ГгеегеО делает объект о нерасширяемым (0^ес1:.ргеѵеп1:Ех1:еп$іопз()), 
а все его собственные свойства - ненастраиваемыми, подобно функции 0Ь^ес1:.зеа1(). 
Однако в дополнение к этому она делает все неунаследованные свойства доступными 
только для чтения. Это означает, что в объект о нельзя будет добавлять новые свойст¬ 
ва, а существующие свойства-данные нельзя будет изменить или удалить. Действие 
функции ОЬ^еЫ.'ГгеегеО является необратимым, т.е. зафиксированный объект нель¬ 
зя снова сделать доступным для изменения. 

Имейте в виду, что функция ОЬ^еЩ.ІтеегеО устанавливает атрибут мгіІіаЫе, имеющий¬ 
ся только в свойствах-данных. Она не действует на свойства, имеющие методы записи. 
Отметьте также, что функция ОЬ^есІ: .Тгееіе { ) не действует на унаследованные свойства. 

Обратите внимание, что эта функция вызывается не как метод объекта: это глобаль¬ 
ная функция, которая принимает объект в виде аргумента. 

См. также 

ОЬзес^.сіе'ГіпеРгорегІуО, О^еЫ.ізЕгогепО, 0Ь]ес1:.ргеѵеп1:Ех1:епзіопз(), ОІэзесТ. зеа1(), раз¬ 
дел 6.8.3 

ОЬіесІ.деЮѵѵпРгорегІуОезсгірІогО ЕСМА$сгірі 5 

возвращает атрибуты свойства 

Синтаксис 

0Ь]ес1:.де1:0\А/пРгорег1:у0е5Сгір1:ог(о 1 имя) 

Аргументы 

о Объект, которому принадлежит искомое свойство. 

имя Имя свойства (или индекс элемента массива), атрибуты которого требуется по¬ 
лучить. 

Возвращаемое значение 

Объект дескриптора для указанного свойства заданного объекта или ипРе^іпей, если 
такое свойство не существует. 

Описание 

Функция 0Ь^ес1:.де1:0\л/пРгорег1:у0езсгір1:ог() возвращает дескриптор для указанного 
свойства заданного объекта. Дескриптор свойства - это объект, описывающий атри¬ 
буты и значение свойства. Более полная информация приводится в следующем под¬ 
разделе. Обратите внимание, что эта функция вызывается не как метод объекта: это 
глобальная функция, которая принимает объект в виде аргумента. 

Дескрипторы свойств 

Дескриптор свойства- это обычный ЛѵаЗсгірІ-объект, описывающий атрибуты 
(и иногда значение) свойства. В языке ЛѵаЗсгірІ существует два типа свойств. Свой¬ 
ства-данные , имеющие значение и три атрибута: епитегаЫе, мгіІіаЫе и соп^ідигаЬІе. 
Свойства с методами доступа , имеющие метод чтения и/или метод записи, а также 
атрибуты епитегаЫе и соп^ідигаЬІе. 





ОЬіесХ.деЮѵѵпРгорегХуМатезО 
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Дескриптор свойства с данными имеет следующий вид: 

{ 

ѵаіце: /* любое значение, допустимое в языке ^ѵаЗсгірІ: */, 

мгіІіаЫе: /* Хгііе или Хаізе */, 

епцтегаЫе: /* 1: гие или ^аізе */, 

сопХідіігаЫе: /* Хпіе или Шзе */ 

} 

Дескриптор свойства с методами доступа имеет следующий вид: 

{ 

деі: /* функция или цпсІеХіпесІ: взамен свойства ѵаіце */, 

зеі: /* функция или цпсіе^іпесі: взамен атрибута ѵі/гіІаЬІе */, 

епцтегаЫе: /* ігце или Хаізе */. 

сопХідцгаЬІе: /* 1: гие или Хаізе */ 

} 

См. также 

ОЬ^есІі.йеХіпеРгорегІіуО, раздел 6.7 

ОЬіес1.деЮѵѵпРгорегІуМате5() 

возвращает имена неунаследованных свойств 

Синтаксис 

0Ь}есХ.деХ0мпРгорег1:у№те$(о) 

Аргументы 

о Объект. 

Возвращаемое значение 

Массив, содержащий имена всех неунаследованных свойств объекта о, включая непе¬ 
речислимые свойства. 

Описание 

Функция ОЬзесХ.деІіОмпРгорегХуМатезО возвращает массив с именами всех неунаследо¬ 
ванных объекта о, включая неперечислимые свойства. Для получения массива имен 
только перечислимых свойств можно использовать функцию (ЭДесХ.кеузО. 

Обратите внимание, что эта функция вызывается не как метод объекта: это глобаль¬ 
ная функция, которая принимает объект в виде аргумента. 

Пример 

ОЬ^есІ.деіОѵі/пРгорегІуМатезСП) // => [ "ІепдТГі" ]: "ХепдХМ" - неперечислимое 

См. также 

ОЬ^есХ.кеузО, раздел 6.5 

ОЬіесІ.деІРгоіо-ІуреОД) ЕСМА$сгірі 5 

возвращает прототип объекта 

Синтаксис 

ОЬзесХ.деХРгоХоХуреОХСо) 




ЕСМАБсгір* 5 
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Аргументы 

о Объект. 

Возвращаемое значение 

Прототип объекта о. 

Описание 

Функция ОЬ^есІі.деІРгоІіоІіуреО^О возвращает прототип своего аргумента. Обратите 
внимание, что эта функция вызывается не как метод объекта: это глобальная функ¬ 
ция, которая принимает объект в виде аргумента. 

Пример 

ѵаг р = {}; // Обычный объект 

ОЬіесІ:.деІіРгоІіоІіуреО^Ср) // => ОЬлест. ргоіоіуре 

ѵаг о = 0Ь]ес1:.сгеа1:е(р) // Объект, наследующий объект р 

ОЬ^есТ.деТРгоТоТуреОГСо) // => р 

См. также 

0Ь]ес1:.сгеа1:е(); глава 6 


ОЬіесі.На50ѵѵпРгорег(у() 

проверяет, является ли свойство унаследованным 

Синтаксис 

объект. РазОѵѵпРгорегІу (имя_свойства) 

Аргументы 

имя_свойства 

Строка, содержащая имя свойства объекта. 

Возвращаемое значение 

Возвращает Ігие, если объект имеет неунаследованное свойство с именем, заданным 
в имени_свойства. Возвращает ^аізе, если объект не имеет свойства с указанным именем 
или если он наследует это свойство от своего объекта-прототипа. 

Описание 

В главе 9 говорится, что ^ѵаЗсгірі-объекты могут иметь собственные свойства, а так¬ 
же наследовать свойства от своих объектов-прототипов. Метод ІіазОмпРгорегІіуО пре¬ 
доставляет способ, позволяющий установить различия между унаследованными 
свойствами и неунаследованными локальными свойствами. 


Пример 

ѵаг о = пем 0Ь]ес1:(); 
о. х = 3.14; 

о. ІіазО\ѵпР горе гііу ("х”); 
о. ИазОѵѵпР горе гі:у( ”у"); 
о . Р азОипР горе г і у (" і о 31 г і п д"); 


// Создать объект 

// Определить неунаследованное свойство 
// Вернет Іігііе: х - это локальное свойство о 
// Вернет 1"аІ5е: о не имеет свойства у 
// Вернет ^аізе: свойство ІоВІгіпд унаследовано 


См. также 

Рипс1:іоп.рго1:о1:уре, 0Іуес1:.ргорег1:уІзЕпитегаЬ1е(); глава 9 




ОЬіесІізЕхІепзіЫеО 
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ОЬіесІ.ізЕхІепзіЫеО ЕСМАБсгір* 5 

возможно ли добавить в объект новое свойство? 


Синтаксис 

0Ь]ес1:.ізЕх1:епзіЫе(о) 

Аргументы 

о Объект, проверяемый на возможность расширения 

Возвращаемое значение 

Ітие, если в объект можно расширить новыми свойствами, и ^аізе - если нет. 

Описание 

Если в объект можно добавлять новые свойства, он является расширяемым. Все объ¬ 
екты сразу после создания являются расширяемыми и остаются таковыми, пока не 
будут переданы функции 0^ес1:.ргеѵепі:Ех1:епзіопз(), ОЬ^есІ:.зеа1() или ОЬзесЕ.ІтееіеО. 

Обратите внимание, что эта функция вызывается не как метод объекта: это глобаль¬ 
ная функция, которая принимает объект в виде аргумента. 


Пример 

ѵаг о = {}; // 

ОЦесІ. ізЕхІіепзіЫеСо) // 

ОЬіесІ:.ргеѵепІіЕхІіепзіопзСо); // 
ОЬіесІ:. ІзЕхІіепзіЫеСо) // 


Создать новый объект 

=> 1: гие : он является расширяемым 

Сделать нерасширяемым 

=> Раізе: теперь он нерасширяемый 


См. также 

ОЬ^есІі.ізРгоіепО, 0^ес1:.і53еа1есК), ОЩесЕ.ргеѵепІіЕхІіепзіопзО, раздел 6.8.3 


ОЬіесІ.ізРгогепО ЕСМАБсгір* 5 

объект является неизменяемым? 

Синтаксис 

0Ь]ес1:.ізРго2еп(о) 

Аргументы 

о Проверяемый объект. 

Возвращаемое значение 

1:гие, если объект о является зафиксированным и неизменяемым, и ^аізе - если нет. 

Описание 

Объект считается зафиксированным, если все его неу нас ледованные свойства (кроме 
свойств с методами записи) доступны только для чтения и он является нерасширяе¬ 
мым. Объект считается нерасширяемым, если в него нельзя добавить новые (неунас¬ 
ледованные) свойства и из него нельзя удалить имеющиеся (неунаследованные) свой¬ 
ства. Функция 0Ь^ес1:.ізРго2еп() проверяет, является ли ее аргумент зафиксирован¬ 
ным объектом или нет. Зафиксированный объект нельзя расфиксировать. 

Обычно фиксация объектов выполняется с помощью функции (ЭДесІ:.ітеегеО. Однако 
зафиксировать объект можно также с помощью функции 0Ь^ес1:.ргеѵеп1:Ех1:епзіопз() 
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с последующим вызовом О^есТ.йеНпеРгорегТуО, чтобы сделать все свойства объекта 
неудаляемыми и доступными только для чтения. 

Обратите внимание, что эта функция вызывается не как метод объекта: это глобаль¬ 
ная функция, которая принимает объект в виде аргумента. 

См. также 

Объест. йеІ'іпеРгорегІіуО, ОуесІі.ТгееіеО, Объест. ізЕхІіепзШеО, Объест. ізЗеаІесК), Объест. 
ргеѵепІіЕхІіепзіопзО, Объест. зеа1(), раздел 6.8.3 

ОЬіесІ.ізРгоіоІуреО^О 

проверяет, является ли один объект прототипом другого объекта 

Синтаксис 

объект. ізРгоІіоІіуреОІЧо) 

Аргументы 

о Любой объект. 

Возвращаемое значение 

Возвращает ігие, если объект является прототипом объекта о. Возвращает Шзе, если 
о не является объектом или если данный объект не является прототипом объекта о. 

Описание 

Как объяснялось в главе 9, объекты в языке ЛѵаЗсгірі наследуют свойства от своих 
объектов-прототипов. К прототипу объекта можно обращаться с помощью свойства 
ргоТоТуре функции-конструктора, которая использовалась для создания и инициали¬ 
зации объекта. Метод ізРгоІіоІуреО^О позволяет определить, является ли один объект 
прототипом другого. Этот прием может применяться для определения класса объекта. 

Пример 

ѵаг о = пем ОбіесІіО; // Создать объект 

Об^есіі. рго^оіуре. ізРгоІо1:уреО^(о) // 1:гие: о - объект 

Рцпсіііоп. ргоіоіуре. ізРгоІіоІіуреОРСо. ІоЗігіпд); // 1:гие: ІоЗігіпд - функция 
Аггау. ргоіоіуре. ізРгоІо1:уреО^([1,2,3]); // Ігце: [1,2,3] - массив 

// Ту же проверку можно выполнить другим способом 

(о.сопзігцсіог == Обіесіі); // Ігце: о создан с помощью конструктора 0б]ес1і() 

(о.ІоЗігіпд.сопзі:гисііог == РііпсНоп); // 1:гие: о.ІіоЗіігіпд - функция 

// Объекты-прототипы сами имеют прототипы. Следующий вызов вернетіігііе, показывая, что 
// объекты-функции наследуют свойства от Рііпсіііоп. ргоіоіуре, а также от ОЬіесІ.ргоІоІуре. 
Обіесіі. рго^оіуре. ізРго1:о1:уреОТ(Рипсіііоп. ргоііоііуре); 

См. также 

Рипсіііоп.ргоііоііуре, Объест. сопзіігисііог; глава 9 

ОЬіес{.і5$еаІесІ() ЕСМА5сгірі 5 

возможно ли добавлять в объект новые и удалять существующие свойства? 

Синтаксис 

ОЬзесТ. івЗеаІесі(о) 





ОЬіесІ.кеузО 
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Аргументы 

о Проверяемый объект. 

Возвращаемое значение 

Ігие, если объект о является нерасширяемым, с недоступными для настройки свойст¬ 
вами, и І'аізе - если нет. 

Описание 

Объект считается нерасширяемым, с недоступными для настройки свойствами, если 
в него нельзя добавить новые (неунаследованные) свойства и нельзя удалить сущест¬ 
вующие (неунаследованные) свойства. Функция ОуесЕ.ізЗеаІесК) проверяет, является 
ли ее аргумент нерасширяемым объектом, с недоступными для настройки свойствами, 
или нет. Недоступные для настройки свойства нельзя вновь сделать настраиваемыми. 
Обычно такие объекты получают с помощью функции ОЬ^есІ:. $еа1() или (ЭДесІ.'ГгеегеО. 
Однако того же эффекта можно добиться с помощью функции (ЭДесІ: . ргеѵеп1:Ех1:епзіопз( ), 
с последующим вызовом О^ес^.йе^іпеРгорег^уО, чтобы сделать все свойства объекта 
неудаляемыми. 

Обратите внимание, что эта функция вызывается не как метод объекта: это глобаль¬ 
ная функция, которая принимает объект в виде аргумента. 

См. также 

0уес1:.с1е1 : іпеРгорег1:у(), ОЬ^есІі.ІтеегеО, ОЬ^есІі.ізЕхІіепзШеО, 0 Ь]ес 1 :.ізЕго 2 еп(), ОЬ^есІ:. 
ргеѵегЦЕхІіепзіопзО, ОЬ^есІі.зеаІО, раздел 6.8.3 

ОЬіес1.кеу$() ЕСМАЗсгір* 5 

возвращает имена собственных перечислимых свойств 

Синтаксис 

0Ь^ес1:.кеуз(о) 

Аргументы 

о Объект. 

Возвращаемое значение 

Массив, содержащий имена всех перечислимых (неу нас ледованных) свойств объекта о. 

Описание 

Функция ОЬлесТ. кеуз( ) возвращает массив с именами свойств объекта о. Массив вклю¬ 
чает только имена свойств, которые являются перечислимыми и определены непо¬ 
средственно в объекте о: унаследованные свойства не включаются. (Для получения 
имен неперечислимых свойств можно использовать функцию (ЭДесІі.деІіОмпРгорегІіу- 
Ыатез().) Свойства в массиве следуют в том же порядке, в каком они перечисляются 
циклом 1"ог/іп. 

Обратите внимание, что эта функция вызывается не как метод объекта: это глобаль¬ 
ная функция, которая принимает объект в виде аргумента. 

Пример 

ОЬіесІ;. кеуз({х:1, у:2}) // => ["х", "у"] 
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См. также 

0Ь^ес1:.де1:0\л/пРгорег1:уМатез(), разделы 5.5.4, 6.5 

ОЬіесІ.ргеѵепІЕхІепзіопБО ЕСМАБсгірі 5 

предотвращает добавление в объект новых свойств 

Синтаксис 

ОЬ^есІ:. ргеѵеп1:Ех1:епзіопз(о) 

Аргументы 

о Объект, который должен иметь расширяемый набор атрибутов. 

Возвращаемое значение 

Объект о с аргументами. 

Описание 

Функция 0^ес1:.ргеѵеп1:Ех1:епзіопз() присваивает значение ^аізе атрибуту ехІепзіЫе 
объекта о, вследствие чего в него нельзя будет добавлять новые свойства. Действие этой 
функции необратимо: нерасширяемый объект нельзя вновь сделать расширяемым. 

Следует отметить, что 0Ьзес1:.ргеѵепі:Ех1:епзіопз() не воздействует на цепочку прототи¬ 
пов, и нерасширяемый объект все еще можно расширить новыми наследуемыми свой¬ 
ствами. 

Обратите внимание, что эта функция вызывается не как метод объекта: это глобаль¬ 
ная функция, которая принимает объект в виде аргумента. 

См. также 

(ЭДесЦ.-ГгеегеО, 0^ес1:.ізЕх1:епзіЫе(), (ЭДес1:.5еа1(), раздел 6.8.3 

ОЬіес1.ргорег(уІ5ЕпитегаЫе() 

проверяет, будет ли свойство видимо для цикла ?ог/іп 

Синтаксис 

объект. ргорег1:уІзЕпитегаЫе(шя_сБо^ства) 

Аргументы 

имя_свойства Строка, содержащая имя свойства объекта. 

Возвращаемое значение 

Возвращает 1: гие, если у объекта есть неунаследованное свойство с именем, указанным 
в аргументе имя_свойства, и если это свойство «перечислимое», т.е. оно может быть пе¬ 
речислено циклом ^ог/іп для объекта. 

Описание 

Инструкция ^ог/іп выполняет цикл по «перечислимым» свойствам объекта. Однако 
не все свойства объекта являются перечислимыми: свойства, добавленные в объект 
программным способом, перечислимы, а предопределенные свойства (например, ме¬ 
тоды) встроенных объектов обычно неперечислимы. Метод ргорег1:уІзЕпитегаЫе() по¬ 
зволяет установить различия между перечислимыми и неперечислимыми свойства¬ 
ми. Однако следует заметить: спецификация ЕСМАЗсгірі утверждает, что ргорегііуіз- 





ОЬіесІ.зеаІО 
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ЕпитегаЫеО не проверяет цепочку прототипов, т.е. этот метод годится только для ло¬ 
кальных свойств объекта и не предоставляет способа для проверки перечисляемости 
унаследованных свойств. 


Пример 

ѵаг о = пем 0Ь]ес1:(); 
о. х = 3.14; 

о. ргорегі:уІ5ЕпіітегаЫе( ”х"); 
о. ргорег1:уІ5ЕпіітегаЫе( "у"); 


// Создать объект 

// Определить свойство 

// Ігііе: х - локальное и перечислимое 

// ^аізе: о не имеет свойства у 


о.ргорег1:уІзЕпитегаЫе(‘'1:оЗі:гіпд"); // ^аізе: ІоЗігіпд унаследованное свойство 
ОЬіесІ:.ргоіоіуре .ргоре г1;уІзЕпите гаЫе( ' ІіоЗі:гіпд ‘); // ^аізе: неперечислимое 




См. также 

Еипсіііоп.ргоііоіуре, ОЬ^есТ.ІпазО\л/пРгорег1:у( ); глава 6 


ОЬіесІ.зеаІО ЕСМАБсгір* 5 

предотвращает добавление и удаление свойств 

Синтаксис 

0Ь:ес1:.зеа1(о) 

Аргументы 

о Объект, который должен стать нерасширяемым, с недоступными для настрой¬ 
ки свойствами. 

Возвращаемое значение 

Объект в аргументе о. 

Описание 

Функция ОуесІ.зеаЦ) делает объект о нерасширяемым (0Ь]ес1:.ргеѵеп1:Ех1:епзіопз()), 
а все его собственные свойства - ненастраиваемыми. Это предотвращает добваление 
новых свойств и удаление существующих. Действие этой функции необратимо: не¬ 
расширяемый объект с ненастраиваемыми свойствами нельзя вновь сделать расши¬ 
ряемым объектом. 

Имейте в виду, что (ЭДесІ: . зеа1( ) не делает свойства объекта доступными только для чте¬ 
ния; используйте для этого функцию ОЦесІі.'ГгеегеО. Отметьте также, что 0уес1:.зеа1() 
не воздействует на унаследованные свойства. Если в цепочке прототипов объекта, об¬ 
работанного функцией ОЦесІі.зеаІО, имеется расширяемый и настраиваемый объект, 
тогда имеется возможность добавлять и удалять наследуемые им свойства. 

Обратите внимание, что эта функция вызывается не как метод объекта: это глобаль¬ 
ная функция, которая принимает объект в виде аргумента. 

См. также 

ОЬ^есі:.сІе^іпеРгорегі:у(), (ЭДесІі.ІтеегеО, ОЬзесІі.ізЗеаІесК), 0Ь]ес1:.ргеѵеп1:Ех1:епзіопз(), раз¬ 
дел 6.8.3 


ОЬіесІЛоІ-осаІе5ігіпд() 

возвращает локализованное строковое представление объекта 

Синтаксис 

объект. 1:оЗі:гіпд() 
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Возвращаемое значение 

Строковое представление объекта. 

Описание 

Этот метод предназначен для получения строкового представления объекта, локали¬ 
зованного в соответствии с текущими региональными настройками. Метод 1:оІ_оса1е- 
Зі:гіпд(), предоставляемый по умолчанию классом ОЬ^есІ:, просто вызывает метод 1:о- 
ЗігіпдО и возвращает полученную от него нелокализованную строку. Однако обрати¬ 
те внимание, что другие классы, в том числе Аггау, Оаііе и І\ІитЬег, определяют собствен¬ 
ные версии этого метода для локализованного преобразования в строку. Вы также 
можете переопределить этот метод собственными классами. 

См. также 

Аггау.1:оІ_оса1еЗі:гіпд(), Эаііе. 1:оІ_оса1еЗі:гіпд(), МитЬег.1:оІ_оса1еЗі:гіпд(), 0Ь}есі:.1:о8і:гіпд() 

ОЬ]ес*.-Іо5*гіпд() 

возвращает строковое представление объекта 

Синтаксис 

объект. ТоЗі; г іпд () 

Возвращаемое значение 

Строка, представляющая объект. 

Описание 

Метод 1:оЗі:гіпд() относится к тем, которые обычно не вызываются явно в ^ѵаЗсгірі- 
программах. Программист определяет этот метод в своих объектах, а система вызы¬ 
вает метод, когда требуется преобразовать объект в строку. 

^ѵаЗсгірі вызывает метод ІоЗітіпдО для преобразования объекта в строку всякий 
раз, когда объект используется в строковом контексте. Например, если объект преоб¬ 
разуется в строку при передаче в функцию, требующую строкового аргумента: 

а1егі:(ту_оЬіес1:); 

Подобным же образом объекты преобразуются в строки, когда они конкатенируются 
со строками с помощью оператора +: 

ѵаг тзд = 'Мой объект: ' + ту_оЬ]ес1:: 

Метод 1:оЗі:гіпд() вызывается без аргументов и должен возвращать строку. Чтобы от 
возвращаемой строки была какая-то польза, эта строка должна каким-либо образом 
базироваться на значении объекта, для которого был вызван метод. 

Определяя в ^ѵаЗсгірі специальный класс, целесообразно определить для него ме¬ 
тод 1:оЗі:гіпд( ). Если этого не сделать, объект наследует метод 1:оЗі:гіпд( ), определенный 
по умолчанию в классе ОЬ^есІ:. Этот стандартный метод возвращает строку в формате: 

[оЬіесІ .класс] 

где класс - это класс объекта: значение, такое как «ОЩесІ», «8ігіп&», «№ітЪег», «Гііпс- 
ііоп», «\ѴіпсІо\ѵ», «Боситепі» и т.д. Такое поведение стандартного метода 1:оЗі:гіпд() 
иногда бывает полезно для определения типа или класса неизвестного объекта. Однако 
большинство объектов имеют собственную версию 1:о31:гіпд(), поэтому для произволь¬ 
ного объекта о необходимо явно вызывать метод ОЬ^есІі.ІіоЗіігіпдО, как показано ниже: 
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ОЬзесІ:. ргоіоііуре. ІоЗігіпд. арріу(о); 

Обратите внимание, что этот способ идентификации неизвестных объектов годится 
только для встроенных объектов. Если вы определяете собственный класс объектов, 
то класс для него будет соответствовать значению «ОЪіесі». В этом случае дополни¬ 
тельную информацию об объекте позволит получить свойство 0Ь]ес1:.сопз1:гис1:ог. 

Метод ІоЗігіпдО может быть очень полезен при отладке Лѵа8сгірі-программ - он по¬ 
зволяет выводить объекты и видеть их значения. По одной только этой причине есть 
смысл определять метод ІоЗігіпдО для каждого создаваемого вами класса. 

Несмотря на то что метод ІоЗігіпдО обычно вызывается системой автоматически, бы¬ 
вают случаи, когда его требуется вызвать явно. Например, чтобы выполнить явное 
преобразование объекта в строку, если ^ѵа8сгірі не делает это автоматически: 

у = МаІИ. зд гі (х); // Вычислить число 

узіг = у.ІоЗігіпдО; // Преобразовать его в строку 

Относительно этого примера следует помнить, что числа имеют встроенный метод 
ІоЗігіпдО, обеспечивающий принудительное преобразование. 

В других случаях вызов ІоЗігіпдО может оказаться полезным - даже в таком контек¬ 
сте, когда Лѵа8сгірі выполняет преобразование автоматически. Явное использова¬ 
ние метода ІоЗігіпдО может сделать программный код более понятным: 

а1ег1;(ту_оЬз . ІоЗі;гіпд( )); 

См. также 

0Ь]ес1:.сопз1:гис1:ог(), 0Ь]ес1:ЛоІ_оса1еЗі:гіпд(), ОЬ^есІі.ѵаІиеОІЧ) 

ОЬіесІ.ѵаІиеО^О 

элементарное значение указанного объекта 

Синтаксис 

объект. ѵаІиеОІ 1 () 

Возвращаемое значение 

Элементарное значение, связанное с объектом , если оно есть. Если с объектом не связано 
значение, метод возвращает сам объект. 

Описание 

Метод ѵаІиеОШ объекта возвращает элементарное значение, связанное с этим объек¬ 
том, если оно есть. Для объектов типа ОЬ^есІ: элементарное значение отсутствует, и ме¬ 
тод такого объекта возвращает сам объект. 

Однако для объектов типа ИитЬег метод ѵаІиеОІЧ) возвращает элементарное числовое 
значение, представляемое объектом. Аналогично он возвращает элементарное логи¬ 
ческое значение, связанное с объектом Вооіеап, или строку, связанную с объектом 

Зігіпд. 

Программисту редко приходится явно вызывать метод ѵаІиеОІЧ). Интерпретатор ^ѵа- 
8сгірі делает это автоматически всякий раз, когда встречает объект там, где ожидает¬ 
ся элементарное значение. Из-за автоматического вызова метода ѵаІиеОШ фактиче¬ 
ски трудно даже провести различие между элементарными значениями и соответст¬ 
вующими им объектами. Оператор Ііуреоі 1 , например, показывает различие между 
строками и объектами Зігіпд, но с практической точки зрения они работают в ^ѵа- 
8сгірі-коде эквивалентным образом. 
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Метод ѵаІиеОІЧ) объектов ИитЬег, Вооіеап и Зігіпд преобразует эти объекты-обертки 
в представляемые ими элементарные значения. Конструктор 0Ь]ес1() выполняет про; 
тивоположную операцию при вызове с числовым, логическим или строковым аргу¬ 
ментом: он «заворачивает» элементарное значение в соответствующий объект-оберт¬ 
ку. В большинстве случаев ^ѵа8сгірі берет это преобразование «элементарное значе¬ 
ние - объект» на себя, поэтому необходимость в таком вызове конструктора 0Ь]ес1:() 
возникает редко. 

Иногда программисту требуется определить специальный метод ѵаІиеОіЧ) для собст¬ 
венных объектов. Например, определить объектный Лѵа8сгірі-тип для представле¬ 
ния комплексных чисел (вещественное число плюс мнимое число). Как часть этого 
объектного типа, можно определить методы для выполнения комплексного сложе¬ 
ния, умножения и т.д. Еще может потребоваться возможность рассматривать ком¬ 
плексные числа как обычные вещественные путем отбрасывания мнимой части. Для 
этого можно сделать примерно следующее: 

Сотріех. р гоіоіуре . ѵаІиеОІ 1 = пеѵ/ Рипсіііоп("геііигп ііііз. геаі"); 

Определив метод ѵаІиеОіЧ) для собственного объектного типа Сотріех, можно, напри¬ 
мер, передавать объекты комплексных чисел в функцию МаІМ.зрг1:(), которая вычис¬ 
лит квадратный корень из вещественной части комплексного числа. 

См. также 

ОЬзесІ.ІоЗігіпдО 

раг$еРІоа{() 

преобразует строку в число 

Синтаксис 

рагзеРІоаіСз) 

Аргументы 

5 Строка для синтаксического разбора, которая должна быть преобразована 
в число. 

Возвращаемое значение 

Возвращает выделенное из строки число или если 5 не начинается с допустимого 
числа. В Лѵа8сгірі 1.0, если строка 5 не может быть преобразована в число, рагзеР1оа1:() 
возвращает 0 вместо 

Описание 

Функция рагзеРІоаіО выполняет синтаксический разбор строки и возвращает первое 
число, найденное в 5. Разбор прекращается и значение возвращается, когда рагзе- 
Р1оа1:() встречает в 5 символ, который не является допустимой частью числа. Если 5 не 
начинается с числа, которое рагзеРІоаШ может разобрать, функция возвращает зна¬ 
чение №М. Проверка на это возвращаемое значение выполняется функцией ізМаМ(). 
Чтобы выделить только целую часть числа, используется функция рагзеІпіО, а не 

рагзеРІоаШ. 

См. также 

ізМаІШ, рагзеІпіО 
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раг$еІп{() 

преобразует строку в целое число 

Синтаксис 

рагзеІгѵЦз) 

рагзеІітЦз, основание) 


Строка для синтаксического разбора. 

Необязательный целочисленный аргумент, представляющий основа¬ 
ние системы счисления анализируемого числа. Если этот аргумент от¬ 
сутствует или равен 0, извлекается десятичное или шестнадцатерич¬ 
ное (если число начинается с префикса «Ох» или «ОХ») число. Если 
этот аргумент меньше 2 или больше 36, рагзеІпіО возвращает ИаИ. 

Возвращаемое значение 

Возвращается извлекаемое число (№М, если 5 не начинается с корректного целого). 
В ^ѵаЗсгірі 1.0, если невозможно выполнить синтаксический разбор строки 5, 
рагзеІп1:() возвращает 0 вместо 

Описание 

Функция рагзеІпіО выполняет синтаксический разбор строки 5 и возвращает первое 
число (с необязательным начальным знаком «минус»), найденное в 5. Разбор останав¬ 
ливается и значение возвращается, когда рагзеІпіО встречает в 5 символ, не являю¬ 
щийся допустимой цифрой для указанного основания. Если 5 не начинается с числа, 
которое может быть проанализировано функцией рагзеІпіО, функция возвращает 
значение №М. Проверка на это возвращаемое значение выполняется функцией із№Н(). 

Аргумент основание задает основание извлекаемого числа. При основании, равном 10, 
рагзеІпіО извлекает десятичное число. Если этот аргумент равен 8, то извлекается 
восьмеричное число (состоящее из цифр от 0 до 7), а если 16 - шестнадцатеричное 
(цифры от 0 до 9 и буквы от А до Е). Аргумент основание может быть любым числом от 
2 до 36. 

Если основание равно 0 или не указано, рагзеІпіО пытается определить систему счис¬ 
ления по строке 5. Если 5 начинается (после необязательного знака «минус») с пре¬ 
фикса «Ох», рагзеІпіО разбирает оставшуюся часть 5 как шестнадцатеричное число. 
Во всех остальных случаях рагзеІпіО разбирает строку как десятичное число. 


Аргументы 

5 

основание 


Пример 

рагзеІпі:( " 19", 10); 
рагзеІпіС'ІГ', 2); 
рагзеІпіС'І?", 8); 
рагзеІпіС'ІГ' , 16); 
рагзеІпК" 10"); 
рагзеІпіС'ОхЮ"); 


// Вернет 19 (10 + 9) 
// Вернет 3 (2 + 1) 

// Вернет 15 (8 + 7) 

// Вернет 31 (16 + 15) 
// Вернет 10 
// Вернет 16 


См. также 

ізМаМ(), рагзеРІоаіО 
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КапдеЕггог 

генерируется, когда число выходит из допустимого диапазона ОЦесІ— >Еггог—>КапдеЕггог 

Конструктор 

пем РапдеЕггог() 

пем РапдеЕггог(сооб///еше) 

Аргументы 

сообщение Необязательное сообщение об ошибке, предоставляющее дополнитель¬ 
ную информацию об исключении. Если этот аргумент указан, он ис¬ 
пользуется в качестве значения свойства теззаде объекта РапдеЕггог. 

Возвращаемое значение 

Вновь созданный объект РапдеЕггог. Если указан аргумент сообщение , то для объекта 
РапдеЕггог он будет выступать в качестве значения свойства теззаде; в противном слу¬ 
чае РапдеЕггог возьмет в качестве значения этого свойства строку по умолчанию, опре¬ 
деленную в реализации. Конструктор РапдеЕггог(), вызываемый как функция (без 
оператора п еѵі), ведет себя так же, как и при вызове с оператором пей. 

Свойства 

теззаде Сообщение об ошибке, предоставляющее дополнительную информацию 

об исключении. Это свойство содержит строку, переданную конструкто¬ 
ру, или предлагаемую по умолчанию строку, определенную в реализа¬ 
ции. Дополнительные сведения см. в справочной статье Еггог.теззаде. 

пате Строка, определяющая тип исключения. Все объекты РапдеЕггог насле¬ 

дуют для этого свойства строку «КапдеЕггог». 

Описание 

Экземпляр класса РапдеЕггог создается, когда числовое значение оказывается вне до¬ 
пустимого диапазона. Например, установка длины массива равной отрицательному 
числу приводит к генерации исключения РапдеЕггог. Дополнительные сведения о ге¬ 
нерации и перехвате исключений см. в справочной статье Еггог. 

См. также 

Еггог, Еггог.теззаде, Еггог.пате 

КеіегепсеЕггог 

генерируется при попытке чтения ОЬ]'есі— >Еггог—>КеТегепсеЕггог 

несуществующей переменной 

Конструктор 

пеѵі РеІ'егепсеЕггогО 

пеѵі Ре1"егепсеЕггог (сообщение) 

Аргументы 

сообщение Необязательное сообщение об ошибке, предоставляющее дополнитель¬ 
ную информацию об исключении. Если этот аргумент указан, он высту¬ 
пает в качестве значения свойства теззаде объекта Ре1"егепсеЕггог. 
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Возвращаемое значение 

Вновь созданный объект РеЕегепсеЕггог. Если указан аргумент сообщение , объект РеЕе- 
гепсеЕггог берет его в качестве значения своего свойства теззаде; в противном случае 
он берет строку по умолчанию, определенную в реализации. Конструктор РеЕегепсе- 
Еггог(), вызываемый как функция (без оператора пем), ведет себя так же, как при вы¬ 
зове с оператором пем. 

Свойства 

теззаде Сообщение об ошибке, предоставляющее дополнительную информацию об 
исключении. Это свойство содержит строку, переданную конструктору, или 
строку по умолчанию, определенную в реализации. Дополнительные сведе¬ 
ния см. в справочной статье Е г го г. теззаде. 

пате Строка, определяющая тип исключения. Все объекты РеЕегепсеЕггог насле¬ 
дуют для этого свойства строку «Ке&гепсеЕггог». 

Описание 

Экземпляр класса РеЕегепсеЕггог создается при попытке прочитать значение несуще¬ 
ствующей переменной. Дополнительные сведения о генерации и перехвате исключе¬ 
ний см. в справочной статье Еггог. 

См. также 

Еггог, Еггог.теззаде, Еггог.пате 

КедЕхр 

регулярные выражения для поиска по шаблону 0 Ь]*есі—> КедЕхр 

Синтаксис литерала 

/маска/атрибуты 

Конструктор 

пем РедЕхр(///аб/7он, атрибуты) 

Аргументы 

шаблон Строка, задающая шаблон регулярного выражения или другое регулярное 
выражение. 

атрибуты Необязательная строка, содержащая любые из атрибутов «&», «і» и «т», за¬ 
дающих глобальный, нечувствительный к регистру и многострочный по¬ 
иск, соответственно. До выхода стандарта ЕСМАВсгірі атрибут «т» не был 
доступен. Если аргумент шаблон - это регулярное выражение, а не строка, 
аргумент атрибуты может отсутствовать. 

Возвращаемое значение 

Возвращается новый объект РедЕхр с указанными шаблоном и атрибутами. Если аргу¬ 
мент шаблон представляет собой регулярное выражение, а не строку, конструктор 
ПедЕхрО создаст новый объект РедЕхр, используя тот же шаблон и атрибуты, что 
и в указанном объекте РедЕхр. Если РедЕхрО вызывается как функция (без оператора 
п еѵі), то ведет себя так же, как при вызове с оператором п еѵі, кроме случая, когда шаблон 
уже является объектом РедЕхр; тогда функция возвращает аргумент шаблон , а не созда¬ 
ет новый объект РедЕхр. 
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Исключения 

ЗупІахЕггог Генерируется, если шаблон не является допустимым регулярным выра¬ 
жением или если аргумент атрибуты содержит символы, отличные от 
«&», «і» и «т». 

ТуреЕггог Генерируется, если шаблон - это объект РедЕхр и аргумент атрибуты не 

опущен. 


Свойства 

дІоЬаІ 

ідпогеСазе 

ІазІІпРех 

тиШІіпе 

зоигсе 


экземпляра 

Признак присутствия в РедЕхр атрибута «&». 

Признак присутствия в РедЕхр атрибута «і». 

Позиция символа при последнем обнаружении соответствия; исполь¬ 
зуется для поиска в строке нескольких соответствий. 

Признак присутствия в РедЕхр атрибута «т». 

Исходный текст регулярного выражения. 


Методы 

ехес( ) Выполняет мощный универсальный поиск по шаблону. 

Тезі: () Проверяет, содержит ли строка данный шаблон. 

Описание 

Объект РедЕхр представляет регулярное выражение - мощное средство для поиска 
в строках по шаблону. Синтаксис и применение регулярных выражений полностью 
описаны в главе 10. 


См. также 

Глава 10 


КедЕхр.ехес() 

универсальный поиск по шаблону 

Синтаксис 

гедехр. ехес ( строка ) 

Аргументы 

строка Строка, в которой выполняется поиск. 

Возвращаемое значение 

Массив, содержащий результаты поиска или значение пиіі, если соответствия не най¬ 
дено. Формат возвращаемого массива описан далее. 

Исключения 

Ту реЕ г го г Генерируется, если метод вызывается для объекта, не являющегося объ¬ 

ектом Ке&Ехр. 

Описание 

Метод ехес() - наиболее мощный из всех методов объектов РедЕхр и ЗТгіпд для поиска 
по шаблону. Это универсальный метод, использовать который несколько сложнее, 
чем методы РедЕхр. ІезіО, Зігіпд.зеагсИО, Зігіпд. гер1асе() и ЗТгіпд.таТсГі(). 
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Метод ехес() ищет в строке текст, соответствующий выражению гедехр. И если нахо¬ 
дит, то возвращает массив результатов; в противном случае возвращается значение 
пиіі. Элемент 0 полученного массива представляет собою искомый текст. Элемент 1 - 
это текст, соответствующий первому подвыражению в скобках внутри гедехр , если оно 
есть. Элемент 2 соответствует второму подвыражению и т. д. Свойство ІепдІМ массива, 
как обычно, определяет количество элементов в массиве. В дополнение к элементам 
массива и свойству ІепдІІі значение, возвращаемое ехес(), имеет еще два свойства. 
Свойство іпйех указывает позицию первого символа искомого текста. Свойство іприі 
ссылается на строку. Этот возвращаемый массив совпадает с массивом, возвращаемым 
методом Зігіпд.таІсвО, когда он вызывается для неглобального объекта РедЕхр. 

Когда метод ехес() вызывается для неглобального шаблона, он выполняет поиск и воз¬ 
вращает описанный выше результат. Однако если гедехр - глобальное регулярное вы¬ 
ражение, ехес() ведет себя несколько сложнее. Он начинает поиск в строке с символь¬ 
ной позиции, заданной свойством гедехр. ІазІІпсІех. Найдя соответствие, метод уста¬ 
навливает свойство 1аз! Іпйех равным позиции первого символа после найденного соот¬ 
ветствия. Это значит, что ехес() можно вызвать несколько раз, чтобы выполнить цикл 
по всем соответствиям в строке. Если метод ехес() больше не находит соответствий, он 
возвращает значение пиіі и сбрасывает свойство ІазІІпсІех в ноль. Начиная поиск непо¬ 
средственно после успешного нахождения соответствия в другой строке, необходимо 
соблюдать внимательность и вручную установить свойство ІазІІпсІех равным нулю. 

Обратите внимание: ехес() всегда включает полную информацию для найденного со¬ 
ответствия в возвращаемый им массив независимо от того, является гедехр глобаль¬ 
ным шаблоном или нет. Этим ехес() отличается от метода Зігіпд.таІсМО, который воз¬ 
вращает намного меньше информации при работе с глобальными шаблонами. Вызов 
ехес() в цикле - единственный способ получить полную информацию о результатах 
поиска для глобального шаблона. 

Пример 

Для нахождения всех соответствий в строке метод ехес() можно вызывать в цикле: 

ѵаг раііегп = ДЫаѵа\\л/*\Ь/д; 

ѵаг Іехі = "йаѵаЗсгірІ: із тоге ^ип ІІіап йаѵа ог йаѵаВеапз!"; 
ѵаг гезиИ; 

ѵ/Мі1е((гезиіі = раііегп.ехес(1:ех1;)) != пиіі) { 
а1ег1;("МаІісМесІ + гезиЩО] + 

аі розШоп " + гезиіі:. іпсіех + 

пехі зеагсіі Ьедіпз аі розШоп " + раііегп.ІазіІпсіех); 

} 

См. также 

РедЕхр. ІазІІпйех, ВедЕхр.ІезШ, ЗТгіпд.та1:сМ(), Зігіпд.герІасеО, Зігіпд.зеагсІіО; глава 10 

КедЕхр.дІоЬаІ 

выполняется ли глобальный поиск по данному регулярному выражению 

Синтаксис 

гедехр. дІоЬаІ 

Описание 

дІоЬаІ - это логическое свойство объектов РедЕхр, доступное только для чтения. Оно 
указывает, выполняет ли данное регулярное выражение глобальный поиск, т. е. было 
ли оно создано с атрибутом «&». 
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КедЕхр.ідпогеСазе 

чувствительно ли регулярное выражение к регистру 

Синтаксис 

гедехр. ідпогеСазе 

Описание 

ідпогеСазе - это логическое свойство объектов РедЕхр, доступное только для чтения. 
Оно указывает, выполняет ли данное регулярное выражение поиск без учета регист¬ 
ра, т. е. было ли оно создано с атрибутом «і». 

КедЕхр. Іа$1І псіех 

начальная позиция следующего поиска 

Синтаксис 

гедехр. Іазііпйех 

Описание 

Іазііпйех - это доступное для чтения и записи свойство объектов РедЕхр. Для регуляр¬ 
ных выражений с установленным атрибутом «&» оно содержит целое, указывающее 
позицию в строке символа, который следует непосредственно за последним соответст¬ 
вием, найденным с помощью методов РедЕхр.ехес() и РедЕхр. іезіО- Эти методы исполь¬ 
зуют данное свойство в качестве начальной точки при следующем поиске. Благодаря 
этому данные методы можно вызывать повторно для выполнения цикла по всем соот¬ 
ветствиям в строке. Обратите внимание: ІазІІпйех не используется объектами РедЕхр, 
не имеющими атрибута «&» и не представляющими собой глобальные шаблоны. 

Это свойство доступно для чтения и для записи, поэтому можно установить его в лю¬ 
бой момент, чтобы указать, где в целевой строке должен быть начат следующий по¬ 
иск. Методы ехес() и іезіО автоматически сбрасывают свойство Іазііпйех в 0, когда не 
могут найти какого-либо (или следующего) соответствия. Начиная поиск в новой 
строке после успешного поиска в предыдущей, необходимо явно установить это свой¬ 
ство равным 0. 

См. также 

РедЕхр.ехес(), РедЕхр. іезіО 

КедЕхр. $ои гее 

текст регулярного выражения 

Синтаксис 

гедехр. зоигсе 

Описание 

зоигсе - доступное только для чтения строковое свойство объектов РедЕхр, содержа¬ 
щее текст шаблона РедЕхр. Текст не включает ограничивающие символы слэша, ис¬ 
пользуемые в литералах регулярных выражений, а также не включает атрибуты «&», 
«і» и «т». 
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КедЕхр.{е${() 

проверяет, соответствует ли строка шаблону 

Синтаксис 

гедехр . 1: е зі (строка) 

Аргументы 

строка Проверяемая строка. 

Возвращаемое значение 

Возвращает Ігие, если строка содержит текст, соответствующий гедехр , и Еаізе - в про¬ 
тивном случае. 

Исключения 

ТуреЕггог Генерируется, если метод вызывается для объекта, не являющегося 

объектом РедЕхр. 

Описание 

Метод 1ез1() проверяет строку , чтобы увидеть, содержит ли она текст, который соот¬ 
ветствует гедехр . Если да, он возвращает Ігие, в противном случае - ^аізе. Вызов мето¬ 
да 1езт() для регулярного выражения г и передача ему строки 5 эквивалентны сле¬ 
дующему выражению: 

(г.ехес(з) != піііі) 

Пример 

ѵаг раііегп = /іаѵа/і; 

раІІегп.ІезІ(^аѵаЗсгір1:"); // Вернет Ігііе 
раііегп. 1ез1:("ЕСМАЗсгірі"); // Вернет Шзе 

См. также 

РедЕхр.ехес(), РедЕхр.ІазІІпРех, ЗТгіпд.та1:сГі(), Зігіпд.гер1асе(), Зі:гіпд.зиЬз1:гіпд(); гла¬ 
ва 10 

КедЕхрЛо5ігіпд() 

преобразует регулярное выражение в строку переопределяет 0Ь]ес(.Іо$Ігіпд() 

Синтаксис 

гедехр. 1:оЗі:гіпд() 

Возвращаемое значение 

Строковое представление гедехр. 

Исключения 

ТуреЕггог Генерируется, если метод вызывается для объекта, который не явля¬ 

ется объектом РедЕхр. 

Описание 

Метод РедЕхр.То8і:гіпд() возвращает строковое представление регулярного выражения 
в форме литерала регулярного выражения. 
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Обратите внимание: от реализаций не требуется обязательного добавления управ¬ 
ляющих последовательностей, гарантирующих, что возвращаемая строка будет кор¬ 
ректным литералом регулярных выражений. Рассмотрим регулярное выражение, 
созданное с помощью конструкции пелѵ РедЕхр(”/", "д")- Реализация РедЕхрЛоЗігіпдО 
может вернуть для регулярного выражения ///д либо добавить управляющую после¬ 
довательность и вернуть /\//д. 


Бігіпд 

поддержка строк ОЬ]'есі->$ігіпд 

Конструктор 

пеѵі Зі:гіпд(5) // Функция-конструктор 
Зі:гіпд(5) // Функция преобразования 

Аргументы 

5 Значение, подлежащее сохранению в объекте ЗТгіпд или преобразованию в эле¬ 
ментарное строковое значение. 


Возвращаемое значение 

Когда функция ЗігіпдО вызывается в качестве конструктора (с оператором пеѵі), она 
возвращает объект Зігіпд, содержащий строку 5 или строковое представление 5. Кон¬ 
структор ЗігіпдО, вызванный без оператора пеѵі, преобразует 5 в элементарное строко¬ 
вое значение и возвращает преобразованное значение. 


Свойства 

1епд1:Р Количество символов в строке. 


Методы 

сМагАШ 

сМагСос]еА1:() 

сопсаШ 

іпйехОІЧ) 

ІазІІпйехОІЧ) 

1оса1еСотраге() 

таІсМО 

гер1асе() 

зеагсК) 

з1ісе() 

зрт() 

зиЬз1:г() 

зиЬзШпдО 


Извлекает из строки символ, находящийся в указанной позиции. 

Возвращает код символа, находящегося в указанной позиции. 

Выполняет конкатенацию одного или нескольких значений со стро¬ 
кой. 

Выполняет поиск символа или подстроки в строке. 

Выполняет поиск символа или подстроки в строке с конца. 

Сравнивает строки с учетом порядка следования символов нацио¬ 
нальных алфавитов. 

Выполняет поиск по шаблону с помощью регулярного выражения. 

Выполняет операцию поиска и замены с помощью регулярного вы¬ 
ражения. 

Ищет в строке подстроку, соответствующую регулярному выраже¬ 
нию. 

Возвращает фрагмент строки или подстроку в строке. 

Разбивает строку на массив строк по указанной строке-разделителю 
или регулярному выражению. 

Извлекает подстроку из строки. Аналог метода зиЬз1:гіпд(). 
Извлекает подстроку из строки. 
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Зігіпд 


1іоІ_о\л/егСазе() 

ІіоЗіігіпдО 

іоУррегСазеО 

ігітО 

ѵа1ие0і() 


Возвращает копию строки, в которой все символы переведены 
в нижний регистр. 

Возвращает элементарное строковое значение. 

Возвращает копию строки, в которой все символы переведены 
в верхний регистр. 

Возвращает копию строки, из которой удалены все начальные 
и конечные пробельные символы. 

Возвращает элементарное строковое значение. 


Статические методы 

Зігіпд.іготСМагСосІеО 

Создает новую строку, помещая в нее принятые в качестве аргументов коды сим¬ 
волов. 


НТМЬ-методы 

С первых дней создания ^ѵаВсгір! в классе Зігіпд определено несколько методов, ко¬ 
торые возвращают строку, измененную путем добавления к ней НТМЬ-тегов. Эти ме¬ 
тоды никогда не были стандартизованы в ЕСМАВсгірІ, но они позволяют динамиче¬ 
ски генерировать разметку НТМЬ и в клиентских, и в серверных сценариях на языке 
^ѵаВсгірІ. Если вы готовы к использованию нестандартных методов, можете сле¬ 
дующим образом создать разметку НТМЬ для гиперссылки, выделенной полужир¬ 
ным шрифтом красного цвета: 

ѵаг з = "щелкни здесь!"; 

ѵаг Шті = з. Ьо1с1(). 1іпк('^аѵаЗсгіріі:а1егіі( 'Ііеііо')"). іопіісо1ог("гесГ); 

Поскольку эти методы не стандартизованы, для них отсутствуют отдельные справоч¬ 
ные статьи: 

апсі юг(имя) 

ыд() 

Ыіпк() 

Ьо1с1() 
ііхесК) 

ТоиХсоІог(цвет) 

Тог\Хвіт.е(размер) 
іІіаІісзО 
Ііпк (игі) 
зта11() 
зЬг іке() 
зиЬ() 

зир() 

Описание 

Строки - это элементарный тип данных в ^ѵаВсгірІ. Класс Зіігіпд предоставляет ме¬ 
тоды для работы с элементарными строковыми значениями. Свойство ІепдіР объекта 
Зіігіпд указывает количество символов в строке. Класс Зіігіпд определяет немало мето¬ 
дов для работы со строками. Например, имеются методы для извлечения символа или 
подстроки из строки или для поиска символа или подстроки. Обратите внимание: 


Возвращает копию строки в окружении тега <а пате=>. 
Возвращает копию строки в окружении тега <Ьід>. 
Возвращает копию строки в окружении тега <Ыіпк>. 
Возвращает копию строки в окружении тега <Ь>. 
Возвращает копию строки в окружении тега <Ыі>. 
Возвращает копию строки в окружении тега <іоп1і со1ог=>. 
Возвращает копию строки в окружении тега <іопіі зі 2 е=>. 
Возвращает копию строки в окружении тега <і>. 
Возвращает копию строки в окружении тега <а Игеі=>. 
Возвращает копию строки в окружении тега <зта11>. 
Возвращает копию строки в окружении тега <зЫ іке>. 
Возвращает копию строки в окружении тега <зиЬ>. 
Возвращает копию строки в окружении тега <зир>. 
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строки ^ѵаВсгір! не изменяются - ни один из методов, определенных в классе Зігіпд, 
не позволяет изменять содержимое строки. Зато методы, подобные Зіігіпд .^оІІррегСазеС ), 
возвращают абсолютно новую строку, не изменяя исходную. 

В ЕСМАЗсгірІ 5 и во многих реализациях ^ѵаЗсгірІ, вышедших до Е85, строки ве¬ 
дут себя как массивы символов, доступные только для чтения. Например, чтобы из¬ 
влечь третий символ из строки з, можно написать з[2] вместо з.сИагА1:(2). Кроме того, 
инструкция І'ог/іп, примененная к строке, позволяет перечислить индексы массива 
для каждого символа в строке. 

См. также 

Глава 3 

5*гтд.сНагА1() 

возвращает п-й символ строки 

Синтаксис 

строка, с МагА1:( п) 

Аргументы 

п Индекс символа, который должен быть извлечен из строки. 

Возвращаемое значение 

п -й символ строки. 

Описание 

Метод Зігіпд.сИа гА1:() возвращает п -й символ строки. Номер первого символа в строке 
равен нулю. Если п не находится между 0 и строка. ІепдІИ-1, этот метод возвращает пус¬ 
тую строку. Обратите внимание: в ^ѵаЗсгір! нет символьного типа данных, отлично¬ 
го от строкового, поэтому извлеченный символ представляет собой строку длиной 1. 

См. также 

Зі:гіпд.сІзагСос1еА1:(), Зігіпд.іпсІехОЮ, Зігіпд . 1аз1:Іпс1ехОГ( ) 

5ігіпд.сНагСосІеАі() 

возвращает код п-го символа строки 

Синтаксис 

с трока. с И а г С осі еАі ( п) 

Аргументы 

п Индекс символа, код которого должен быть получен. 

Возвращаемое значение 

Код Юникода п-го символа в строке - 16-разрядное целое между 0 и 65 535. 

Описание 

Метод сИагСос1еА1:() аналогичен методу сИагАіО, за исключением того, что возвращает 
код символа, находящегося в определенной позиции, а не подстроку, содержащую 
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сам символ. Если значение п отрицательно либо меньше или равно длине строки, 
сИагСос1еА1:() возвращает 

Создание строки по коду Юникода символа описано в справочной статье Зіігіпд.ітот- 
СМагСос1е(). 

См. также 

ЗТгіпд .сИагА1:(), Зіігіпд.ІтотСИагСосІеО 

5ігіпд.сопсаі() 

объединяет строки 

Синтаксис 

строка.сопсаТ(значение, ...) 

Аргументы 

значение, Одно или более значений, объединяемых со строкой. 

Возвращаемое значение 

Новая строка, полученная при объединении всех аргументов со строкой. 

Описание 

сопса1:() преобразует все свои аргументы в строки (если это нужно) и добавляет их по 
порядку в конец строки . Возвращает полученную объединенную строку. Обратите 
внимание: сама строка при этом не изменяется. 

Метод ЗТгіпд .сопса1:() представляет собой аналог метода Аггау.сопса1:(). Следует отме¬ 
тить, что конкатенацию строк часто проще выполнить с помощью оператора +. 

См. также 

Аггау.сопсаШ 

5ігіпд.{готСНагСосІе() 

создает строку из кодов символов 

Синтаксис 

Зіігіпд.-ГготСИагСосІ е(с7, с2, ...) 

Аргументы 

сі, с2, ... Ноль или более целых значений, определяющих коды Юникода для 

символов создаваемой строки. 

Возвращаемое значение 

Новая строка, содержащая символы с указанными кодами. 

Описание 

Этот статический метод обеспечивает создание строки из отдельных числовых кодов 
Юникода ее символов, заданных в качестве аргументов. Следует заметить, что стати¬ 
ческий метод 1тотСИагСос1е() является свойством конструктора Зі:гіпд() и фактически 
не является строковым методом или методом объектов Зіігіпд. 
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Парным для описываемого метода является метод экземпляра Зіігіпд . сИагСос!еА1:(), ко¬ 
торый служит для получения кодов отдельных символов строки. 

Пример 

// Создать строку "Ьеііо" 

ѵаг з = 31: гіпд . готСІтагСос1е( 104, 101, 108, 108, 111); 

См. также 

8Шпд.с0агСос1еА1:() 

Зігіпд.іпсІехОД) 

поиск подстроки в строке 

Синтаксис 

строка. іпсІехОІ 1 (подстрока) 
строка. іпбехОТ(подстрока, начало) 

Аргументы 

подстрока Подстрока, которая должна быть найдена в строке. 

начало Необязательный целый аргумент, задающий позицию в строке, с которой 
следует начать поиск. Допустимые значения от 0 (позиция первого симво¬ 
ла в строке) до строка. ІепдТГі-1 (позиция последнего символа в строке). Если 
этот аргумент отсутствует, поиск начинается с первого символа строки. 

Возвращаемое значение 

Позиция первого вхождения подстроки в строку, , начиная с позиции начало , если под¬ 
строка найдена, или -1, если не найдена. 

Описание 

ЗТгіпд. іпс!ех01 : ( ) выполняет поиск в строке от начала к концу, чтобы увидеть, содержит 
ли она искомую подстроку. Поиск начинается с позиции начало в строке или с начала 
строки, если аргумент начало не указан. Если подстрока найдена, Зіігіпд . іпс!ех01 : ( ) воз¬ 
вращает позицию первого символа первого вхождения подстроки в строку. Позиции 
символов в строке нумеруются с нуля. 

Если подстрока в строке не найдена, Зіігіпд.іпс1ех0і( ) возвращает -1. 

См. также 

Зіігіпд. сИагАіО, Зіігіпд.ІазіІпсІехОІЧ), Зігіпд.зиІэзІігіпдО 

Зігіпд.ІазІІпсІехОД) 

поиск подстроки в строке, начиная с конца 

Синтаксис 

строка. ІазіІпсІехОі (подстрока) 
строка. ІазіІпсІехОі (подстрока, начало) 

Аргументы 

подстрока Подстрока, которая должна быть найдена в строке. 





Бігіпд.ІепдіЬ 


867 


начало Необязательный целый аргумент, задающий позицию в строке, с которой 
следует начать поиск. Допустимые значения: от 0 (позиция первого символа 
в строке) до строка. Іепді^-І (позиция последнего символа в строке). Если этот 
аргумент отсутствует, поиск начинается с последнего символа строки. 

Возвращаемое значение 

Позиция последнего вхождения подстроки в строку, начиная с позиции начало , если 
подстрока найдена, или -1, если такое вхождение не найдено. 

Описание 

Зіігіпд. ІазІіІпсІехОІЧ) просматривает строку от конца к началу, чтобы увидеть, содер¬ 
жит ли она подстроку. Поиск выполняется с позиции начало внутри строки или с конца 
строки , если аргумент начало не указан. Если подстрока найдена, Зіігіпд.ІазІіІпсІехОіО 
возвращает позицию первого символа этого вхождения. Метод выполняет поиск от 
конца к началу, поэтому ііервое найденное вхождение является последним в строке, 
расположенным до позиции начало. 

Если подстрока не найдена, Зіігіпд. ІазІіІпсІехОІЧ) возвращает -1. 

Обратите внимание: хотя метод Зіігіпд. ІазІіІпсІехО^С ) ищет строку от конца к началу, он 
все равно нумерует позиции символов в строке с начала. Первый символ строки зани¬ 
мает позицию с номером 0, а последний - строка. ІепдіМ-1. 

См. также 

Зіігіпд. сИагАШ, Зіігіпд. іпсІехОШ» Зіігіпд.зиЬзІігіпдО 

Зігіпд.ІепдіН 

длина строки 

Синтаксис 

строка. ІепдіИ 

Описание 

Свойство Зіігіпд . ІепдТИ - это доступное только для чтения целое, указывающее коли¬ 
чество символов в строке. Для любой строки з индекс последнего символа равен 
з.іепдііѵі. Свойство Іепдііі строки не перечисляется циклом ^ог/іп и не может быть 
удалено с помощью оператора сіеіеііе. 

$Ігіпд.ІосаІеСотраге() 

сравнивает строки с учетом порядка следования символов национальных алфавитов 

Синтаксис 

с трока . 1 о с а 1 е С о т ра ге ( целевая_ с трока) 

Аргументы 

целевая_строка 

Строка, сравниваемая со строкой с учетом порядка следования символов нацио¬ 
нальных алфавитов. 
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Возвращаемое значение 

Число, обозначающее результат сравнения. Если строка «меньше» целевой_строки , 1о- 
са1еСотраге() возвращает отрицательное число. Если строка «больше» целевой_строки % 
метод возвращает положительное число. Если строки идентичны или неразличимы 
в соответствии с региональными соглашениями о сортировке, метод возвращает 0. 

Описание 

Когда к строкам применяются операторы < и >, сравнение выполняется только по ко¬ 
дам Юникода этих символов; порядок сортировки, принятый в текущем регионе, не 
учитывается. Сортировка, выполняемая подобным образом, не всегда оказывается 
верной. Возьмем, например, испанский язык, в котором буквы «сЬ» традиционно сор¬ 
тируются как одна буква, расположенная между буквами «с» и «б». 

Метод 1оса1еСотраге() служит для сравнения строк с учетом порядка сортировки, по 
умолчанию определяемого региональными настройками. Стандарт ЕСМАВсгірі не 
определяет, как должно выполняться сравнение с учетом региона; в нем просто ука¬ 
зано, что эта функция руководствуется порядком сортировки, определенным опера¬ 
ционной системой. 

Пример 

Отсортировать массив строк в порядке, учитывающем региональные параметры, 
можно следующим образом: 

ѵаг зігіпдз; // Сортируемый массив строк; инициализируется в другом месте 
зігіпдз. зоПС^цпсИопСа,Ь) { геііігп а.ІосаІеСотраге(Ь) }); 

5ігіпд.та1сН() 

находит одно или более соответствий регулярному выражению 

Синтаксис 

строка, таііс гедехр) 

Аргументы 

гедехр Объект ПедЕхр, задающий шаблон для поиска. Если этот аргумент не явля¬ 
ется объектом ПедЕхр, он сначала преобразуется с помощью конструктора 
ПедЕхр(). 

Возвращаемое значение 

Массив, содержащий результаты поиска. Содержимое массива зависит от того, уста¬ 
новлен ли в гедехр глобальный атрибут «&». Далее это возвращаемое значение описано 
подробно. 

Описание 

Метод таісИО ищет в строке соответствия шаблону, определяемому выражением 
гедехр. Поведение этого метода существенно зависит от того, установлен атрибут «&» 
в гедехр или нет (регулярные выражения подробно рассмотрены в главе 10). 

Если в гедехр нет атрибута «&», та1:сН() ищет одно соответствие в строке. Если соответ¬ 
ствие не найдено, та1:сИ() возвращает пиіі. В противном случае метод возвращает мас¬ 
сив, содержащий информацию о найденном соответствии. Элемент массива с индек¬ 
сом 0 содержит найденный текст. Оставшиеся элементы содержат текст, соответст¬ 
вующий всем подвыражениям внутри регулярного выражения. В дополнение к этим 
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обычным элементам массива возвращаемый массив имеет еще два объектных свойст¬ 
ва. Свойство іпсіех массива указывает позицию начала найденного текста внутри стро¬ 
ки. Кроме того, свойство іприі возвращаемого массива содержит ссылку на саму строку. 

Если в гедехр установлен флаг «&», таісН() выполняет глобальный поиск, находя 
в строке все соответствующие подстроки. Метод возвращает гіиіі, если соответствие не 
найдено, или массив, если найдено одно и более соответствий. Однако содержимое по¬ 
лученного массива при глобальном поиске существенно отличается. В этом случае 
элементы массива содержат все подстроки, найденные в строке , а сам массив не имеет 
свойств іпсіех и іприі. Обратите внимание: для глобального поиска таісН() не предос¬ 
тавляет информации о подвыражениях в скобках и не указывает, в каком месте стро¬ 
ки было найдено каждое из соответствий. Эту информацию для глобального поиска 
можно получить методом ВедЕхр. ехес(). 

Пример 

Следующий фрагмент реализует глобальный поиск и находит все числа в строке: 

"1 ріиз 2 едиаіз 3". таІісИ (/\с!+/д) // Вернет ["1", "2", "3”] 

Следующий фрагмент реализует неглобальный поиск и использует более сложное ре¬ 
гулярное выражение с несколькими подвыражениями. Он находит ШІЬ-адрес, а под¬ 
выражения регулярного выражения соответствуют протоколу, хосту и пути в ІІКЬ: 

ѵаг игі = /(\\ѵ+) :\Д/([\\л/. ]+)\/(\5*)/; 

ѵаг іехі = "Ѵізіі ту Поте раде аі Піір://\мм. ізр.сот/~с1аѵіс1"; 
ѵаг гезиіі = іехі.таісП(игІ); 
іі (гезиіі != пиіі) { 

ѵаг іиііигі = гезиіі[0]; // Содержит "Ніір://ѵлім. ізр. сот/~с!аѵісГ 

ѵаг ргоіосоі = гези1і[1]; // Содержит "Піір" 

ѵаг Позі = гези1і[2]; // Содержит "шм. ізр. сот" 

ѵаг раіП = гези1і[3]; // Содержит ""сІаѵісГ 

} 

См. также 

ВедЕхр, ВедЕхр.ехес(), ВедЕхр.іезі(), 8ігіпд.гер1асе(), 8ігіпд.зеагсП(); глава 10 

5ігіпд.герІасе() 

заменяет подстроку (подстроки), соответствующую регулярному выражению 

Синтаксис 

строка. гер1асе(гедехр, замена) 

Аргументы 

гедехр Объект ВедЕхр, определяющий шаблон заменяемой подстроки. Если этот ар¬ 
гумент представляет собой строку, то она выступает в качестве текстового 
шаблона для поиска и не преобразуется в объект ВедЕхр. 

замена Строка, определяющая текст замены, или функция, вызываемая для гене¬ 
рации текста замены. Подробности см. в подразделе «Описание». 

Возвращаемое значение 

Новая строка, в которой первое или все соответствия регулярному выражению гедехр 
заменены строкой замена. 
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Описание 

Метод гер1асе() выполняет операцию поиска и замены для строки. Он ищет в строке 
одну или несколько подстрок, соответствующих регулярному выражению гедехр , и за* 
меняет их значением аргумента замена. Если в гедехр указан глобальный атрибут «&», 
гер1асе() заменяет все найденные подстроки. В противном случае метод заменяет 
только первую найденную подстроку. 

Параметр замена может быть либо строкой, либо функцией. Если это строка, то каж¬ 
дое найденное соответствие заменяется указанной строкой. Имейте в виду, что сим¬ 
вол $ имеет особый смысл в строке замена. Как показано в следующей таблице, он по¬ 
казывает, что для замены используется строка, производная от найденного соответ¬ 
ствия. 


Символы 

Замена 

$1, $2,.... $99 

Текст, соответствующий подвыражению с номером от 1 до 99 внутри ре¬ 
гулярного выражения гедехр 

$& 

Подстрока, соответствующая гедехр 

$' 

Текст слева от найденной подстроки 

$• 

Текст справа от найденной подстроки 

$$ 

Символ доллара 


В стандарте ЕСМАВсгірІ ѵЗ определено, что аргумент замена метода гер1асе() может 
быть функцией, а не строкой. В этом случае функция будет вызываться для каждого 
найденного соответствия, а возвращаемая ею строка будет использоваться в качестве 
текста для замены. Первый аргумент, передаваемый функции, представляет собой 
строку, соответствующую шаблону. Следующие за ним аргументы - это строки, соот¬ 
ветствующие любым подвыражениям внутри шаблона. Таких аргументов может 
быть ноль или более. Следующий аргумент - это целое, указывающее позицию внут¬ 
ри строки, в которой было найдено соответствие, а последний аргумент функции за¬ 
мена - это сама строка. 

Пример 

Обеспечение правильного регистра букв в слове « ^ѵаВсгірІ»: 

Іехі. герІасеСДІаѵаЗсгіріі/і, ’^аѵаЗсгірі:"); 

Преобразование имени из формата «Бое, «ІоЬп» в формат « «ІоЬп Бое»: 

пате. гер1асе(/(\\л/+)\з*Лз*(\м+)/, ”$2 $1"); 

Замена всех двойных кавычек двумя одинарными закрывающими и двумя одинар¬ 
ными открывающими кавычками: 

Іехі. гер1асе(/"(Г"]*)7д. *$1‘ 

Перевод первых букв всех слов в строке в верхний регистр: 

Іехі. гер1асе(ДЬ\\л/+\Ь/д, ^ипсіііоп(\ѵогсі ) { 

геііигп ѵ\/огс1.зиЬзІ:гіпд(0,1). 1:оиррегСазе() + 
мэтр. зиЬзІгіпдО); 

}); 


См. также 

ВедЕхр, ПедЕхр.ехесО, ПедЕхр.ІіезІіО, Зіігіпд.та1:сП(), Зі:гіпд.зеагсИ(); глава 10 
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5ігіпд.$еагсН() 

поиск соответствия регулярному выражению 

Синтаксис 

строка, зеагс и(гедехр) 

Аргументы 

гедехр Объект РедЕхр, определяющий шаблон, который будет использоваться для 
поиска в строке. Если этот аргумент не является объектом РедЕхр, он сначала 
преобразуется путем передачи его конструктору РедЕхр(). 

Возвращаемое значение 

Позиция начала первой подстроки в строке , соответствующей выражению гедехр , или 
-1, если соответствие не найдено. 

Описание 

Метод зеагсИО ищет подстроку в строке , соответствующую регулярному выражению 
гедехр , и возвращает позицию первого символа найденной подстроки или -1, если со¬ 
ответствие не найдено. 

Метод не выполняет глобального поиска, игнорируя флаг «&». Он также игнорирует 
свойство гедехр. Іазіііпсіех и всегда выполняет поиск с начала строки, следовательно, 
всегда возвращает позицию первого соответствия, найденного в строке. 

Пример 

ѵаг з = '^аѵаЗсгірІ; із -Тип”; 
з. зеагсІі(/зсгір1:/і) // Вернет 4 
з.зеагсМ(/а(.)а/) // Вернет 1 

См. также 

РедЕхр, РедЕхр.ехес(), РедЕхр. 1:ез1:(), ЗТгіпд .та1:сП(), Зіігіпд. гер1асе(); глава 10 

$ігіпд.$Іісе() 

извлечение подстроки 

Синтаксис 

строка. 5Іісе(начало, конец) 

Аргументы 

начало Индекс в строке, с которого должен начинаться фрагмент. Если этот аргу¬ 
мент отрицателен, он обозначает позицию, измеряемую от конца строки. То 
есть -1 соответствует последнему символу, -2 - второму с конца и т. д. 

конец Индекс символа исходной строки непосредственно после конца извлекаемо¬ 
го фрагмента. Если он не указан, фрагмент включает все символы от пози¬ 
ции начало до конца строки. Если этот аргумент отрицателен, он обозначает 
позицию, отсчитываемую от конца строки. 

Возвращаемое значение 

Новая строка, которая содержит все символы строки , начиная с символа в позиции на¬ 
чало (и включая его) и заканчивая символом в позиции конец (но не включая его). 
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Описание 

Метод з1ісе() возвращает строку, содержащую фрагмент, или подстроку строки , но не 
изменяет строку. 

Методы з1ісе(), зиЬзіігіпдО и признанный устаревшим метод зиЬз1іг() объекта Зігіпд 
возвращают части строки. Метод зі ісе( ) более гибок, чем зиЬз1ігіпд( ), поскольку допус¬ 
кает отрицательные значения аргументов. Метод з1ісе() отличается от зиЬзігО тем, 
что задает подстроку с помощью двух символьных позиций, а зиЬз1іг( ) использует одно 
значение позиции и длину. Кроме того, Зіігіпд.з1ісе() является аналогом Аггау.з1ісе(). 


Пример 


ѵаг з = "аЬссІе^д'' ; 


з. з1ісе(0, 4) 

// Вернет 

"аЬссГ 

з. з1ісе( 2,4) 

// Вернет 

"ссГ 

з. з1ісе(4) 

// Вернет 

"еід" 

з. з1ісе(3,-1) 

// Вернет 

"Реі" 

з.з1ісе(3,-2) 

// Вернет 

"Ре" 

з.з!ісе(-3,-1) 

// Должен 

вернуть 


\ 


в ІЕ 4 возвращает "аЬссІеі" 


Ошибки 

Отрицательные значения в аргументе начало не работают в Іпіегпеі Ехріогег 4 (в более 
поздних версиях Іпіегпеі Ехріогег эта ошибка исправлена). Они обозначают не сим¬ 
вольную позицию, отсчитываемую от конца строки, а позицию 0. 

См. также 

Аггау.зІісеО, Зіігіпд.зиІэз1:гіпд() 

5ігіпд.$рІі1() 

разбивает строку на массив строк 

Синтаксис 

строка.разделитель, лимит) 

Аргументы 

разделитель Строка или регулярное выражение, по которому разбивается строка. 

лимит Необязательное целое, определяющее максимальную длину получен¬ 

ного массива. Если этот аргумент указан, то количество возвращен¬ 
ных подстрок не будет превышать указанное. Если он не указан, раз¬ 
бивается вся строка независимо от ее длины. 

Возвращаемое значение 

Массив строк, создаваемый путем разбиения строки на подстроки по границам, за¬ 
данным разделителем. Подстроки в возвращаемом массиве не включают сам раздели¬ 
тель, кроме описываемого далее случая. 

Описание 

Метод зрІііО создает и возвращает массив подстрок указанной строки , причем размер 
возвращаемого массива не превышает указанный лимит. Эти подстроки создаются пу¬ 
тем поиска текста, соответствующего разделителю, в строке от начала до конца и раз¬ 
биения строки до и после найденного текста. Ограничивающий текст не включается 
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ни в одну из возвращаемых строк, кроме случая, описываемого далее. Следует отме¬ 
тить, что, если разделитель соответствует началу строки, первый элемент возвращае¬ 
мого массива будет пустой строкой - текстом, присутствующим перед разделителем. 
Аналогично, если разделитель соответствует концу строки, последний элемент мас¬ 
сива (если это не противоречит значению аргумента лимит) будет пустой строкой. 

Если разделитель не указан, строка вообще не разбивается и возвращаемый массив со¬ 
держит только один строковый элемент, представляющий собой строку целиком. Ес¬ 
ли разделитель представляет собой пустую строку или регулярное выражение, соот¬ 
ветствующее пустой строке, то строка разбивается между каждыми двумя соседними 
символами, а возвращаемый массив имеет ту же длину, что и исходная строка, если 
не указан меньший лимит. (Это особый случай, поскольку пустая строка перед первым 
и за последним символами отсутствует.) 

Ранее отмечалось, что подстроки в массиве, возвращаемом описываемым методом, не 
содержат текст разделителя, использованного для разбиения строки. Однако если 
разделитель - это регулярное выражение, содержащее подвыражения в скобках, то 
подстроки, соответствующие этим подвыражениям (но не текст, соответствующий ре¬ 
гулярному выражению в целом), включаются в возвращаемый массив. 

Метод 8ігіпд.$рШ() является обратным методу Аггауооіп(). 

Пример 

Метод $рШ() наиболее полезен при работе с сильно структурированными строками: 

' 1:2:3:4:5". зрііі: // Вернет ["1", "2", "3". "4”, "5"] 

■'|а|Ь|с|".5рт("Г ); // Вернет "а", "Ь", "с", ""] 

Еще одно распространенное применение метода зрШ() состоит в разбиении команд 
и других подобных строк на слова, разделенные пробелами: 

ѵаг могРз = зеггЕепсе. зрііі: (' '); 

Проще разбить строку на слова, используя в качестве разделителя регулярное выра¬ 
жение: 

ѵаг \ѵогРз = зепЕепсе. зрііі: (/\з+/): 

Чтобы разбить строку на массив символов, возьмите в качестве разделителя пустую 
строку. Если требуется разбить на массив символов только часть строки, задайте ар¬ 
гумент лимит: 

"РеПо". зрШ// Возвращает ["И", "е", "1", "1", "о"] 

"РеПо".зрШ("", 3); // Возвращает ["Р","е","1"] 

Если необходимо, чтобы разделители или одна и более частей разделителя были 
включены в результирующий массив, напишите регулярное выражение с подвыра¬ 
жениями в скобках. Так, следующий код разбивает строку по НТМЬ-тегам и включа¬ 
ет эти теги в результирующий массив: 

ѵаг іехі: = "РеПо <Ь>\л/ог1сК/Ь>”; 

ІехП зрШ(/(<[">]*>)/); // Вернет ["РеПо ", "<Ь>", "могІсГ, "</Ь>",""] 

См. также 

Аггауооіп(), ПедЕхр; глава 10 
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51гіпд.5иЬ5Іг() устарел 

извлекает подстроку 

4 

Синтаксис 

строка. зііЬзіі г (начало, длина) 

Аргументы 

начало Начальная позиция подстроки. Если аргумент отрицателен, он обозначает 
позицию, измеряемую от конца строки: -1 обозначает последний символ, -2 - 
второй символ с конца и т. д. 

длина Количество символов в подстроке. Если этот аргумент отсутствует, возвра¬ 
щаемая строка включает все символы от начальной позиции до конца строки. 

Возвращаемое значение 

Копия фрагмента строки, начиная с символа, находящегося в позиции начало (вклю¬ 
чительно); имеет длину, равную аргументу длина , или заканчивается концом строки, 
если длина не указана. 

Описание 

Метод зиЬзі: г() извлекает и возвращает подстроку строки, но не изменяет строку. 

Обратите внимание: метод зиЬзііг( ) задает нужную подстроку с помощью позиции сим¬ 
вола и длины. Благодаря этому появляется удобная альтернатива методам Зіігіпд. зиЬ- 
зі:гіпд() и Зіігіпд. зр1ісе( ), в которых подстрока задается двумя символьными позиция¬ 
ми. При этом следует отметить, что метод не стандартизован в ЕСМАБсгірі и, следо¬ 
вательно, считается устаревшим. 

Пример 

ѵаг з = "аЬсРеід"; 

з. зиЬзі: г(2, 2); // Вернет "ссГ 

з. зиЬзі: г(3); // Вернет "Реід" 

з. зиЬзі: г(-3,2); // Должен вернуть "еі"; в ІЕ 4 возвращает "аЬ" 

Ошибки 

Отрицательные значения аргумента начало не работают в ІЕ 4 (в более поздних верси¬ 
ях ІЕ эта ошибка исправлена). Они задают не позицию символа, отсчитываемую от 
конца строки, а позицию 0. 

См. также 

Зіігіпд.з1ісе(), Зіігіпд. зиЬзіігіпдО 

51гіпд.$иЬ$1гіпд() 

возвращает подстроку строки 

Синтаксис 

строка. зиЬзігіпдСот, до) 

Аргументы 

от Целое, задающее позицию первого символа требуемой подстроки внутри 

строки. 
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до Необязательное целое, на единицу большее позиции последнего символа тре¬ 

буемой подстроки. Если этот аргумент опущен, возвращаемая подстрока за¬ 
канчивается в конце строки. * ^ 

Возвращаемое значение 

Новая строка длиной до - от , содержащая подстроку строки. Новая строка содержит 
символы, скопированные из строки , начиная с позиции от и заканчивая позицией до-1. 

Описание 

Метод Зігіпд.зиЬзІгіпдО возвращает подстроку строки, содержащую символы между 
позициями от и до. Символ в позиции от включается в подстроку, а символ в позиции 
до не включается. 

Если от равно до, метод возвращает пустую строку (длиной 0). Если от больше до, ме¬ 
тод сначала меняет два аргумента местами, а затем возвращает строку между ними. 

Помните, что символ в позиции от включается в подстроку, а символ в позиции до 
в нее не включается. Может показаться, что это поведение взято «с потолка» и нело¬ 
гично, но особенность такой системы состоит в том, что длина возвращаемой подстро¬ 
ки всегда равна до-от. 

Обратите внимание: для извлечения подстрок из строки также могут использоваться 
метод Зі:гіпд.з1ісе() и нестандартный метод Зігіпд.зиЬз1:г(). В отличие от этих мето¬ 
дов, Зігіпд.зиЬзІгіпдО не может принимать отрицательные значения аргументов. 

См. также 

ЗТгіпд .сМагА1:(), ЗТгіпд . Іпс1ех0^( ), Зігіпд.ІазІіІпсІехО^О, ЗТгіпд . з1ісе(), ЗТгіпд.зиЬз1:г() 

З'Ігіпд.ІоІ.осаІеІоѵѵегСазеО 

преобразует символы строки в нижний регистр 

Синтаксис 

строка. 1:оІ_оса1еІ_оѵ\/егСа5е() 

Возвращаемое значение 

Копия строки , преобразованная в нижний регистр с учетом региональных парамет¬ 
ров. Только немногие языки, такие как турецкий, имеют специфические для региона 
соответствия регистров, поэтому данный метод обычно возвращает то же значение, 
что и метод 1:оІ_оѵ\/егСа5е(). 

См. также 

Зігіпд.і:оІ_оса1еІІррегСа5е(), ЗТгіпд .То1о\л/егСазе(), ЗТгіпд.ТоІІррегСазеС ) 

ЗІгіпд.ІоІ-осаІеІІррегСазеО 

преобразует символы строки в верхний регистр 

Синтаксис 

строка. ІоІ_оса1еІІррегСазе( ) 

Возвращаемое значение 

Копия строки , преобразованная в верхний регистр с учетом региональных парамет¬ 
ров. Лишь немногие языки, такие как турецкий, имеют специфические для региона 
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соответствия регистров, поэтому данный метод обычно возвращает то же значение, 
что и метод іоІІррегСазеО. 

См. также 

Зігіпд.1:оІ_оса1еІ_оѵ\/егСа5е(), ЗТгіпд .То1о\л/егСазе(), Зіігіпд.іоІІррегСазеО 

5Ыпд.*оІ_оѵѵегСа5е() 

преобразует символы строки в нижний регистр 

Синтаксис 

строка. іоІ-сжегСазе () 

Возвращаемое значение 

Копия строки , в которой все символы верхнего регистра преобразованы в эквивалент¬ 
ные им символы нижнего регистра, если такие имеются. 

5ігіпд.іо5ігіпд() 

возвращает строку переопределяет 0Ь]есІ.Іо51гіпд() 

Синтаксис 

строка. іоЗіігіпд () 

Возвращаемое значение 

Элементарное строковое значение строки. Вызов этого метода требуется редко. 

Исключения 

ТуреЕггог Генерируется, если метод вызывается для объекта, не являющегося 

объектом Зіігіпд. 


См. также 

Зіігіпд. ѵа1ие0і() 

51ппд.1оУррегСа$е() 

преобразует символы строки в верхний регистр 

Синтаксис 

строках оІІррегСазеО 

Возвращаемое значение 

Копия строки , в которой все символы нижнего регистра преобразованы в эквивалент¬ 
ные им символы верхнего регистра, если такие имеются. 

Зігіпд.ІгітО ЕСМА5сгір* 5 

удаляет начальные и конечные пробельные символы 


Синтаксис 

строках гіт() 




5*гіпд.ѵаІиеОЮ 
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Возвращаемое значение 

Копия строки , из которой удалены все начальные и конечные пробельные символы. 

См. также 

Зіігіпд.герІасеО 

5ігіпд.ѵаІиеО{() 

возвращает строку переопределяет 0Ь]ес1.ѵаІие0{() 

Синтаксис 

строка. ѵа1иеОЕ() 

Возвращаемое значение 

Элементарное строковое значение строки. 

Исключения 

Ту реЕг го г Генерируется, если метод вызывается для объекта, не являющегося объ¬ 

ектом Зіігіпд. 

См. также 

ЗТгіпд.ТоЗТгіпдС) 

ЗупІахЕггог 

свидетельствует о синтаксической ошибке ОЬ]ес(—>Еггог—>5уп(ахЕггог 

Конструктор 

пеѵу/ 5уп1іахЕггог() 

пеѵу/ ЗупІахЕггог (сообщение) 

Аргументы 

сообщение Необязательное сообщение об ошибке, предоставляющее дополнитель¬ 
ную информацию об исключении. Если этот аргумент указан, он высту¬ 
пает в качестве значения свойства теззаде объекта ЗупІіахЕггог. 

Возвращаемое значение 

Вновь созданный объект ЗупІіахЕггог. Если указан аргумент сообщение , объект Зупіах- 
Еггог берет его в качестве значения своего свойства теззаде; в противном случае в каче¬ 
стве значения этого свойства он берет строку по умолчанию, определенную в реализа¬ 
ции. Конструктор ЗупІахЕггогО, вызванный как функция (без оператора пем), ведет 
себя так же, как если бы он был вызван с оператором п еѵі. 

Свойства 

теззаде Сообщение об ошибке, предоставляющее дополнительную информацию 

об исключении. Это свойство содержит строку, переданную конструкто¬ 
ру, или строку по умолчанию, определенную в реализации. Подробно¬ 
сти см. в справочной статье Еггог.теззаде. 

пате Строка, определяющая тип исключения. Все объекты ЗупІіахЕггог насле¬ 

дуют для этого свойства строку «ЗупіахЕггог». 
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Описание 

Экземпляр класса ЗупііахЕггог сигнализирует о синтаксической ошибке в программ¬ 
ном коде. Метод еѵа1( ), а также конструкторы РипсІіоп()иПедЕхр() могут генерировать 
исключения этого типа. Подробности о генерации и перехвате исключений см. в спра¬ 
вочной статье Еггог. 

См. также 

Еггог, Еггог.теззаде, Еггог.пате 

ТуреЕггог 

генерируется, когда значение имеет неверный тип ОЬ]ес(—> Еггог—>Ту ре Еггог 

Конструктор 

пеѵ/ ТуреЕггог() 

пеѵу/ ТуреЕггог (сообщение) 

Аргументы 

сообщение Необязательное сообщение об ошибке, предоставляющее дополнитель¬ 
ную информацию об исключении. Если этот аргумент указан, он вы¬ 
ступает в качестве значения свойства теззаде объекта ТуреЕггог. 

Возвращаемое значение 

Вновь созданный объект ТуреЕггог. Если указан аргумент сообщение , объект ТуреЕггог 
берет его в качестве значения своего свойства теззаде; в противном случае в качестве 
значения этого свойства он берет строку по умолчанию, определенную в реализации. 
Конструктор ТуреЕггог(), вызванный как функция (без оператора пем), ведет себя так 
же, как если бы он был вызван с оператором пеѵ/. 

Свойства 

теззаде Сообщение об ошибке, содержащее дополнительную информацию об исклю¬ 
чении. Это свойство содержит строку, переданную конструктору, или строку 
по умолчанию, определенную в реализации. Подробности см. в справочной 
статье Еггог.теззаде. 

пате Строка, определяющая тип исключения. Все объекты ТуреЕггог наследуют 
для этого свойства строку «ТуреЕггог». 

Описание 

Экземпляр класса ТуреЕггог создается, когда значение имеет не тот тип, который ожи¬ 
дается. Такое чаще всего происходит при попытке обратиться к свойству піііі или 
к неопределенному значению объекта. Это исключение может также возникнуть, ес¬ 
ли вызван метод, определенный одним классом, для объекта, являющегося экземп¬ 
ляром какого-либо другого класса, или если оператору пеѵ/ передается значение, не 
являющееся функцией-конструктором. Реализациям ЛѵаВсгірі также разрешено 
создавать объекты ТуреЕггог, когда встроенная функция или метод вызывается с боль¬ 
шим числом аргументов, чем ожидается. Генерация и перехват исключений подробно 
рассмотрены в справочной статье Еггог. 

См. также 

Еггог, Еггог.теззаде, Еггог.пате 
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ипсіеііпесі 

неопределенное значение 

Синтаксис 

ипсІеТіпес! 

Описание 

ипсІеЕіпесІ - это глобальное свойство, хранящее значение ипсІе'ГіпесІ. Это то же самое 
значение, которое возвращается при попытке прочитать значение несуществующего 
свойства объекта. Свойство ипсІе'ГіпесІ не перечисляется циклами Еог/іп и не может 
быть удалено оператором сіеіеіе. Однако ипсіеЕіпесі не является константой и может 
быть установлено равным любому другому значению, но лучше этого не делать. 

Чтобы проверить, является ли значение неопределенным (ипсіеЕіпесІ), следует исполь¬ 
зовать оператор ===, поскольку оператор == считает значение ипс!е1 = іпес1 равным значе¬ 
нию пиіі. 

ипе$саре() устарело 

декодирует строку с управляющими последовательностями 

Синтаксис 

ипе$саре(5) 

Аргументы 

5 Декодируемая строка. 

Возвращаемое значение 

Декодированная копия 5. 

Описание 

ипезсаре( ) - это глобальная функция, декодирующая строку, закодированную с помо¬ 
щью функции езсаре(). Декодирование строки 5 происходит путем поиска и замены 
последовательности символов в формате %хх и %ихххх (где х - шестнадцатеричная циф¬ 
ра) символами Юникода \и00хх и \ихххх. 

Несмотря на то что функция ипезсаре( ) была стандартизована в первой версии ЕСМА- 
8сгірі, она признана устаревшей и исключена из стандарта в спецификации ЕСМА- 
8сгірі ѵЗ. Реализации ЕСМАЗсгірі могут поддерживать эту функцию, но это необяза¬ 
тельное требование. Вместо нее следует использовать сіесосІеІІВІО и сІесосіеІІВІСотро- 
пепі:(). Подробности и пример см. в справочной статье езсаре(). 

См. также 

с!есос1еІІРІ(), с!есос1еІІПІСотропепі:( ), езсаре(), Зіігіпд 

ІЖІЕггог 

генерируется методами кодирования и декодирования ІШ ОЬ]есІ—>Епгог—>ІШЕггог 

Конструктор 

пе\л/ ІІПІЕггог() 

пе\л/ ІІПІЕггог {сообщение) 
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Аргументы 

сообщение Необязательное сообщение об ошибке, предоставляющее дополнитель¬ 
ную информацию об исключении. Если этот аргумент указан, он выступ 
пает в качестве значения свойства теззаде объекта ІІПІЕггог. 

Возвращаемое значение 

Вновь созданный объект ІІПІЕггог. Если указан аргумент сообщение , объект ІШЕггог бе¬ 
рет его в качестве значения своего свойства теззаде; в противном случае в качестве 
значения этого свойства он берет строку по умолчанию, определенную в реализации. 
Конструктор ІІНІЕггог(), вызванный как функция (без оператора пей), ведет себя так 
же, как если бы он был вызван с оператором пе\л/. 

Свойства 

теззаде Сообщение об ошибке, предоставляющее дополнительную информацию 

об исключении. Это свойство содержит строку, переданную конструкто¬ 
ру, или строку по умолчанию, определенную в реализации. Подробно¬ 
сти см. в справочной статье Еггог.теззаде. 

пате Строка, определяющая тип исключения. Все объекты ІІПІЕггог наследу¬ 

ют для этого свойства строку «ШИЕггог». 

Описание 

Экземпляр класса ІІПІЕггог создается функциями сіесосІеІІПІО и сІесосіеІІНІСотропепі:()» 
если указанная строка содержит недопустимые шестнадцатеричные управляющие 
последовательности. Это исключение может генерироваться методами епсосіеІІПІО 
и епсосІеІІПІСотропеп1:(), если указанная строка содержит недопустимые суррогатные 
пары символов Юникода. Генерация и перехват исключений подробно рассмотрены 
в справочной статье Еггог. 

См. также 

Еггог, Еггог.теззаде, Еггог.пате 
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Эта часть книги представляет собой справочник по клиентскому ^ѵабсгірі. Он 
включает описание наиболее важных объектов клиентского ^ѵабсгірі, таких 
как іл/іпсісм, Ооситепі, Еіетепі:, Еѵепі:, ХМЫНіііірРедиезІ:, Зііогаде, Сапѵаз и Рііе. Он также 
содержит описание компонентов библиотеки і(}иегу. Справочные статьи располо¬ 
жены в алфавитном порядке, по именам объектов, и каждая статья включает 
полный список констант, свойств, методов и обработчиков событий, поддержи¬ 
ваемых тем или иным объектом. 

В предыдущие изданиях этой книги для каждого метода отводилась отдельная 
справочная статья, но в этом издании справочный материал скомпонован иначе 
(не в ущерб детальности описания), и описание методов включено непосредствен¬ 
но в справочные статьи родительских объектов. 



АррПсаПопСасМе 

АггауВі^ег 

АггауВиНегѴіем 

АП г 

Аисііо 

Ве^огеІіпІоайЕѵепІ: 

ВІоЬ 

ВІоЬВіпІРег 

ВиПоп 

Сапѵаз 

СапѵазСгайіепі: 

СапѵазРаИегп 

СапѵазВепйегіпдСоп1:ех1:20 

СІіепІВесЬ 

СІозеЕѵепІ: 

Соттепі: 

Сопзоіе 

СопзоІеСоттапсЛіпе 

СЗЗВіЛе 

СЗЗЗіуІеОесІагаІііоп 
СЗЗЗіуІеЗМееІ: 
йаІіаТгапз^ег 
ОаІаѴі е\л/ 

Оосигпепі: 

ОоситегПРгадтепІ: 

ОосішепНуре 

ООМЕхсерНоп 

ООМІтрІетегИаІііоп 

ООМЗеИаЬІеТокепІізІ: 

ООМТокепИзІ: 

Еіетепі 

ЕггогЕѵепІ: 

Еѵепі: 

ЕѵепІіЗоіігсе 


ЕѵеггЬТагде* 

РіеІсІЗеІ: 

Рііе 

РіІеЕггог 

РіІеВеасІег 

РіІеРеайегЗупс 

Рогт 

РогтСогПгоІ 

РогтОаІіа 

РогтѴаІісШу 

Сеосоогйіпаіез 

Сеоіосаіііоп 

СеоІосаНопЕггог 

СеорозШоп 

НазМСІіапдеЕѵепІ: 

Нізііогу 

НТМЮоІІесНіоп 

НТМІРогтСопІтоІзСоІІесІіоп 

НТМЮрПопзСоПесПоп 

ІРгате 

Ітаде 

ІтадеОаІіа 

Іприі: 

]'0иегу 

ІаЬеІ 

І_іпк 

ЬосаПоп 

МесЛаЕІетепІ: 

МесІіаЕггог 

МеззадеСМаппеІ 

МеззадеЕѵепІ: 

МеззадеРогі 

Меіег 

Иаѵідаіог 


Мосіе 

Мосіеілз* 

Орііоп 

ОіПриІ: 

РадеТгапзШопЕѵепІ: 

РорЗііаѣеЕѵегѵІ: 

Ргосеззіпдіпзіігііс'ілоп 

Ргодгезз 

РгодгеззЕѵепі: 

Зсгееп 

Зсгірі: 

Зеіесі: 

Зіогаде 

ЗііогадеЕѵепІ: 

Зііуіе 

ТаЫе 

ТаЫеСеІІ 

ТаЫеВом 

ТаЫеЗесПоп 

Техі: 

ТехІАгеа 

ТехІМеІгісз 

ТітеВапдез 

ТуресІАггау 

ит 

Ѵісіео 

МеЬЗоскеІ: 

Міпйоѵѵ 

Могкег 

МогкегСІоЬаІЗсоре 

МогкегІ_оса 1 :іоп 

Іл/огкегМаѵідаІіог 

ХМІНПрВедиезі: 

ХМ Ш 1 : 1 : рВед и езі: У ріоай 
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АррІісаІіопСасНе 

прикладной интерфейс управления кэшем приложений ЕѵепІТагдеІ 

Объект АррІісаііопСасМе - это значение свойства аррІісаііопСасМе объекта Іл/іпсісм. Он 
определяет АРІ управления обновлением кэшированных приложений. В простых кэ¬ 
шируемых приложениях не требуется использовать этот АРІ: достаточно создать 
(и обновлять по мере необходимости) соответствующий файл объявления кэшируемо¬ 
го приложения, как описывается в разделе 20.4. В более сложных приложениях, где 
может возникнуть потребность более активно управлять обновлениями, можно ис¬ 
пользовать свойства, методы и обработчики событий, описываемые здесь. Подробно¬ 
сти приводятся в разделе 20.4.2. 

Константы 

Следующие константы представляют допустимые значения свойства зіаіиз. 
ипзідпесі зіюгі: 1ЖАСНЕ0 = О 

Это приложение не имеет атрибута тапііезі:: оно не кэшируется, 
ипзідпесі зіюгі: ЮІ.Е = 1 

Файл объявления проверен, данное приложение сохранено в кэше и обновлено, 
ипзідпесі зіюгі: СНЕСКІИС = 2 

В настоящее время броузер проверяет файл объявления, 
ипзідпесі зіюгі: 0(Ми_0А0ІМ6 = 3 

Броузер загружает и сохраняет в кэше файлы, перечисленные в объявлении, 
ипзідпесі зіюгі: УРОАТЕРЕАРУ = 4 

Была загружена и сохранена в кэше новая версия приложения, 
ипзідпесі зіюгі: 0В801.ЕТЕ = 5 

Файл объявления не найден и приложение будет удалено из кэша. 

Свойства 

геасіопіу ипзідпесі зіюгі: зіаіиз 

Это свойство описывает состояние кэша текущего документа. Оно может прини¬ 
мать одно из значений, перечисленных выше. 

Методы 

ѵоісі змарСасйеО 

Когда свойство зіаіиз получает значение ІІРОАТЕРЕАОѴ, броузер управляет двумя вер¬ 
сиями кэшируемого приложения: старые версии файлов из кэша, используемые 
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запущенным приложением, и новые загруженные версии, которые будут исполь¬ 
зоваться при следующем запуске приложения. Приложение может вызвать змар- 
СасМе( ), чтобы сообщить броузеру, что он может немедленно удалить старые версии 
и начать использовать новые версии файлов. Однако имейте в виду, что это может 
привести к конфликту версий, и гораздо безопаснее будет выполнить переход на 
новую версию, перезагрузив приложение вызовом метода ЬосаТіоп. ге1оаР(). 

ѵоір иргіаТеО 

Обычно броузер проверяет наличие новой версии файла объявления кэшируемого 
приложения каждый раз, когда это приложение загружается. Долгоживущие 
веб-приложения могут использовать этот метод, чтобы чаще проверять наличие 
обновлений. 


Обработчики событий 

В ходе проверки файла объявления и обновления кэша броузер возбуждает в объекте 
АррІісаіііопСасІіе целую серию событий. Для регистрации обработчиков событий мож¬ 
но использовать следующие свойства объекта АррНсаНопСасМе или методы интерфей¬ 
са ЕѵепііТагдеІ:, реализованные в объекте АррІісаІііопСасІіе. Обработчики большинства 
этих событий получают простой объект Еѵепі:. Обработчики событий «рго^гевв» полу¬ 
чают объект РгодгеззЕѵепІ:, с помощью которого можно узнать, какой объем в байтах 
уже был загружен. 

опсасРеР Возбуждается, когда приложение впервые сохраняется в кэше. Это по¬ 

следнее событие в последовательности. 

опсРескіпд Возбуждается, когда броузер начинает проверку наличия обновленно¬ 
го файла объявления. Это первое событие в последовательности собы¬ 
тий, генерируемых в кэшируемом приложении. 

опРоѵѵпІоаРіпд Возбуждается, когда броузер начинает загрузку ресурсов, перечислен¬ 
ных в файле объявления, т. е. либо когда приложение впервые поме¬ 
щается в кэш, либо когда оно обновляется. За этим событием обычно 
следует одно или более событий «рго^гезз». 

опеггог Возбуждается, когда в ходе обновления кэша возникает ошибка. Это 

может произойти, например, когда броузер работает в автономном ре¬ 
жиме или если приложение ссылается на несуществующий файл объ¬ 
явления. 


оппоирраіе 


опоЬзоІеІіе 


опргодгезз 


опирсіаііегеасіу 


Возбуждается, когда броузер определяет, что файл объявления не из¬ 
менился и приложение в кэше имеет текущую версию. Это последнее 
событие в последовательности. 

Возбуждается, когда исчезает файл объявления кэшируемого прило¬ 
жения. Это приводит к удалению приложения из кэша. Это последнее 
событие в последовательности. 

Возбуждается периодически, пока идет загрузка и сохранение в кэше 
файлов приложения. С этим событием обработчикам передается объ¬ 
ект РгодгеззЕѵепІ:. 

Возбуждается, когда броузер загрузит и сохранит в кэше новую вер¬ 
сию приложения (и она будет готова к использованию при следующем 
запуске приложения). Это последнее событие в последовательности. 
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АггауВиНег 

последовательность байтов фиксированной длины 

Объект АггауВиііег представляет последовательность байтов фиксированной длины 
в памяти, но не определяет методов извлечения и сохранения байтов. Доступ к бай¬ 
там и их интерпретацию обеспечивает объект АггауВиііегѴіеѵѵ, подобный классам ти¬ 
пизированных массивов. 

Конструктор 

пем АггауВиііег(ипзідпесі Іопд Іепдгіі) 

Создает новый объект АггауВиііег с указанным количеством байтов. Все байты 
в новом объекте АггауВиііег инициализируются значением 0. 

Свойства 

геасіопіу ипзідпесі Іопд ЬуіеІ-епдіЬ 

Длина в байтах последовательности в объекте АггауВиііег. 

АггауВіЖегѴіеѵѵ 

общие свойства типов, основанных на АггауВиПег 

Тип АггауВиііегѴіеѵѵ служит суперклассом для классов, предоставляющих доступ 
к байтам в объекте АггауВиііег. Объект АггауВиііегѴіем нельзя создать непосредствен¬ 
но: он предназначен, чтобы определять общие свойства для подтипов, таких как ти¬ 
пизированные массивы и ОаіаѴіеѵѵ. 

Свойства 

геасіопіу АггауВиііег Ьиііег 

Объект АггауВиііег, представлением которого является данный объект, 
геасіопіу ипзідпесі Іопд ЬуіеІ-епдіЬ 

Длина в байтах фрагмента буфера, доступного посредством данного представления, 
геасіопіу ипзідпесі Іопд ЬуіеОіізеі 

Начальная позиция в байтах фрагмента буфера, доступного посредством данного 
представления. 

А«г 

атрибут элемента документа 

Объект АН г представляет атрибут узла Еіетепі. Получить объект Аііг можно посредст¬ 
вом свойства аіігіЬиіез интерфейса Иосіе или вызовом метода деіАіігіЬиіеМосіеО или 
деіАіігіЬиіеМосіеМ8() интерфейса Еіетепі. 

Поскольку значения атрибутов могут быть представлены в виде строк, обычно нет не¬ 
обходимости использовать интерфейс АП г. В большинстве случаев самый простой спо¬ 
соб работы с атрибутами предоставляют методы Еіетепі.деіАіігіЬиіе() и Еіетепі.зеі- 
АіігіЬиіе(). Эти методы используют строки в качестве значений атрибутов и позволя¬ 
ют вообще отказаться от применения объектов Аііг. 

Свойства 

геасіопіу зігіпд ІосаІИате 

Имя атрибута, без возможного префикса пространства имен. 
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геасіопіу зіігіпд паше 

Имя атрибута, включая префикс пространства имен, если таковое имеется, 
геасіопіу зіігіпд патезрасеІШ 

Идентификатор ІІКІ, определяющий пространство имен атрибута, или пиіі, если 
отсутствует. 

геасіопіу зіігіпд рге^іх 

Префикс пространства имен атрибута или пиіі, если отсутствует, 
зіігіпд ѵаіие 

Значение атрибута. 

Аисііо 

НТМЬэлемент <аис!іо> Ыосіе, Еіетепі, МесІіаЕІетепІ 

Объект Аисііо, представляющий НТМЬ-элемент <аисііо>. Объект Аисііо не имеет свойств, 
методов и обработчиков событий, кроме конструктора, помимо тех, что унаследованы 

от МесііаЕІетепІі. 

Конструктор 

пем АиОіо( [зіігіпд зге]) 

Этот конструктор создает новый элемент <аисііо> с атрибутом ргеіоасі, установлен¬ 
ным в значение «аиію». Если указан аргумент зге, он используется как значение 
атрибута зге. 

ВеіогеипІоасІЕѵепі 

объект Еѵепі для событий выгрузки Еѵепі 

Событие «ипіоаб» возбуждается в объекте Міпсіоѵѵ непосредственно перед тем, как бро¬ 
узер перейдет к другому документу; оно дает веб-приложению возможность предло¬ 
жить пользователю подтвердить свое желание покинуть страницу. Обработчикам со¬ 
бытия «ипіоасі» передается объект ВеіогеЬпІоасіЕѵепІі. Если вам потребуется запросить 
у пользователя подтвердить желание покинуть страницу, вам не нужно вызывать ме¬ 
тод Міпсіоѵѵ.сопіігтО. Вместо этого верните из обработчика события строку или при¬ 
свойте строку свойству геіигпѴаІие этого объекта. Эта строка будет выведена перед 
пользователем в форме диалога подтверждения. 

Смотрите также справочные статьи Еѵепіі и Міпсіоѵѵ. 

Свойства 

зіігіпд геІигпѴаІие 

Сообщение, отображаемое в диалоге подтверждения перед уходом с текущей стра¬ 
ницы. Оставьте это свойство пустым, если вам не требуется отображать диалог 
подтверждения. 

ВІоЬ 

блок двоичных данных, таких как содержимое файла 

Объекты ВІоЬ используются для организации обмена данными между различными 
прикладными интерфейсами. Объекты ВІоЬ могут иметь очень большой размер и спо¬ 
собны представлять блоки двоичных данных, но ни то, ни другое не является обяза¬ 
тельным. Объекты ВІоЬ часто сохраняются в файлах, но это зависит от реализации. 
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Объекты ВІоЬ позволяют узнать только свой размер и иногда МІМЕ-тип хранящихся 
в них данных и определяют единственный метод, позволяющий интерпретировать 
фрагмент своих данных как отдельный объект ВІоЬ. 

Объекты ВІоЬ используются многими прикладными интерфейсами: объект РіІеВеасІег 
позволяет читать содержимое объекта ВІоЬ, а объект ВІоЬВиіІсІег - создавать новые объ¬ 
екты ВІоЬ. Объект ХМЬНІіІірВедиезІі обеспечивает возможность загружать и выгружать 
объекты ВІоЬ. Обсуждение объектов ВІоЬ и прикладных интерфейсов, использующих 
их, вы найдете в разделе 22.6. 

Свойства 

геасіопіу ипзідпесі Іопд зіге 

Объем двоичных данных в объекте ВІоЬ в байтах. 
геаЬопІу зіігіпд *уре 

МІМЕ-тип данных в объекте ВІоЬ, если указан, в противном случае - пустая строка. 

Методы 

ВІоЬ з1ісе(ипзідпес1 Іопд зТагТ, ипзідпеЬ Іопд ІепдТТі, [зіігіпд сопТепТТуре ]) 

Возвращает новый объект ВІоЬ, представляющий ІепдТТі байтов в данном объекте 
ВІоЬ, начиная со смещения зТагТ. Если указан аргумент сопТепТТуре , он будет ис¬ 
пользован, как значение свойства іуре возвращаемого объекта ВІоЬ 

ВІоЬВиіІсІег 

создает новые объекты ВІоЬ 

Объект ВІоЬВиіІсІег используется для создания новых объектов ВІоЬ из текстовых 
строк и из двоичных данных в объектах АггауВиііег и в других объектах ВІоЬ. Чтобы 
создать объект ВІоЬ, следует сначала создать объект ВІоЬВиіІсІег, вызвать его метод 
аррепЬО один или более раз и затем вызвать метод деіВ1оЬ(). 

Конструктор 

пей В1оЬВиі1с1ег() 

Новый объект ВІоЬВиіІсІег создается вызовом конструктора В1оЬВиі1Ьег() без аргу¬ 
ментов. 

Методы 

ѵоісі аррепсКзігіпд ТехТ, [зіігіпд епдіпдз]) 

Добавляет в конструируемый двоичный объект ВІоЬ текст ТехТ в кодировке ІЛТ-8. 
ѵоісі арреп<1(В1оЬ дата) 

Добавляет в конструируемый двоичный объект ВІоЬ данные из двоичного объекта 
дата. 

ѵоісі аррепс1(АггауВиііег дата) 

Добавляет в конструируемый двоичный объект ВІоЬ данные из объекта дата типа 
АггауВиііег. 

ВІоЬ де1іВ1оЬ([зігіпд сопТепТТуре ]) 

Возвращает объект ВІоЬ, представляющий все данные, которые были добавлены 
в этот объект ВІоЬВиіІсІег с момента его создания. Каждый вызов этого метода воз¬ 
вращает новый объект ВІоЬ. Если указан аргумент сопТепТТуре , он будет использо¬ 
ваться в качестве значения свойства іуре возвращаемого объекта ВІоЬ. Если этот 
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аргумент не указан, свойство Туре возвращаемого объекта ВІоЬ будет содержать 
пустую строку. 

ВиНоп 

НТМІ_-элемент <ЬиНоп> Ыосіе, Еіетепі, ГогтСопйгоІ 

Объект В и 1: Топ представляет НТМЬ-элемент <ЬиТТоп>. Большинство свойств и методов 
объекта ВиТТоп описываются в справочных статьях РогшСопТгоІ и ЕІетепТ. Однако, ко¬ 
гда свойство Туре объекта ВиТТоп (смотрите справочную статью РогтСопТгоІ) имеет зна¬ 
чение «виЬтіі», другие свойства, перечисленные здесь, определяют параметры от¬ 
правки формы, имеющие приоритет перед аналогичными свойствами формы, в кото¬ 
рой находится кнопка ВиТТоп (смотрите справочную статью РогтСопТгоІ). 

Свойства 

Следующие свойства используются, только когда элемент <ЬиТТоп> имеет атрибут Туре 
со значением «виЬтіі». 

зТгіпд ТогтАсТіоп 

Это свойство соответствует НТМЬ-атрибуту ТогтасТіоп. Для кнопок, управляющих 
отправкой форм, это свойство переопределяет свойство асТіоп форм. 

зТгіпд ТогтЕпсТуре 

Это свойство соответствует НТМЬ-атрибуту ТогтепсТуре. Для кнопок, управляю¬ 
щих отправкой форм, это свойство переопределяет свойство епсТуре форм и может 
принимать те же значения. 

зіігіпд ГогтМеІіІкх) 

Это свойство соответствует НТМЬ-атрибуту іогттеііі'юй. Для кнопок, управляющих 
отправкой форм, это свойство переопределяет свойство теііюс] форм. 

зіігіпд ^огтМоѴаІігіаІіе 

Это свойство соответствует НТМЬ-атрибуту іогтпоѵаіійаііе. Для кнопок, управляю¬ 
щих отправкой форм, это свойство переопределяет свойство поѴаІісіаііе форм. 

зіігіпд ^огтТагде* 

Это свойство соответствует НТМЬ-атрибуту іогтіагдеіі. Для кнопок, управляющих 
отправкой форм, это свойство переопределяет свойство іагдеі форм. 

Сапѵаз 

НТМІ.-элемент для создания графических изображений ІЧосІе, Еіетепі 

Объект Сапѵаз представляет НТМЬ-элемент <сапѵаз>. Он не обладает собственным по¬ 
ведением, но определяет АРІ для поддержки операций рисования. С помощью этого 
объекта можно задать ширину и высоту холста с помощью его свойств ѵѵісііііп и ІіеідІтС, 
а вызовом метода ІюйаІіаигІО из него можно извлечь изображение, но основная функ¬ 
циональность обеспечивается объектом «контекста», возвращаемого методом деіСоп- 
іехіО. Смотрите справочную статью СапѵазРепсіегіпдСоп1іехіі20. 

Свойства 

ипзідпей Іопд ЬеідІѵС 
ипзідпей Іопд ѵшіііЬ 

Эти свойства соответствуют атрибутам ѵѵісііііі и Меідітіі тега <сапѵаз> и определяют 
размеры координатной плоскости холста. По умолчанию свойство ѵѵісЛіІі имеет зна¬ 
чение 300, а МеідІИі - 150. 
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Объекты ВІоЬ позволяют узнать только свой размер и иногда МІМЕ-тип хранящихся 
в них данных и определяют единственный метод, позволяющий интерпретировать 
фрагмент своих данных как отдельный объект ВІоЬ. 

Объекты ВІоЬ используются многими прикладными интерфейсами: объект РіІеВеасІег 
позволяет читать содержимое объекта ВІоЬ, а объект ВІоЬВиіІсІег - создавать новые объ¬ 
екты ВІоЬ. Объект ХМЬНІіІірВедиезіі обеспечивает возможность загружать и выгружать 
объекты ВІоЬ. Обсуждение объектов ВІоЬ и прикладных интерфейсов, использующих 
их, вы найдете в разделе 22.6. 

Свойства 

геаЬопІу ипзідпеЬ Іопд зіге 

Объем двоичных данных в объекте ВІоЬ в байтах, 
геасіопіу зіігіпд *уре 

МІМЕ-тип данных в объекте ВІоЬ, если указан, в противном случае - пустая строка. 

Методы 

ВІоЬ 5Іісе(ипзідпеЬ Іопд зТагТ, ипзідпеЬ Іопд ІепдТТі, [зіігіпд сопТепТТуре]) 

Возвращает новый объект ВІоЬ, представляющий ІепдТТі байтов в данном объекте 
ВІоЬ, начиная со смещения зТаг?. Если указан аргумент сопТепТТуре , он будет ис¬ 
пользован, как значение свойства іуре возвращаемого объекта ВІоЬ 

ВІоЬВиіІсІег 

создает новые объекты ВІоЬ 

Объект ВІоЬВиіІсІег используется для создания новых объектов ВІоЬ из текстовых 
строк и из двоичных данных в объектах АггауВиіІ'ег и в других объектах ВІоЬ. Чтобы 
создать объект ВІоЬ, следует сначала создать объект ВІоЬВиіІсІег, вызвать его метод 
аррепсЮ один или более раз и затем вызвать метод деіВІоЬО. 

Конструктор 

пем В1оЬВиіЮег( ) 

Новый объект ВІоЬВиіІсІег создается вызовом конструктора ВІоЬВиіІЬегО без аргу¬ 
ментов. 

Методы 

ѵоісі аррепс!(з1:гіпд Тех?, [зіігіпд епдіпдз]) 

Добавляет в конструируемый двоичный объект ВІоЬ текст Тех? в кодировке ІЛТ-8. 
ѵоісі арреп(1(В1оЬ дата ) 

Добавляет в конструируемый двоичный объект ВІоЬ данные из двоичного объекта 

дата . 

ѵоісі аррепсКАггауВиІ^ег дата) 

Добавляет в конструируемый двоичный объект ВІоЬ данные из объекта дата типа 
АггауВиіІ'ег. 

ВІоЬ деТВ1оЬ([зіігіпд сопТепТТуре ]) 

Возвращает объект ВІоЬ, представляющий все данные, которые были добавлены 
в этот объект ВІоЬВиіІсІег с момента его создания. Каждый вызов этого метода воз¬ 
вращает новый объект ВІоЬ. Если указан аргумент сопТепТТуре , он будет использо¬ 
ваться в качестве значения свойства іуре возвращаемого объекта ВІоЬ. Если этот 
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аргумент не указан, свойство Туре возвращаемого объекта ВІоЬ будет содержать 
пустую строку. 

ВиНоп 

НТМЬэлемент <Ьи«оп> Ыосіе, Еіетепі, ГогтСопІгоІ 

Объект В и 1: Топ представляет НТМЬ-элемент <ЬиТТоп>. Большинство свойств и методов 
объекта ВиТТоп описываются в справочных статьях РогтСопТгоІ и ЕІетепТ. Однако, ко¬ 
гда свойство Туре объекта ВиТТоп (смотрите справочную статью РогтСопТгоІ) имеет зна¬ 
чение «виЪтіі», другие свойства, перечисленные здесь, определяют параметры от¬ 
правки формы, имеющие приоритет перед аналогичными свойствами формы, в кото¬ 
рой находится кнопка ВиТТоп (смотрите справочную статью РогтСопТгоІ). 

Свойства 

Следующие свойства используются, только когда элемент <ЬиТТоп> имеет атрибут Туре 
со значением «виЬтіі». 

зТгіпд ТогтАсТіоп 

Это свойство соответствует НТМЬ-атрибуту ТогтасТіоп. Для кнопок, управляющих 
отправкой форм, это свойство переопределяет свойство асТіоп форм. 

зТгіпд ТогшЕпсТуре 

Это свойство соответствует НТМЬ-атрибуту ТогтепсТуре. Для кнопок, управляю¬ 
щих отправкой форм, это свойство переопределяет свойство епсТуре форм и может 
принимать те же значения. 

зТгіпд ТогтМеТЬогі 

Это свойство соответствует НТМЬ-атрибуту ТогттеТІісхЗ. Для кнопок, управляющих 
отправкой форм, это свойство переопределяет свойство теТРой форм. 

зТгіпд ТогтМоѴаІігіаТе 

Это свойство соответствует НТМЬ-атрибуту ТогтпоѵаІіРаТе. Для кнопок, управляю¬ 
щих отправкой форм, это свойство переопределяет свойство поѴаІійаТе форм. 

зТгіпд ТогшТагдеТ 

Это свойство соответствует НТМЬ-атрибуту ТогтТагдеТ. Для кнопок, управляющих 
отправкой форм, это свойство переопределяет свойство ТагдеТ форм. 

Сапѵаз 

НТМЬэлемент для создания графических изображений ІЧосІе, ЕІетепТ 

Объект Сапѵаз представляет НТМЬ-элемент <сапѵаз>. Он не обладает собственным по¬ 
ведением, но определяет АРІ для поддержки операций рисования. С помощью этого 
объекта можно задать ширину и высоту холста с помощью его свойств \л/ісі1:Іп и МеідІтІ:, 
а вызовом метода іоРаіаІІгІО из него можно извлечь изображение, но основная функ¬ 
циональность обеспечивается объектом «контекста», возвращаемого методом деіСоп- 
іехіО. Смотрите справочную статью СапѵазРепдегіпдСоп1:ехі:20. 

Свойства 

ипзідпесі Іопд ЬеідШ 
ипзідпей Іопд и/ЮТИ 

Эти свойства соответствуют атрибутам ѵѵісИіІі и МеідІИ: тега <сапѵаз> и определяют 
размеры координатной плоскости холста. По умолчанию свойство ѵѵісііііі имеет зна¬ 
чение 300, а МеідІтІ: - 150. 
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Если размер элемента <сапѵа$> не указан в таблице стилей или во встроенном атри¬ 
буте зііуіе, эти свойства \л/іс11:М и МеідІИ; также определяют экранные размеры холста. 

Изменение значений этих свойств (даже запись их текущих значений) вызывает 
очистку холста (заливку черным прозрачным цветом) и сброс всех его графиче¬ 
ских атрибутов в значения по умолчанию. 

Методы 

оЬ^есІ: деІСопІехіСзіігіпд сопТехТІсІ , [любые аргументы...]) 

Возвращает объект, посредством которого выполняется рисование в элементе 
Сапѵаз. Если передать ему строку «2(1», он вернет объект СапѵазВепс1егіпдСоп1;ех1;20, 
реализующий рисование на двухмерной плоскости. В этом случае не требуется пе¬ 
редавать никаких дополнительных аргументов. 

Для каждого элемента <сапѵаз> существует только один объект СапѵазРепсІегіпдСоп- 
1;ех1;20, т. е. повторные вызовы де1:Соп1:ех1:("2с1”) будут возвращать тот же самый 
объект. 

Спецификация НТМЬб стандартизует аргумент «2(1» для этого метода и не опреде¬ 
ляет других допустимых аргументов. В настоящее время разрабатывается отдель¬ 
ный стандарт, АѴеЬСЬ, для трехмерной графики. В броузерах, поддерживающих 
его, этому методу можно передать строку «лѵеЬ^І», чтобы получить объект, обеспе¬ 
чивающий создание трехмерных изображений. 

Следует, однако, отметить, что в данной книге описывается только объект Сапѵаз- 
ЕепсіегіпдСоп1:ех1:20. 

зіігіпд і:о0а1:аІШІ.([зі:гіпд Туре], [любые аргументы ...]) 

Метод 1:о0аі:аІШІ_() возвращает растровое изображение холста в виде ШІЬ-адреса 
сіаііа://, который можно использовать в теге <ітд> или передавать по сети. Напри¬ 
мер: 

// Скопировать содержимое холста в элемент <ітд> и добавить его в документ 

ѵаг сапѵаз = сіоситепі;. де1;Е1етеп1;ВуІс1("ту_сапѵаз"); 

ѵаг ітаде = сіоситепі;.сгеаІеЕІетепіС'ітд"); 

ітаде.згс = сапѵаз. ІоОаІаивЦ); 

сіоситепі;. Ьосіу. аррепс!СИі1с1( ітаде); 

Аргумент Туре определяет, какой МІМЕ-тип или графический формат изображе¬ 
ния следует использовать. Если этот аргумент отсутствует, используется значение 
по умолчанию «іта^е/рп^». Формат РЖх является единственным, который обяза¬ 
ны поддерживать все реализации. Чтобы получить изображение в другом форма¬ 
те, отличном от РЖх, можно передать дополнительные аргументы, определяющие 
порядок кодирования. Например, если в аргументе Туре передается строка «іта^е/ 
Іре&», во втором аргументе следует передать число в диапазоне от 0 до 1, опреде¬ 
ляющее уровень качества изображения. На момент написания этих строк ника¬ 
ких других аргументов стандартизовано не было. 

Для предотвращения утечки информации между документами с разным происхо¬ 
ждением метод 1;о0а1;аІЖІ_() не будет работать с тегами <сапѵаз>, которые имеют «не¬ 
ясное происхождение». Считается, что элемент <сапѵаз> имеет неясное происхож¬ 
дение, если в нем содержалось изображение (созданное непосредственно с помо¬ 
щью метода с1гам1таде() или косвенно, с помощью объекта СапѵазРаі;1;егп), имеющее 
иное происхождение, отличное от происхождения содержащего его документа. 
Кроме того, считается, что элемент <сапѵаз> имеет неясное происхождение, если 
в нем рисовался текст с использованием веб-шрифтов, имеющих иное происхож¬ 
дение. 
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СапѵазСгасІіеіті 

цветной градиент для использования в элементе Сапѵаз 

Объект СапѵазСгасІіепіі представляет цветовой градиент, который может быть присво¬ 
ен свойствам зІігокеЗііуІе и ШІЗііуІе объекта СапѵазНеп<1егіпдСопііехіі20. Объект СапѵазСга- 
сііепіі возвращается методами сгеа1:еІіпеаг0гасііепі:( ) и сгеа1:еРас1іа1Сгас1іепі:() объекта 
СапѵазРепс1егіпдСопііехіі20. 

После создания объекта СапѵазСгайіепІі следует вызвать метод асМСо1ог8ііор() и с его по¬ 
мощью определить, какой цвет в какой позиции должен отображаться внутри гради¬ 
ента. Между заданными позициями цвет будет интерполироваться так, чтобы соз¬ 
дать эффект плавного перехода или исчезновения цвета. Если не определить цвет ни 
в одной позиции, градиент будет окрашен однородным прозрачным черным цветом. 

Методы 

ѵоісі ас!сІСо1ог8Т:ор(с1оиЫе оТТзеТ, зіігіпд соіог ) 

Метод асМСо1ог8ііор() определяет фиксированные цвета внутри градиента. В аргу¬ 
менте соіог передается строка с названием цвета в формате С88. В аргументе оТТзеТ 
передается значение с плавающей точкой в диапазоне от 0.0 до 1.0, которое пред¬ 
ставляет позицию между началом и концом градиента. Значение 0 соответствует 
начальной позиции, значение 1 - конечной. 

Если указать два или более цвета, градиент создаст эффект плавного перехода 
цветов между указанными позициями. Перед первой позицией будет отображать¬ 
ся цвет, соответствующий первой позиции. После последней позиции градиент бу¬ 
дет отображать цвет, соответствующий последней позиции. Если определить цвет 
только для одной позиции, градиент будет окрашен одним цветом. Если не опреде¬ 
лить цвет ни в одной позиции, градиент будет окрашен однородным прозрачным 
черным цветом. 

СапѵазРаНегп 

шаблон заполнения холста на основе готового изображения 

Объект СапѵазРаІіІіегп возвращается методом сгеа1іеРа1і1іегп() объекта СапѵазРепРегіпд- 
Соп1іех1і20. Объект СапѵазРаІіІіегп может использоваться в качестве значения свойств 
ЗІігокеЗііуІе и Ш18ііу1е объекта СапѵазРепРегіпдСоп1іех1і20. 

Сапѵа$КепсІегіпдСоп{ех{20 

объект, используемый для создания изображений 

Объект СапѵазРепс1егіпдСоп1іех1і20 предоставляет набор свойств и методов для рисования 
двухмерных графических изображений. Следующие разделы содержат краткий об¬ 
зор его возможностей. Дополнительная информация приводится в разделе 21.4, а так¬ 
же в справочных статьях Сапѵаз, СапѵазОгасііепіі, СапѵазРаІіІіегп, ІтадеОаііа и ТехІМеІігісз. 

Создание и отображение контуров 

Очень мощная особенность элемента Сапѵаз заключается в возможности строить фи¬ 
гуры с помощью элементарных операций рисования и затем отображать их либо в ви¬ 
де ограничивающих фигуру линий, либо заполнять их. Собранные воедино операции 
рисования называются текущим контуром . Элемент Сапѵаз поддерживает возмож¬ 
ность работы лишь с одним текущим контуром. 
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Для построения связанной фигуры из отдельных сегментов для каждой промежуточ¬ 
ной операции рисования должна быть определена точка присоединения. Для этой це¬ 
ли Сапѵаз поддерживает текущую позицию . Операции рисования неявно используют 
ее в качестве начальной точки и обычно переустанавливают текущую позиции в свою 
конечную точку. Это можно представить себе как перемещение пера по листу бумаги: 
когда заканчивается рисование отдельной линии, текущей становится позиция, в ко¬ 
торой было остановлено движение пера. 

Существует возможность создать в текущем контуре несколько несвязанных фигур, 
которые должны отображаться с одними и теми же параметрами рисования. Для от¬ 
деления фигур используется метод тоѵеТо( ); он перемещает текущую позицию в новые 
координаты без добавления линии, связывающей точки. Когда вызывается этот ме¬ 
тод, создается новый вложенный контур, или подконтур , который в терминах эле¬ 
мента Сапѵаз используется для объединения связанных операций. 

Из доступных операций рисования можно упомянуть: 1іпеТо() - рисование отрезков 
прямых линий, гесЦ) - рисование прямоугольников, агс() и агсТо() - рисование дуг, 
ЬеііегСигѵеТоО и диасІга1:ісСигѵеТо() - рисование кривых. 

Как только требуемый контур сформирован, нарисовать фигуру в виде ограничиваю¬ 
щих линий можно методом зі:гоке(), а залить внутреннюю область фигуры - методом 
Ш1(); можно также вызвать оба метода. 

Помимо рисования линий и заливки фигур текущий контур можно использовать как 
область отсечки . Пикселы в пределах этой области будут отображаться, за ее преде¬ 
лами - нет. Область отсечки обладает свойством накапливать изменения - вызов ме¬ 
тода с1ір( ) для создания области отсечки, пересекающейся с текущей, приводит к соз¬ 
данию новой объединенной области. 

Если сегменты в любом из вложенных контуров не формируют замкнутую фигуру, опе¬ 
рации "ГіІІО и с1ір() неявно замыкают их, добавляя виртуальный (невидимый) отрезок 
прямой линии, соединяющий начальную и конечную точки контура. Чтобы явно доба¬ 
вить такой сегмент и тем самым замкнуть фигуру, следует вызвать метод с1озеРаі:Ь( ). 

Чтобы проверить, находится ли точка внутри (или на границе) текущего контура, мож¬ 
но использовать метод ізРоіпі:ІпРа1:К ). Когда контур пересекает сам себя или состоит из 
нескольких накладывающихся друг на друга подконтуров, понятие «внутри» опреде¬ 
ляется правилом сохранения знака. Если нарисовать одну окружность внутри другой 
и обе рисовать в одном и том же направлении, все, что находится внутри большей ок¬ 
ружности, будет считаться внутренней областью контура. Если, напротив, одну ок¬ 
ружность нарисовать по часовой стрелке, а другую - против часовой стрелки, получит¬ 
ся кольцо, и внутренняя область меньшей окружности будет считаться за пределами 
контура. Это же определение внутренней области используется методами Ш1()ис1ір(). 

Цвета, градиенты и шаблоны 

При заполнении или рисовании границ фигуры существует возможность указать, ка¬ 
ким образом должны заполняться линии или ограниченная ими область, для чего 
используются свойства І^іІІЗііуІе и зТгокеЗТуІе. Оба эти свойства могут принимать 
строку со значением цвета в формате С88, а также объект Сапѵазбгасііепі: или СапѵазРаІ:- 
Тегп, который описывает градиент или шаблон. Для создания градиента используется 
метод сгеаТеНпеагбгасПепТС) или сгеаі:еРасІіа1СгасІіепі:(), для создания шаблона - метод 
сгеаТеРаТТегпС). 

Непрозрачный цвет в нотации С88 задается строкой в формате «#ККООВВ», где КК, 
ОО и ВВ- это шестнадцатеричные цифры, определяющие интенсивность красной 
(гей), зеленой (&гееп) и синей (Ыие) составляющих в диапазоне от 00 до ГГ. Например, 
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ярко-красный цвет описывается строкой «#ГГОООО». Чтобы определить степень про¬ 
зрачности цвета, используется строка в формате «г&Ъа(К, О, В, А)». В такой нотации 
К, О и В определяют интенсивность красной, зеленой и синей составляющих цвета 
в виде десятичных чисел в диапазоне от 0 до 255, а А - альфа-компонент (прозрач* 
ность), как число с плавающей точкой в диапазоне от 0.0 (полностью прозрачный 
цвет) до 1.0 (полностью непрозрачный цвет). Например, полупрозрачный ярко-крас¬ 
ный цвет описывается строкой «г&Ъа(255, 0, 0, 0.5)». 

Толщина, окончания и сопряжение линий 

Элемент Сапѵаз имеет несколько свойств, с помощью которых можно определить раз¬ 
личные варианты отображения линий. Толщину линий можно указать с помощью 
свойства ІіпеМісІііН, окончания линий - с помощью свойства ІіпеСар, сопряжения ли¬ 
ний - с помощью свойства Ііпе^іп. 

Рисование прямоугольников 

Нарисовать и заполнить прямоугольник можно с помощью методов з1:гокеРес1:() и Ш1- 
Пес1:(). Кроме того, методом сІеагПесіО можно очистить прямоугольную область. 

Рисование изображений 

В АРІ объекта Сапѵаз изображения определяются с помощью объектов Ітаде, которые 
представляют НТМЬ-теги <ітд> или невидимые изображения, созданные с помощью 
конструктора Ітаде() (дополнительную информацию см. в справочной статье Ітаде). 
Кроме того, в качестве объекта-источника изображения могут использоваться эле¬ 
менты <сапѵаз> и <ѵісІео>. 

Добавить изображение в элемент Сапѵаз можно с помощью метода с!га\л/Ітаде(), который 
в наиболее общем случае позволяет масштабировать и выводить на экран произволь¬ 
ный прямоугольный участок исходного изображения. 

Рисование текста 

Метод Іі11Тех1:() рисует текст, а метод зі: гокеТехТ() рисует контуры букв, составляю¬ 
щих текст. Используемый шрифт определяется свойством ІопІ; значение этого свой¬ 
ства должно быть строкой определения шрифта в формате С88. Выравнивание текста 
относительно указанной координаты X по левому краю, по правому краю или по цен¬ 
тру определяется с помощью свойства ІехіАІідп, а выравнивание относительно ука¬ 
занной координаты У - с помощью свойства ІехіВазеІіпе. 

Система координат и преобразования 

По умолчанию начало системы координат холста находится в точке ( 0 , 0 ), в верхнем 
левом углу, когда координата X растет в направлении к правой границе, а координата 
У - к нижней. Атрибуты \л/ісіі:Ь и МеідЫ: тега <сапѵаз> определяют максимальные значе¬ 
ния координат X и У, а одна элементарная единица измерения в системе координат 
обычно соответствует одному пикселу. 

Однако существует возможность преобразовать систему координат, вызывая смеще¬ 
ние, масштабирование или вращение системы координат в операциях рисования. Де¬ 
лается это с помощью методов ігапзІаІеО, зса1е() и гоІаіеО, которые оказывают влия¬ 
ние на матрицу преобразования холста. Поскольку система координат может подвер¬ 
гаться подобным преобразованиям, значения координат, которые передаются мето¬ 
дам, таким как ІіпеТоО, могут не соответствовать количеству пикселов. По этой 
причине для определения координат в АРІ объекта Сапѵаз используются не целые, 
а вещественные числа. 
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Тени 

Объект СапѵазВепсІегіпдСоп1:ехі:20 может автоматически добавлять тени к любым созда¬ 
ваемым фигурам. Цвет тени задается с помощью свойства зМасІо\л/Со1ог, а ее смещение- 
с помощью свойств зІіасІои/0ТТзе1:Х и зІіасІоѵЮ^зеІіѴ. Кроме того, с помощью свойства зМа- 
сІомВІиг можно определить степень размытия краев тени. 

Композиция 

Обычно при рисовании на холсте новые фигуры накладываются поверх ранее нарисо¬ 
ванных, частично или полностью скрывая их, в зависимости от степени прозрачно¬ 
сти новых фигур. Процесс объединения новых пикселов со старыми называется «ком¬ 
позицией», и, указывая различные значения в свойстве д1оЬа1Сотрозі1:е0рега1:іоп, мож¬ 
но управлять порядком объединения пикселов. Например, это свойство можно уста¬ 
новить так, что новые фигуры будут рисоваться под существующими. 

В следующей таблице перечислены допустимые значения свойства и их смысл. Под 
исходными в таблице подразумеваются пикселы, которые рисуются в настоящий мо¬ 
мент, под целевыми - существующие пикселы. Под результирующими - пикселы, 
которые получаются в результате объединения исходных и целевых пикселов. В фор¬ 
мулах символом 3 обозначается исходный (зоигсе) пиксел, символом д - целевой (<іез- 
ііпаііоп) пиксел, символом В - результирующий (гезиіі) пиксел, символом ос 5 - альфа- 
компонент (уровень непрозрачности) исходного пиксела, и символом сх, - альфа-ком¬ 
понент целевого пиксела: 

Значение _Формула Описание 

сору" В = 3 Исходный пиксел рисуется без учета целевого пиксела. 

"сіезіііпаі:іоп-аіор” В = (1-а й )3 + а 5 Р Исходный пиксел рисуется под целевым. Если исход¬ 

ный пиксел является прозрачным, результирующий 
пиксел также будет прозрачным. 

йезііпаііоп-іп" В = сс 5 0 Целевой пиксел умножается на непрозрачность исход¬ 

ного, но цвет исходного пиксела игнорируется. 

"сіезііпаіііоп-оиі:” В = (1-СХ 5 )0 Целевой пиксел делается прозрачным, если исходный 

пиксел непрозрачен, и остается без изменений, если 
исходный пиксел прозрачен. Цвет исходного пиксела 
игнорируется. 

"сЗезІііпаІ:іоп-оѵег" В = (1-сс )8 + 0 Исходный пиксел рисуется под целевым, и его види¬ 

мость зависит от прозрачности целевого пиксела. 

"ІідНІег" В = 3 + Р Цветовые составляющие двух пикселов просто скла¬ 

дываются, а их суммы обрезаются, если превышают 
максимально возможное значение. 

"зоигсе-аііор" В = а й 3 + (1-(Х 5 )0 Исходный пиксел рисуется поверх целевого, но умно¬ 

жается на его непрозрачность. Поверх совершенно про¬ 
зрачного целевого пиксела ничего не рисуется. 

"зоигсе-іп" В = сс^З Исходный пиксел умножается на непрозрачность це¬ 

левого. Цвет целевого пиксела игнорируется. Если це¬ 
левой пиксел является прозрачным, результирующий 
пиксел также будет прозрачным. 

зоигсѳ-оиі В = (1-сс)5 Результирующий пиксел получит цвет исходного, ес¬ 

ли целевой пиксел прозрачен, и прозрачным, если це¬ 
левой пиксел непрозрачен. Цвет целевого пиксела иг¬ 
норируется. 
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Значение 

Формула 

Описание 

"зоіігсе-оѵег" 

Р = 3 + (1-а)0 

Исходный пиксел рисуется поверх целевого. Если 
исходный пиксел является полупрозрачным, цвет 
целевого пиксела будет влиять на цвет результата/ 
Это значение является значением по умолчанию 
свойства дІоЬаІСотрозіІеОрегаІііоп. 

"хог" 

Р = (і-а о )3 + (і-а 5 )0 

Если исходный пиксел прозрачен, результатом 
композиции станет целевой пиксел. Если целевой 
пиксел прозрачен, результатом станет исходный 
пиксел. Если оба пиксела, исходный и целевой, яв¬ 
ляются прозрачными или непрозрачными, в ре¬ 
зультате получится прозрачный пиксел. 


Сохранение значений графических параметров 

Методы заѵе( ) и гез1:оге() позволяют сохранять и восстанавливать параметры объекта 
СапѵазВепс1егіпдСопі:ех1:20. Метод заѵе() помещает параметры на вершину стека, а метод 
гезТогеО снимает последние сохраненные параметры с вершины стека и делает их те¬ 
кущими. 

Сохраняются все свойства объекта СапѵазПепсІегіпдСоп1:ех1:20 (за исключением свойства 
сапѵаз, которое является константой). Матрица преобразования и область отсечки 
также сохраняются на стеке, но текущий контур и позиция пера не сохраняются. 

Манипулирование пикселами 

Метод де1:Ітаде0а1:а( ) позволяет получить массив пикселов холста, а метод риіітаде- 
Эа1:а()дает возможность устанавливать отдельные пикселы. Эти методы могут приго¬ 
диться, если потребуется реализовать обработку изображений на языке ^ѵа8сгірі. 

Свойства 

геасіопіу Сапѵаз сапѵаз 

Элемент Сапѵаз, который будет использоваться для создания изображения, 
апу ШІЗІуІе 

Текущий цвет, шаблон или градиент, используемый для заполнения. Это свойство 
может принимать строковое значение либо объект Сапѵазбгасііепі: или СапѵазРаІІіегп. 
По умолчанию заливка выполняется сплошным черным цветом 

зТгіпд -Гопі; 

Шрифт, используемый методами рисования текста. Для определения значения 
этого свойства используется тот же синтаксис, что и при определении значения 
С88-атрибута ^опі. Значение по умолчанию: «ІОрх запз-зегіі». Если размер шриф¬ 
та в строке указан в таких единицах, как «ет» или «ех», или используются клю¬ 
чевые слова, определяющие относительные значения, такие как «Іаг^ег», «зтаі- 
Іег», «ЪоЫег» или «И^Мег», они интерпретируются относительно вычисленного 
С88-стиля шрифта элемента <сапѵаз>. 

сІоиЫе дІоЬаІАІрЬа 

Определяет дополнительный уровень прозрачности, который будет добавляться 
ко всему, что будет нарисовано на холсте. Значение альфа-компонента всех пиксе¬ 
лов, рисуемых на холсте, будет умножаться на значение этого свойства. Диапазон 
значений от 0.0 (полностью прозрачный) до 1.0 (значение по умолчанию: не добав¬ 
ляет дополнительную прозрачность). 
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зігіпд дІоЬаІСотрозііеОрегаііоп 

Определяет порядок смешения («композиции») цветов на холсте. Обычно это свой¬ 
ство бывает полезным только при работе с полупрозрачными цветами или когда 
изменяется значение свойства дІоЬаІАІрИа. Значение по умолчанию: «зоигсе-оѵег». 
Также часто используются значения «сіезііпаііоп-оѵег» и «сору». Перечень допус¬ 
тимых значений приводится в таблице выше. Обратите внимание, что на момент 
написания этих строк броузеры по-разному выполняли некоторые виды компози¬ 
ции: некоторые выполняли композицию локально, а некоторые - глобально. Под¬ 
робности приводятся в разделе 21.4.13. 

зігіпд ІіпеСар 

Определяет, как должны оканчиваться отображаемые линии. Устанавливать это 
свойство имеет смысл только при рисовании толстых линий. Допустимые значе¬ 
ния перечислены в следующей таблице. Значение по умолчанию: «Ъиіі». 


Значение Смысл 

"Ьіііі:" Это значение по умолчанию. Оно указывает, что окончания линий не должны 
рисоваться. В этом случае конец линии выглядит просто как перпендикуляр 
к боковым сторонам линии. Линия не выступает за свои конечные точки. 


"гоііпсГ 


Это значение указывает, что линия должна иметь наконечник в виде полукру¬ 
га с диаметром, равным толщине линии; в результате линия выступает за ко¬ 
нечные точки на половину своей толщины. 


"здііаге" 


Это значение указывает, что линия должна иметь окончание в виде квадрата. 
Это значение по своему поведению напоминает значение «Ъиіі», но при исполь¬ 
зовании данного значения линия выступает за конечные точки на половину 
своей толщины. 


зігіпд ІіпеОоіп 

Когда контур включает вершины, где соединяются прямые линии и/или кривые, 
свойство Ііпе^іп определяет, как должны рисоваться эти вершины. Действие это¬ 
го свойства проявляется только при рисовании толстых линий. 

Значение по умолчанию, «тііег», указывает, что внешние края двух линий в точ¬ 
ке сопряжения должны быть продолжены, пока они не пересекутся. Когда две ли¬ 
нии сопрягаются под очень острым углом, область сопряжения может оказаться 
достаточно длинной. Ограничить максимальную длину такого варианта сопряже¬ 
ния можно с помощью свойства тіІегІЛтіІ:. Когда длина сопряжения превышает 
этот предел, сопряжение просто усекается. 

Значение «гоип<1» указывает, что внешние края линий, образующих вершину, 
должны сопрягаться закрашенной дугой, диаметр которой равен толщине линий. 
Значение «Ъеѵеі» указывает, что внешние края линий, образующих вершину, долж¬ 
ны сопрягаться закрашенным треугольником. 

сІоиЫе ІіпеІШІіП 

Определяет толщину линий для операций рисования. Значение по умолчанию - 1. 
Широкие линии центрируются по воображаемой линии контура на половину тол¬ 
щины в одну сторону и на половину толщины в другую. 

сІоиЫе тііегіітіі 

Когда линии сопрягаются под очень острым углом и при этом свойство Ііпе^іп 
установлено в значение «тііег», область сопряжения может оказаться достаточно 
длинной. Слишком длинная область сопряжения может выглядеть достаточно 
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некрасиво. Свойство тііегІ_іті1: позволяет определить максимальную длину сопря¬ 
жения. Величина этого свойства выражает отношение длины области сопряже¬ 
ния к толщине линий. Значение по умолчанию - 10, оно означает, что область сот 
пряжения по длине никогда не должна превышать толщину линий более чем в 5 
раз. Когда длина сопряжения превышает этот предел, оно просто усекается. 

сІоиЫе зПайомВІиг 

Определяет степень размытия краев тени. Значение по умолчанию - 0; при этом 
тень воспроизводится с резкими краями. Чем больше значение, тем более размы¬ 
тый край тени получается. Имейте в виду, что это значение измеряется не в пиксе¬ 
лах и не подвержено действию текущего преобразования системы координат. 

зігіпд зЬайомСоІог 

Определяет цвет тени в формате С88. По умолчанию используется черный про¬ 
зрачный цвет. 

сІоиЫе зЬайоѵЮіізеіХ 

сІоиЫе зПайоѵЮіізеіѴ 

Определяют горизонтальное и вертикальное смещение теней. Чем больше смеще¬ 
ние, тем выше объект с тенью кажется расположенным над фоном. Значение по 
умолчанию: 0. Эти значения измеряются в единицах системы координат и не зави¬ 
сят от текущего преобразования. 

апу зігокеЗіуІе 

Определяет цвет, шаблон или градиент, используемый для рисования контуров. 
Это свойство может принимать строку с обозначением цвета в формате С88 либо 
объект Сапѵазбгасііепі: или СапѵазРаІІіегп. 

зігіпд іехіАІідп 

Определяет выравнивание текста по горизонтали относительно координаты X, пе¬ 
редаваемой методам ііПТехіО и зі:гокеТех1:(). Допустимыми значениями являются 
«Іеіі», «сепіег», «гі^Ы», «зіагі» и «еп<і». Смысл значений «зіагі» и «еп<1» зависит от 
атрибута сііг (направление письма) тега <сапѵаз>. Значение по умолчанию - «зіагі». 

зіігіпд іехіВазеііпе 

Определяет выравнивание текста по вертикали относительно координаты У, пере¬ 
даваемой методам ііІІТехіО и з1:гокеТех1:(). Допустимыми значениями являются 
«іор», «ті<М1е», «Ьоііот», «аІрЬаЪеііс», «Нап^іп#» и «ігіео^гарЪіс». Значение по 
умолчанию - «аІрЬаЪеііс». 

Методы 

ѵоісі агс(сІоиЫе х,у,гасІіи8,8ТагТАпд1е,епсІАпд1е , [Ьооіеап апіісіоскмізе ]) 

Добавляет в текущий подконтур дугу с заданными центром окружности и радиу¬ 
сом. Первые три аргумента этого метода описывают координаты центра и радиус 
окружности. Следующие два аргумента- это углы, определяющие начальную 
и конечную точки дуги на окружности. Углы измеряются в радианах. Позиция, 
соответствующая трем часам на циферблате, т.е. положительной оси X, имеет 
угол 0. Углы увеличиваются по направлению часовой стрелки. Последний аргу¬ 
мент определяет направление рисования дуги - против часовой стрелки (ігие) или 
по часовой стрелке (іаізе). 

Вызов этого метода добавляет в текущий под контур отрезок прямой линии между 
текущей позицией пера и начальной точкой дуги и затем добавляет дугу. 
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ѵоісі агсТо(сІоиЫе хі, уі, х2, у2, гадіиз ) 

Добавляет в текущий подконтур прямую линию и дугу, описывая эту дугу таким 
образом, что этот метод особенно удобно использовать для рисования закругленных 
углов многоугольников. Аргументы хі и у7 определяют точку Р1, а аргументы х2 
и у2 - точку Р2. Дуга, добавляемая в контур, является частью окружности с радиу¬ 
сом гасНыв. Начальная точка дуги соответствует точке пересечения с касательной, 
соединяющей текущую позицию пера и точку Р1, а конечная соответствует точке 
пересечения с касательной, соединяющей точки Р1 и Р2. Дуга соединяет началь¬ 
ную и конечную точки в кратчайшем направлении. Перед добавлением дуги в кон¬ 
тур этот метод добавляет отрезок прямой линии, соединяющий текущую позицию 
пера с начальной точкой дуги. После вызова этого метода текущей позицией пера 
является конечная точка дуги, расположенная на линии между точками Р1 и Р2. 

Нарисовать квадрат размером 100 х 100 с закругленными углами (с разными ра¬ 
диусами), с помощью объекта контекста с можно следующим образом: 

с. ЬедіпРаіПО; 
с. тоѵеТо(150, 100); 
с.агсТо(200,100,200,200,40); 
с.агсТо(200,200,100,200,30); 

с.агсТо(100,200,100,100,20); 
с.агсТо(100,100,200,100,10); 
с.сІозеРаІНО; 
с. зі: гоке(); 

ѵоісі ЬедіпРаЩ) 

Метод ЬедіпРаЮО отменяет любое существующее определение контура и начинает 
новый. После вызова ЬедіпРа1:іі() текущая позиция пера не определена. 

При создании в первый раз объекта контекста холста неявно вызывается метод 

ЬедіпРа1Н(). 

ѵоісі Ье 2 іегСигѵеТо(сІоиЫе сріх, ср1у,ср2х , ср2у , х, у) 

Метод Ье 2 ІегСигѵеТо( ) добавляет в текущий подконтур холста кривую Безье третье¬ 
го порядка. Начальная точка кривой находится в текущей позиции пера, а коор¬ 
динаты конечной точки определяются аргументами х и у. Форма кривой Безье оп¬ 
ределяется контрольными точками (срХІ, срУІ) и (срХ2, срУ2). По возвращении из 
метода текущей позицией становится точка (х, у). 

ѵоісі с1еагПес1:(с1оиЫе х, у, іѵіРТТ?, Реідііі:) 

Метод сІеагПесіО выполняет заливку указанной прямоугольной области черным 
прозрачным цветом. В отличие от метода гес1(), он не изменяет текущую позицию 
пера и текущий контур. 

ѵоісі с1ір() 

Вычисляет пересечение внутренней области текущего контура с текущей обла¬ 
стью отсечки и использует эту полученную область как новую область отсечки. Об¬ 
ратите внимание, что нет никакого способа увеличить область отсечки. Если об¬ 
ласть отсечки требуется лишь на время, сначала следует вызвать метод заѵе(), что¬ 
бы затем с помощью гезіогеО восстановить прежнюю область отсечки. По умолча¬ 
нию область отсечки совпадает с границами холста. 

Подобно методу И11(), метод с1ір() интерпретирует все контуры как замкнутые 
и отличает внешнюю и внутреннюю области контура с использованием правила 
ненулевого числа оборотов. 


// Начать с середины верхнего края 
// Верхний край и закругленный правый верхний угол 
// Правый край и правый нижний угол с закруглением 
// меньшего радиуса 

// Нижний край и закругленный левый нижний угол 
// Левый край и закругленный левый верхний угол 
// Нарисовать отрезок до начальной точки. 

// Вывести контур 
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ѵоісі сІозеРаТПО 

Если текущий подконтур еще не был замкнут, метод с1озеРа1:М() замыкает его добав¬ 
лением линии, соединяющей текущую и начальную точки контура. После чего на¬ 
чинает новый подконтур (как если бы был вызван метод тоѵеТоО) в текущей точке* 

Методы Ш1() исІірО считают все подконтуры замкнутыми, поэтому явно вызы¬ 
вать метод сІозеРаТІіО необходимо, только если требуется нарисовать замкнутый 
контур. 

ІтадеОаІіа сгеа1:еІтаде0а1:а(Ітаде0а1іа ітадесіаТа ) 

Возвращает новый объект ІтадеОаІіа с теми же размерами, что и сІаТа. 

ІтадеОаІіа сгеа1:еІтаде0а1:а(сІоиЫе к сІоиЬІе Н) 

Возвращает новый объект ІтадеОаІіа с указанной шириной и высотой. Все пикселы 
внутри этого нового объекта ІтадеОаІіа инициализируются черным прозрачным 
цветом (все составляющие цвета и альфа-компонент имеют значение 0). 

Аргументы іѵ и /? определяют размеры изображения в С88-пикселах. Реализациям 
разрешается отображать один С88-пиксел в несколько аппаратных пикселов. 
Свойства ѵѵісЛіІп и Ііеідіііі возвращаемого объекта ІтадеОаІіа определяют размер изо¬ 
бражения в аппаратных пикселах, и их значения могут не совпадать со значения¬ 
ми аргументов іѵ и /?. 

Сапѵазбгасііепіі сгеа1:еІіпеагСга(1іеп1:(с1оиЫе х0 % уО, хі, уі ) 

Создает и возвращает новый объект Сапѵазбгасііепіі, который выполняет линейную 
интерполяцию цветов между заданными начальной и конечной точками. Обрати¬ 
те внимание: этот метод не определяет цвета градиента. Для этих целей следует 
использовать метод асІсІСо1ог8ііор() вновь созданного объекта. Чтобы рисовать ли¬ 
нии или заполнять фигуры с помощью градиента, необходимо присвоить объект 
СапѵазСгасІіепІі свойству зігокеЗііуІе или ІіПЗіуІе. 

СапѵазРаІІіегп сгеа*еРа*1:егп(Е1етепіі ітаде , зіігіпд гереШіоп) 

Создает и возвращает объект СапѵазРаіІіегп шаблона, определяющего повторяю¬ 
щееся изображение. Аргумент ітаде должен быть элементом <ітд>, <сапѵаз> или 
<ѵісІео>, содержащим изображение, которое будет использоваться как шаблон. Ар¬ 
гумент гереіШоп определяет, как будет выкладываться мозаика. Ниже перечис¬ 
лены допустимые значения: 


Значение 

"гереаі" 

"гереаі-х” 

"гереаі-у" 

"по-гереаі" 


Смысл 

Изображение выкладывается мозаикой в обоих направлениях. Это значе¬ 
ние по умолчанию. 

Изображение выкладывается мозаикой только по оси X. 

Изображение выкладывается мозаикой только по оси У. 

Изображение мозаики не повторяется, а используется однократно. 


Чтобы рисовать линии или заполнять фигуры с использованием шаблона, необхо¬ 
димо присвоить объект СапѵазРаІІіегп свойству зІігокеЗііуІе или ІіІІЗііуІе. 

Сапѵазбгасііепіі сгеа1:ейа(1іа1бга(1іеп1(сІоиЬ1е хО, уО, гО , х7, уі, гі) 

Создает и возвращает новый объект Сапѵазбгасііепіі, который выполняет радиаль¬ 
ную интерполяцию цветов между двумя заданными окружностями. Обратите 
внимание: этот метод не определяет цвета градиента. Для этих целей следует ис¬ 
пользовать метод асІсІСо1огЗііор() вновь созданного объекта. Чтобы рисовать линии 
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или заполнять фигуры с помощью градиента, необходимо присвоить объект Сап- 
ѵазбгасііепі: свойству зігокеЗіуІе или ііІІЗіуІе. 

Радиальные градиенты отображаются с использованием цвета со смещением О 
для первой окружности, со смещением 1 для второй окружности и интерполиро 1 
ванными цветами (красная, зеленая и синяя составляющие, а также альфа-ком¬ 
понент) для рисования промежуточных окружностей. 

ѵоісі (1га\Лтаде(Е1етепі ітаде, сіоиЫе бх, бу, [бк біі]) 

Копирует изображение в аргументе ітаде (значением которого должен быть эле¬ 
мент <ітд>, <сапѵаз> или <ѵісІео>) на холст, помещая верхний левый угол изображе¬ 
ния в точку ( бх, бу). Если указаны аргументы бм и б б, изображение будет масшта¬ 
бировано так, чтобы оно уместилось в область шириной бм пикселов и высотой бб 
пикселов. 

ѵоісі <1гамІтаде(Е1етепі: ітаде , сіоиЫе зх, зу, зіѵ, з/?, бх, бу, бм, бб) 

Эта версия метода сІга\л/Ітаде() копирует прямоугольную область изображения 
ітаде в заданную область холста. Значением аргумента ітаде должен быть элемент 
<ітд>, <сапѵаз> или <ѵісІео>. Координаты точки (зх.зу) определяют верхний левый 
угол прямоугольной области в исходном изображении, а аргументы зіѵ и зб - ши¬ 
рину и высоту этой области. Обратите внимание, что значения аргументов измеря¬ 
ются в С88-пикселах и на них не влияют действующие преобразования системы 
координат. Остальные аргументы определяют прямоугольную область холста, ку¬ 
да должно быть скопировано изображение: подробности приводятся в описании 
версии метода сІга\л/Ітаде() с пятью аргументами выше. Обратите внимание, что ар¬ 
гументы, определяющие прямоугольную область холста, преобразуются в соот¬ 
ветствии с текущей матрицей преобразований. 

ѵоісі Ш1() 

Метод іі11() выполняет заливку текущего контура цветом, градиентом или шаб¬ 
лоном, заданным свойством ііІІЗіуІе. Любой незамкнутый подконтур заполняет¬ 
ся так, как если бы для него неявно был вызван метод сІозеРаіІіО. (Обратите вни¬ 
мание: это не означает, что вызов этого метода сделает подконтур замкнутым.) 

Операция заливки текущего контура не очищает его. Можно сразу вслед за мето¬ 
дом іі11() вызвать метод зігокеО без повторного определения пути. 

Когда контур пересекает сам себя или состоит из нескольких накладывающихся 
друг на друга подконтуров, метод Ш1() пользуется правилом ненулевого числа 
оборотов для определения, какие точки находятся внутри, а какие вне контура. 
Это означает, например, что если контур определяет квадрат внутри окружности 
и подконтур квадрата нарисован в направлении, противоположном направлению 
рисования окружности, то область внутри квадрата будет считаться лежащей вне 
контура и не будет заполняться. 

ѵоісі ^іІІЙесІ^сІоиЫе х, у, и/іббб, беідбб) 

Метод ііІІРесіО выполняет заливку заданного прямоугольника цветом, градиен¬ 
том или шаблоном, который задается свойством ііІІЗіуІе. 

В отличие от метода гесі(), метод ііІІРесіО не влияет на текущую позицию пера 
и текущий контур. 

ѵоісі ^і11Тех1:(5І:гіпд бехб, сіоиЫе х, у, [сіоиЫе тахШббб ]) 

Метод іі11Техі( ) рисует текст бехб, используя текущие значения свойств Еопі и ііІІ¬ 
ЗіуІе. Аргументы х и у определяют координаты, где должен выводиться текст, но 
интерпретация этих аргументов зависит от свойств іехіАІідп и іехіВазеІіпе, соот¬ 
ветственно. 
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Если свойство іехіАІідп имеет значение «Іеіі» или «зіагі» (по умолчанию), в случае 
использования направления для письма слева направо (также по умолчанию), или 
«еші» в случае использования’письма справа налево, текст выводится правее ука¬ 
занной координаты X. Если свойство іехіАІідп имеет значение «сепіег», текст цен¬ 
трируется по горизонтали относительно указанной координаты X. В противном 
случае (если ТехТАІідп имеет значение «гі^Ьі», «еші» для письма слева направо или 
«зіагі» для письма справа налево) текст выводится левее указанной координаты X. 

Если свойство ТехТВазеІіпе имеет значение «аІрЬаЪеііс» (по умолчанию), «Ъоііот» 
или «Ыео^гарЫс», большинство символов будут нарисованы выше указанной ко¬ 
ординаты У. Если свойство іехіВазеІіпе имеет значение «сепіег», текст будет цен¬ 
трироваться по вертикали относительно указанной координаты У. А если свойст¬ 
во іехіВазеІіпе имеет значение «іор» или «Ьап^іп^», большинство символов будут 
нарисованы ниже указанной координаты У. 

Необязательный аргумент тахѴл/ісІ1:И определяет максимальную ширину текста. Ес¬ 
ли текст в аргументе Іехі: окажется шире, чем определено аргументом тахМісШі 9 он 
будет нарисован более мелким или более узким шрифтом. 

ІтадеОаіа деіІтадеОаіа(сІоиЫе зх, зу, зіѵ, зіі) 

Аргументы этого метода определяют непреобразованные координаты прямоуголь¬ 
ной области холста. Метод копирует пикселы из этой области холста в новый объ¬ 
ект ІтадеОаіа и возвращает этот объект. Как получить доступ к составляющим 
цвета и альфа-компонентам отдельных пикселов, описывается в справочной ста¬ 
тье ІтадеОаіа. 

Компоненты КОВ цвета возвращаемых пикселов не учитывают значение альфа- 
компонента. Если какая-либо часть запрошенной области оказывается за граница¬ 
ми холста, соответствующие пикселы в объекте ІтадеОаіа устанавливаются в чер¬ 
ный прозрачный цвет (все компоненты цвета равны нулю). Если для представле¬ 
ния одного С88-пиксела реализация использует несколько аппаратных пикселов, 
значения свойств місіііі и ИеідЫ: возвращаемого объекта ІтадеОаіа будут отличаться 
от значений аргументов зіѵ и з/?. 

Подобно методу Сапѵаз.1:о0а1:аІЖ(), этот метод препятствует утечке информации ме¬ 
жду доменами. Метод де1:Ітаде0а1:а() возвращает объект ІтадеОаіа, только если изо¬ 
бражение в холсте имеет общее происхождение с документом; в противном случае 
он возбуждает исключение. Считается, что холст не имеет общего происхождения 
с документом, если в нем содержалось изображение (созданное непосредственно 
с помощью метода с1гаѵѵІтаде() или косвенно, с помощью объекта СапѵазРаііегп), 
имеющее иное происхождение, отличное от происхождения содержащего его доку¬ 
мента. Кроме того, считается, что элемент <сапѵаз> имеет неясное происхождение, 
если в нем рисовался текст с использованием веб-шрифтов, имеющих иное проис¬ 
хождение. 

Ьооіеап ізРоіпіІпРаіЬ(сІоиЫе х, у) 

Метод ізРоіпіІпРаіІіО возвращает ігие, если указанная точка попадает в пределы 
текущего контура; в противном случае он возвращает іаізе. Указанные координа¬ 
ты интерпретируются в системе координат, не преобразованной с применением те¬ 
кущей матрицы преобразования. Аргумент х должен иметь значение между 0 
и сапѵаз.ѵл/ісІііИ, а аргумент у - между 0 и сапѵаз.ІлеідНІ:. 

Причина, почему ізРоіітіІпРаІіИ () использует непреобразованные координаты, со¬ 
стоит в том, что он предназначен для «проверки попадания»: определения попада¬ 
ния указателя мыши во время щелчка (например) в область холста, ограниченную 
контуром. Чтобы выполнить проверку попадания, координаты указателя мыши 
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сначала должны быть преобразованы из координат окна в координаты холста. Если 
экранные размеры холста отличаются от размеров, определяемых атрибутами ѵѵісЛіМ 
и ІіеідІгЕ (например, в случае установки атрибутов з*у1е.ѵ\/ісІ*И и зііуіе.Меідіг*:), коор¬ 
динаты указателя мыши также необходимо привести к масштабу, соответствую¬ 
щему масштабу системы координат холста. Ниже демонстрируется функция, кото¬ 
рая может использоваться как обработчик опсііск элемента <сапѵаз> и выполнять 
необходимые преобразования координат указателя мыши в координаты холста: 

// Обработчик опсііск для тега <сапѵаз>. Предполагается, что текущий контур определен. 
1"ипс1ііоп ПіІіезКеѵепі:) { 

ѵаг сапѵаз = ІПіз; // Вызывается в контексте холста 

ѵаг с = сапѵаз.деіСопІехІ("26"); // Получить контекст рисования для холста 

// Получить размеры и координаты холста 
ѵаг ЬЬ = сапѵаз.деіВоііпсІіпдС1іепі:Пес1і(); 

// Преобразовать координаты указателя мыши в координаты холста 
ѵаг х = (еѵепі. сііепІХ-ЬЬ. Іе^І:)*(сапѵаз.\ѵіс!1:Іт/ЬЬ.\ѵіс!1:М): 
ѵаг у = (еѵепі.сііепІУ-ЬЬ.Іор)*(сапѵаз.НеідІті/ЬЬ.НеідІтЬ); 

// Залить контур, если пользователь щелкнул в его пределах 
Н (с. ізРоіпІІпРаІПСх, у)) с.НПО; 

} 

ѵоіб 1іпеТо(сІоиЫе х, боиЫе у) 

Метод ІіпеТоО добавляет прямую линию в текущий подконтур. Линия начинается 
в текущей позиции пера и заканчивается в точке с координатами (х.у). Когда этот 
метод возвращает управление, текущая позиция перемещается в точку (х.у). 

ТехіМеІгісз теазигеТехг(зі:гіпд ТехТ) 

Метод теазигеТехіО вычисляет ширину текста ТехТ, которую он займет при рисова¬ 
нии с текущим значением свойства ^опі, и возвращает объект ТехІіМеІігісз, содержа¬ 
щий результаты вычислений. На момент написания этих строк возвращаемый 
объект имел только одно свойство, ѵѵісіііН, а высота текста и параметры описываю¬ 
щего прямоугольника не вычислялись. 

ѵоіб тоѵеТо(с1оиЫе х, боиЫе у) 

Метод тоѵеТо( ) переносит текущую позицию пера в точку (х.у) и создает новый под¬ 
контур с начальной точкой в этой точке. Если перед этим существовал подконтур, 
состоящий из единственной точки, этот пустой подконтур удаляется из текущего 
контура. 

ѵоіб риііІтадеОаііа(ІтадеОаііа ітадебата, боиЫе с/х, бу, [зх, зу, зіѵ, зіі]) 

Метод ри1іІтаде0аііа( ) копирует прямоугольную область из объекта ІтадеОаііа в холст. 
Он выполняет низкоуровневую операцию копирования пикселов, игнорируя зна¬ 
чения свойств діоЬаІСотрозіІеОрегаІііоп и дІоЬаІАІрМа, а также область отсечки, мат¬ 
рицу преобразования и атрибуты, управляющие отображением тени. 

Аргументы бх и бу определяют координаты назначения в холсте. Пикселы из объ¬ 
екта в аргументе ітадебаТа будут копироваться в холст, начиная с этой точки. Зна¬ 
чения этих аргументов не подвергаются преобразованию с применением текущей 
матрицы преобразования. 

Последние четыре аргумента определяют исходную прямоугольную область в объ¬ 
екте ІтадеОаііа. Скопированы будут только пикселы из указанной прямоугольной 
области. Если эти аргументы отсутствуют, объект ІтадеОаііа будет скопирован це- 
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ликом. Если эти аргументы определяют прямоугольник, выходящий за границы 
объекта ІтадеОаііа, прямоугольник будет обрезан по этим границам. В аргументах 
зх и зу допускается передавать отрицательные значения. 

Одна из ролей объектов ІтадеОаііа - служить «временным хранилищем» для содер¬ 
жимого холста. Сохранение копии холста (с использованием метода деТІтадеОаі:а( )У 
позволяет временно наносить на холст изображения и затем восстанавливать 
прежнее состояние холста с помощью риТІтадеОаі:а(). 

ѵоісі диа<1га1ісСигѵеТо(сІоиЬ1е срх , сру, х , у) 

Данный метод добавляет кривую Безье второго порядка в текущий подконтур. На¬ 
чальная точка кривой находится в текущей позиции, а координаты конечной точки 
определяются аргументами х и у. Форма кривой Безье, соединяющей эти две точки, 
определяется контрольной точкой ( срХ, срУ). По возвращении из метода текущей 
позицией становится точка (х,у). Обратите также внимание на метод ЬегіегСигѵеТо( ). 

ѵоісі гес1(с!оиЫе х, у, м, Р) 

Добавляет в контур прямоугольник. Прямоугольник представляет собой отдель¬ 
ный подконтур, который никак не связан ни с одним из имеющихся подконтуров. 
По возвращении из метода текущей позицией становится точка (х,у). Бызов этого 
метода эквивалентен следующей последовательности вызовов: 

с. тоѵеТо(х, у); 
с. 1іпеТо(х+м, у); 
с. 1іпеТо(х+м, у+М); 
с.1іпеТо(х, у+Ю; 
с. с1озеРа1:И(): 

ѵоісі гезі:оге() 

Метод снимает с вершины стека значения параметров холста и записывает их 
в свойства объекта СапѵазПепсІегіпдСопііех1і20, восстанавливая область отсечки и мат¬ 
рицу преобразования. Дополнительные сведения см. в справочной статье заѵе(). 

ѵоісі го1іа1іе(сІоиЫе апдіё) 

Данный метод изменяет текущую матрицу преобразования таким образом, что лю¬ 
бые фигуры, нарисованные после вызова этого метода, выглядят повернутыми на 
указанный угол. Этот метод не выполняет вращение самого элемента <сапѵаз>. Об¬ 
ратите внимание: угол задается в радианах. Чтобы преобразовать градусы в радиа¬ 
ны, нужно умножить величину угла на константу Маіііі. РІ и разделить на число 180. 

ѵоісі заѵе() 

Метод заѵе() помещает копию текущих параметров холста на вершину стека со¬ 
храняемых параметров. Это позволяет внести временные изменения в какие-либо 
параметры и затем восстановить предыдущие значения вызовом метода гезі:оге(). 

В перечень сохраняемых параметров входят все свойства объекта СапѵазПепсІегіпд- 
Сопіехі20 (за исключением доступного только для чтения свойства сапѵаз), а также 
матрица преобразования, которая является результатом вызова методов гоіаіе(), 
зса1е() и Ігапз1а1:е(). Кроме того, в стеке сохраняется область отсечки, созданная 
методом с1ір(). Однако следует заметить, что текущие контур и позиция пера не 
входят в данный перечень и этим методом не сохраняются. 

ѵоісі зса1е(сІоиЫе зх, РоиЫе зу) 

Метод зса1е( ) добавляет преобразование масштаба в текущую матрицу преобразо¬ 
вания холста. Масштабирование выполняется отдельно по горизонтали и по вер¬ 
тикали. Например, если передать методу значения 2.0 и 0.5, все последующие фи¬ 
гуры будут иметь в два раза большую ширину и в два раза меньшую высоту по 
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сравнению с тем, как они выглядели бы, если бы они были нарисованы до вызова 
метода зса1е(). Отрицательные значения аргумента $х вызывают зеркальное отра¬ 
жение координат относительно оси У, а отрицательные значения аргумента зу вы¬ 
зывают зеркальное отражение координат относительно оси X. 

ѵоісі зе1:Тгапз^огт(с1оиЫе а , Ь, с, с/, е, Т) 

Этот метод позволяет напрямую установить матрицу преобразования, не выпол¬ 
няя последовательность вызовов методов *гап5Іа*е(), зса1е() и го*а*е(). После вызо¬ 
ва этого метода новое преобразование будет иметь вид: 

х‘ асе х =ах+су+е 
у' = Ь сі ^ х у =Ьх + сІу+^ 

1 0 0 1 1 

ѵоісі з1гоке() 

Метод зі:гоке() выполняет рисование линий, составляющих текущий контур. Кон¬ 
тур определяет лишь геометрию линии, которая должна быть воспроизведена, 
а визуальное ее представление зависит от значений свойств зіігокеЗііуІе, Ііпеіл/ісііііі, 
ІіпеСар, ІіпеОоіп и тіі:ег1іті1:. 

Под термином зігоке (чертить) понимается вычерчивание линий пером или ки¬ 
стью. Это означает «нарисовать контур». В противовес методу зі:гоке( ), метод Ш1() 
выполняет заливку внутренней области без рисования ее контура. 

ѵоісі зІтокеНесЦсІоиЫе х, у, м, И) 

Рисует контур (не выполняя заливку внутренней области) прямоугольника с за¬ 
данными координатами и размерами. Цвет и толщина линий определяются значе¬ 
ниями свойств зіігокеЗііуІе и ІіпеМісІІіІі. Стиль оформления сопряжений в углах пря¬ 
моугольника определяется значением свойства ІігЫоіп. 

В отличие от метода гесі(), метод 5ІігокеВес1і() не оказывает влияния на текущий 
контур или текущую позицию пера. 

ѵоісі з*гокеТехЦзіігіпд Техі, РоиЫе х, у, [тхШбТіі]) 

Метод зіігокеТехЦ) действует подобно методу ііІІТехіО, за исключением того, что он 
не выполняет заливку отдельных символов в соответствии со значением свойства 
ШІЗііуІе, а рисует только контуры каждого символа, учитывая значение свойства 
зіігокеЗііуІе. Для шрифтов большого размера метод зігокеТех1:() обеспечивает инте¬ 
ресный графический эффект, но на практике для рисования текста чаще исполь¬ 
зуется метод ШГТехЦ). 

ѵоісі Іігапз^огпКсІоиЫе а, Ь, с, сУ, е , Т) 

Аргументы этого метода определяют шесть нетривиальных элементов матрицы Т 
аффинного преобразования размером 3x3: 

асе 
Ь 6 Г 
0 0 1 

Метод *гапз^огт() умножает текущую матрицу преобразования на матрицу Т 
и принимает результат в качестве текущей матрицы преобразования: 

СТМ‘ = СТМ X т 

В терминах универсального метода ІігапзІ'огтО можно реализовать операции сме¬ 
щения, масштабирования и вращения. Чтобы выполнить смещение, можно произ¬ 
вести вызов *гапз1 : огт(1,0,0 1 1,с1х ) с1у). Чтобы выполнить масштабирование - ігапз- 
^огт(зх, 0, 0, зу, 0, 0). Для выполнения вращения по часовой стрелке на угол х: 

ІгапзІ'огтСсозСх), зіп(х),-зіп(х), соз(х), 0, 0) 
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Чтобы выполнить сдвиг параллельно оси X на множитель к, можно произвести 
вызов 1:гапз1 = огт(1,0,к 1 1 1 0,0). Сдвига параллельно оси У можно добиться вызовом 
ТгапзІтэгтО.к.О.І.О.О). 

ѵоісі Тгапз1аТе(сІоиЫе х, сІоиЫе у) 

Метод ТгапзІаТеО добавляет горизонтальное и вертикальное смещения в матрицу 
преобразования холста. Значения аргументов х и у добавляются к координатам 
всех точек, которые затем будут добавляться в контур. 

СІіепІКесІ 

прямоугольник, описанный вокруг элемента 

Объект СПепТВесТ описывает прямоугольник в системе координат объекта Іл/іпсісм или 
видимой области. Объект этого типа, определяющий параметры описанного прямо¬ 
угольника элемента, возвращает метод де1:ВоипсііпдС1 іеп1:Рес1:( ) объекта Еіешепі:. Объ¬ 
екты СІіепТНесі: являются статическими: они не изменяются при изменении соответ¬ 
ствующих им элементов. 

Свойства 

геасіопіу Иоаі ЬоТТот 

Координата У нижней границы прямоугольника относительно видимой области, 
геасіопіу Иоаі: йеідМ* 

Высота прямоугольника в пикселах. В ІЕ версии 8 и ниже это свойство не опреде¬ 
лено; вместо него следует использовать выражение ЬоИот-^ор. 

геасіопіу Иоаі: ІеТі 

Координата X левой границы прямоугольника относительно видимой области. 

геасіопіу Иоаі: гідМ: 

Координата X правой границы прямоугольника относительно видимой области. 

геасіопіу Поаі: Тор 

Координата У верхней границы прямоугольника относительно видимой области, 
геасіопіу ТІоаТ місГСП 

Ширина прямоугольника в пикселах. В ІЕ версии 8 и ниже это свойство не опреде¬ 
лено; вместо него следует использовать выражение гідШ-ІеТТ. 

СІозеЕѵепІ 

определяет, был ли закрыт веб-сокет без ошибок Еѵепі 

Когда закрывается соединение МеЬЗоске*, в объекте Іл/еЬЗоскеІ: возбуждается невсплы¬ 
вающее и неотменяемое событие «сіозе», и всем зарегистрированным обработчикам 
этого события передается объект СІозеЕѵепТ. 

Свойства 

геасіопіу Ьооіеап мазСІеап 

Если соединение МеЬЗоскеТ было закрыто управляемым способом, как определяет¬ 
ся протоколом веб-сокетов, с подтверждением со стороны клиента и сервера, гово¬ 
рят, что закрытие было выполнено чисто , и это свойство имеет значение 1: г и е. Если 
это свойство имеет значение ^аізе, веб-сокет мог быть закрыт в результате какой- 
либо сетевой ошибки. 




Соттепі 


905 


Соттепі 

НТМЬ или ХМЬ-комментарий Ьіосіе 

♦ 

Узел Соттепі представляет комментарий в НТМЬ- или ХМЬ-документе. Содержимое 
комментария (т. е. текст между <! -- и -->) доступно через свойство сіаіа или через свой¬ 
ство посІеѴаІие, унаследованное от интерфейса ІМосІе. Создать объект Соттепі можно ме¬ 
тодом 0оситепі.сгеаіеСоттеп1(). 

Свойства 

зігіпд <1аіа 

Текст комментария, 
геасіопіу ипзідпесі Іопд Іепдій 

Количество символов в комментарии. 

Методы 

ѵоісі арреп<Юаіа( 5 Ігіпд Раіа) 

ѵоісі 0е1е1еОаіа(ипзідпесІ Іопд оТТзеТ, ипзідпесі Іопд соипі) 
ѵоісі іпзегЮаіа(ипзідпесІ Іопд оТТзеі зігіпд баіа) 

ѵоісі гер1асе0а1а(ипзідпесІ Іопд оТТзеі , ипзідпесі Іопд соі/лі, зігіпд баіа) 
зігіпд зиЬзІгіпд0а1а(ипзідпесІ Іопд оТТзеі ипзідпесі Іопд соипі:) 

Узлы Соттепі обладают большинством методов узла Техі, и эти методы действуют 
так же, как в случае с узлами Техі. Они перечислены здесь, но их описание приво¬ 
дится в справочной статье Техі. 

Сопзоіе 

вывод отладочной информации 

Современные броузеры (и более ранние версии, с установленными расширениями-от¬ 
ладчиками, такими как ГігеЪи&) определяют глобальное свойство сопзоіе, ссылаю¬ 
щееся на объект Сопзоіе. Методы этого объекта образуют АРІ для выполнения про¬ 
стых отладочных операций, таких как вывод сообщений в окно консоли (консоль 
можно открыть выбором пункта меню, такого как йеѵеіорег Тооіз (Средства разработчика) 
или ѴѴеЬ Іпзресіог (Веб-консоль). 

В настоящее время не существует официального стандарта, определяющего АРІ объ¬ 
екта Сопзоіе, но расширение ГігеЪи& для ГігеСох установило стандарт де-факто и про¬ 
изводители броузеров стремятся реализовать прикладной интерфейс ГігеЪи&, опи¬ 
санный здесь. Поддержка базовой функции сопзоіе. 1од() реализована практически 
повсеместно, но реализация других функций может присутствовать не во всех броузе¬ 
рах. Имейте в виду, что в некоторых старых броузерах свойство сопзоіе определено, 
только если открыто окно консоли, и сценарии, использующие объект Сопзоіе, когда 
окно консоли не открыто, будут вызывать появление ошибок. 

См. также СопзоІеСоттапсЛіпе. 

Методы 

ѵоісі аззег1(апу ехргеззіоп, зігіпд теззаде ) 

Выводит сообщение об ошибке теззаде в консоли, если выражение ехргеззіоп имеет 
значение Іаізе или любое ложное значение, такое как пиіі, ипсіеііпесі, 0 или пустая 
строка. 
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ѵоісі соипЩзігіпд ТШе]) 

Выводит строку ТШе вместе со счетчиком вызовов данного метода с этой же стро¬ 
кой. 

ѵоісі <1еЬид(апу теззаде...) 

Действует подобно методу сопзо1е.1од(), но помечает вывод, как отладочную ин¬ 
формацию. 

ѵоісі <1іг(апу оЬдесТ) 

Выводит в консоли информацию об объекте в виде, позволяющем разработчику 
проверить свойства или элементы и в интерактивном режиме исследовать вложен¬ 
ные объекты и элементы массивов. 

ѵоісі (1ігхт1(апу поде) 

Выводит в консоль разметку ХМЬ или НТМЬ узла документа, 
ѵоісі еггог(апу теззаде...) 

Действует подобно методу сопзо1е.1од(), но помечает вывод как ошибку, 
ѵоісі дгоир(апу теззаде...) 

Выводит сообщение теззаде подобно методу 1од(), но отображает его как заголовок 
свертываемой группы отладочных сообщений. Все последующие операции вывода 
в консоль будут помещать сообщения в эту группу, пока не будет вызван соответ¬ 
ствующий метод дгоирЕпсК). 

ѵоісі дгоирСо11арзе(1(апу теззаде...) 

Создает новую группу сообщений, но в свернутом состоянии, так что по умолча¬ 
нию последующие отладочные сообщения будут скрыты. 

ѵоісі дгоирЕп<1() 

Закрывает самую последнюю группу отладочных сообщений, созданную вызовом 
метода дгоир() или дгоирСоІІарзесК). 

ѵоісі іп^о(апу теззаде...) 

Действует подобно методу сопзо1е.1од(), но помечает вывод как информационное 
сообщение. 

ѵоісі 1од(зі:гіпд Тогтаі, апу теззаде...) 

Выводит свои аргументы в консоль. В простейшем случае, когда строка Тогтаі не 
содержит спецификаторов, начинающихся с символа %, метод просто преобразует 
свои аргументы в строки и выводит их, отделяя друг от друга пробелами. Когда 
методу передается объект, строка, выведенная в консоль, будет доступна для 
щелчка мышью и позволит просматривать содержимое объекта. 

Для вывода более сложных сообщений данный метод поддерживает простейшие 
спецификаторы формата функции ргіп1:і( ) из языка С. Аргументы теззаде будут ин¬ 
терполироваться в аргумент Тогтаіу на место последовательностей символов «%8», 
«%(1», «%і», «%і>> и «%о», после чего в консоль будет выведена отформатированная 
строка (со следующими за ней аргументами теззаде , для которых отсутствуют спе¬ 
цификаторы в аргументе ГогтаТ). Аргументы, соответствующие спецификатору 
«%8», форматируются как строки. Аргументы, соответствующие спецификаторам 
«%(1» и «%і», форматируются как целые числа. Соответствующие спецификатору 
«%і>> форматируются как вещественные числа, а соответствующие спецификатору 
«%о» - как объекты, доступные для щелчка мышью. 

ѵоісі рго^і1е([з1:гіпд ТШе]) 

Запускает профилировщик ^ѵаЗсгірі; и в начале отчета отображает строку ТіТІе. 
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ѵоісі ргоіі1еЕп<1() 

Останавливает профилировщик и выводит отчет с результатами профилирования 
программного кода. 

ѵоісі ііте(зігіпд пате ) 

Запускает таймер с именем пате . 

ѵоісі іітеЕп<1(5ігіпд пате) 

Останавливает таймер с именем пате и выводит имя и время, прошедшее с момента 
вызова соответствующего метода ііте(). 

ѵоісі ігасе() 

Выводит трассировку стека, 
ѵоісі магп(апу теззаде...) 

Действует подобно методу сопзо1е.1од(), но помечает вывод как предупреждение. 

СопзоІеСоттапсіипе 

глобальные утилиты для работы с окном консоли 

Большинство веб-броузеров поддерживают консоль ^ѵабсгірі; (которую вы, возмож¬ 
но, знаете как «Средства разработчика» («Беѵеіорег Тооіз») или «Веб-консоль» («АѴеЪ 
Іпзресіог»), которая позволяет вводить одиночные строки программного кода на язы¬ 
ке ЛѵаВсгірі. В дополнение к обычным глобальным переменным и функциям кли¬ 
ентского ЛѵаВсгірі командная строка консоли обычно поддерживает полезные свой¬ 
ства и функции, описываемые здесь. 

См. также Сопзоіе. 

Свойства 

геасіопіу Еіетепі $0 

Элемент документа, выбранный последним некоторыми средствами отладчика. 

геасіопіу Еіетепі $1 

Элемент документа, выбранный перед элементом $0. 

Методы 

ѵоісі ссі(\л/іпсіоѵѵ Тгате) 

Когда документ включает вложенные фреймы, функция ссІ() позволяет переклю¬ 
чать глобальные объекты и выполнять последующие команды в области видимо¬ 
сти фрейма Тгате. 

ѵоісі с1еаг() 

Очищает окно консоли, 
ѵоісі <1іг(оІЭ]есі о) 

Выводит свойства или элементы объекта или массива о. Действует подобно методу 

Сопзоіе.с!іг(). 

ѵоісі <1ігхт1(Е1етепі еІТ) 

Выводит разметку ХМЬ или НТМЬ элемента еіТ. Действует подобно методу Сопзоіе. 
с!ігхт1(). 

Еіетепі $(зігіпд ісУ) 

Краткий псевдоним функции сІоситепі.деіЕІетепіВуІсК). 
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І\ІосіеІ_і5І: $$(з1:гіпд зеІесТог ) 

Возвращает объект, подобный массиву, содержащий все элементы, соответствую¬ 
щие С88-селектору зеІесТог. Это краткий псевдоним функции сіоситепіі.диегуЗеІес- 
іогА11( ). В некоторых броузерах возвращает настоящий месив, а не объект МосІеНзТ. 

ѵоіеі іпзрес1:(апу оР^есТ, [зТгіпд ТаРпате]) 

Отображает объект оРіесТ, при этом может переключаться из консоли на другую 
вкладку отладчика. Во втором аргументе передается необязательная подсказка, 
определяющая, как должен отображаться объект о^есі. Поддерживаются значе¬ 
ния: «ЫіШІ», «С88», «8сгірі» и «йот». 

зігіпдП кеуз(апу оРіесТ) 

Возвращает массив с именами свойств объекта оРіесТ. 

ѵоіеі топі*огЕѵегЦ5(Е1етепі: оРіесТ, [зігіпд Туре]) 

Выводит сообщения о событиях типа Туре , доставляемых в объект оР^есТ. В число 
поддерживаемых значений аргумента Туре входят: «тоизе», «кеу», «іехі», «Іоай», 
«іогт», «Йга&» и «сопіехітепи». Если аргумент Туре не указан, выводятся сообще¬ 
ния обо всех событиях в объекте оРіесТ. 

ѵоіеі рго^і1е(зі:гіпд ТіТІе) 

Запускает профилировщик программного кода. Действует подобно методу Сопзо- 
1е.ргоШе(). 

ѵоіеі рго^ПеЕпРО 

Останавливает профилировщик. Действует подобно методу Сопзоіе. ргоіі1еЕпсі(). 
ѵоіеі иптопі*огЕѵеп*5(Е1етеп1: оЦесТ . [зігіпд Туре]) 

Останавливает мониторинг событий типа Туре в объекте оРіесТ . 
апу[] ѵа1иез(апу оРіесТ) 

Возвращает массив значений свойств объекта оРіесТ. 

СББ2РгореПіе$ 

см. С555іу1е0ес1агаііоп 

СББКиІе 

правило в таблице стилей С55 

Описание 

Объект СЗЗВиІе является представлением правила в объекте таблице С88-стилей 
СЗЗЗіуІеЗПееІ:: он дает информацию о стилях, которые должны применяться к опреде¬ 
ленному набору элементов документа. Свойство зеІесіогТехІ: - это строковое представ¬ 
ление селектора элемента для данного правила, а свойство зіуіе - ссылка на объект 
СЗЗЗіуІеОесІагаІііоп, который представляет набор атрибутов стилей, применяемых 
к выбранным элементам. 

Иерархия подтипов СЗЗВиІе для представления различных видов правил, которые мо¬ 
гут появляться в таблицах стилей, определяется в спецификации «С88 ОЬіесІ; Мойеі». 
Свойства, описанные здесь, являются универсальными для типа СЗЗВиІе и его подти¬ 
па СЗЗЗіуІеВиІе. Правила стилей являются наиболее общими и наиболее важными ти¬ 
пами правил в таблицах стилей и наиболее часто используемыми в сценариях. 

В ІЕ версии 8 и ниже в объектах СЗЗВиІе поддерживаются только свойства зеІесіогТехІ: 
и зіуіе. 
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Константы 

ипзідпесі зііогіі $ТѴІ_Е_НШ_Е = 1 
ипзідпесі зИогТ ІМРОНТ_НІЛ_Е = 3 
ипзідпесі зііогіі МЕОІА_НШ_Е = 4 
ипзідпесі зііогіі РОМТ_РАСЕ_НШ_Е = 5 
ипзідпесі зііогіі РА6Е_НШ_Е = 6 
ипзідпесі зПогИ ММЕ$РАСЕ_НІЛ_Е = 10 

Это допустимые значения свойства Туре, представленного ниже, и они определяют 
тип правила. Если свойство Туре имеет какое-либо значение, отличное от 1, объект 
СЗЗВиІе получит дополнительные свойства, не описываемые здесь. 

Свойства 

зТгіпд сззТехг 

Полный текст данного С88-правила. 
геасіопіу СЗЗВиІе рагеп*Ни1е 

Правило, если таковое имеется, в котором содержится данное правило, 
геасіопіу СЗЗЗТуІеЗМееТ рагепгЗгуІеЗНееІ: 

Таблица стилей, внутри которой содержится данное правило, 
зіігіпд зеІесгогТех* 

Когда свойство Туре имеет значение ЗТѴІ_Е_ВІІІ_Е, это свойство хранит текст селекто¬ 
ра, определяющего элементы документа, к которым применяется это правило. 

геасіопіу СЗЗЗТуІеЭесІагаТіоп з*у1е 

Когда свойство Туре имеет значение ЗТѴІ_Е_ВІІІ_Е, это свойство определяет стили, ко¬ 
торые должны применяться к элементам, определяемым свойством зеІесіогТехІ:. 
Обратите внимание: несмотря на то что свойство зТуІе доступно только для чте¬ 
ния, свойства объекта СЗЗЗТуІеОесІагаТіоп, на которое оно ссылается, доступны для 
чтения и записи. 

геасіопіу ипзідпесі зРогТ *уре 

Тип данного правила. Значением этого свойства могут быть только константы, 
представленные выше. 

С555іуІеОесІагаІіоп 

набор С55-атрибутов и их значения 

Объект СЗЗЗііуІеОесІа гаіііоп представляет набор С88-атрибутов стиля и их значения, 
и позволяет манипулировать этими атрибутами, используя имена свойств, похожие 
на имена С88-свойств. Свойство зііуіе элемента НТМІ_Е1етепіі является доступным для 
чтения и записи объектом СЗЗЗііуІеОесІа гаіііоп и подобно свойству зііуіе объекта СЗЗВиІе. 
Однако метод \л/іпсіо\л/.де1іСопгіриііесІЗііу1е( ) возвращает объект СЗЗЗііуІеОесІагаіііоп, свойст¬ 
ва которого доступны только для чтения. 

Объект СЗЗЗііуІеОесІагаіііоп обеспечивает доступ к С88-атрибутам стиля посредством 
свойств. Имена этих свойств практически однозначно соответствуют именам 088-ат¬ 
рибутов, незначительно измененными для соответствия синтаксису языка ^ѵабсгірі. 
Имена атрибутов, сконструированные из нескольких слов и содержащие дефисы, та¬ 
кие как «іопі-іатііу», записываются без дефисов, а каждое слово, кроме первого, начи¬ 
нается с заглавного символа: РопііРатіІу. Кроме того, имя атрибута «йоаі;» совпадает 
с зарезервированным словом Иоаіі, поэтому оно преобразовано в имя свойства сззРІоаІі. 
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Обратите внимание, что имеется возможность использовать неизмененные имена 088- 
атрибутов, если для доступа к свойствам использовать строки и квадратные скобки. 

Свойства 

Помимо свойств, описанных выше, объект СЗЗЗіуІеОесІагаіііоп имеет два дополнитель¬ 
ных свойства: 

зіігіпд сззТехІі 

Текстовое представление набора атрибутов стиля и их значений. Текст форматиру¬ 
ется, как в таблицах стилей С88, за исключением селектора элемента и фигурных 
скобок, окружающих атрибуты и значения. 

геасіопіу ипзідпесі Іопд ІепдІМ 

Количество пар атрибут/значение, содержащихся в данном объекте СЗЗЗіуІеОесІа- 
гаіііоп. Объект СЗЗЗііуІеОесІагаіііоп является также объектом, подобным массиву, 
элементами которого являются имена объявленных С88-атрибутов стиля. 

СБББІуІеБНееі 

таблица стилей С55 

Этот интерфейс представляет таблицу стилей С88. Он обладает свойствами и метода¬ 
ми, позволяющими деактивировать таблицу стилей, читать, вставлять и удалять 
объекты правил СЗЗРиІе. Объекты СЗЗЗііуІеЗИееІ:, которые применяются к документу, 
являются элементами массива з1:у1еЗИее1:з[ ] объекта Ооситепі и также доступны через 
свойство зііееіі элементов <зіу1е> и <1іпк>, определяющих таблицы стилей или ссылаю¬ 
щихся на них. 

В ІЕ версии 8 и ниже вместо массива сззРи1ез[] используется массив ги1ез[], а вместо 
стандартных методов іпзег1іРи1е() и РеІеіеРиІеО - методы ас!сІРи1е() и гетоѵеРи1е(). 

Свойства 

геасіопіу СЗЗРи1е[] сззРиІез 

Доступный только для чтения объект, подобный массиву, который хранит объек¬ 
ты СЗЗРиІе, составляющие таблицу стилей. В ІЕ вместо него используется свойство 
гиіез. 

Ьооіеап (ІізаЫесІ 

Значение Тгие означает, что таблица стилей неактивна и не будет применяться 
к документу. Значение іаізе - таблица стилей активна и будет применяться к до¬ 
кументу. 

геасіопіу зіігіпд ЬгеТ 

ШІЬ-адрес таблицы стилей, которая связана с документом, или пиіі, если таблица 
стилей встроена в документ. 

геасіопіу зіігіпд тесііа 

Список устройств вывода, к которым применяется данная таблица стилей. Значе¬ 
ние этого свойства доступно для чтения и записи и может интерпретироваться как 
единая строка или как объект, подобный массиву, содержащий имена типов уст¬ 
ройств вывода и поддерживающий методы аррепсІМесІіит() и с!е1е1:еМесІіит(). (Фор¬ 
мально значением этого свойства является объект МеРіаИзі, но он не рассматрива¬ 
ется в данном справочнике.) 
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геасіопіу Иосіе омпегМойе 

Элемент документа, «владеющий» данной таблицей стилей, или піііі, если таковой 
отсутствует. См. справочные статьи І_іпк и 81:у1е. 

геасіопіу СЗЗЯиІе омпегРиІе 

Объект СЗЗЯиІе правила (из родительской таблицы стилей), которое привело к вклю¬ 
чению данной таблицы стилей, или пи 11, если таблица стилей была подключена ка¬ 
ким-то другим способом. (Обратите внимание, что справочная статья СЗЗЯиІе в этом 
справочнике описывает только правила стилей и не описывает правила Фітрогі:.) 

геасіопіу СЗЗЗіуІеЗИееІ: рагеп*$*у1е$Мее* 

Таблица стилей, которая включает в себя данную таблицу, или пиіі, если данная 
таблица включена непосредственно в документ. 

геасіопіу зігіпд Шіе 

Заголовок таблицы стилей, если указан. Заголовок может определяться атрибу¬ 
том Шіе элемента <з1у1е> или <1іпк>, который ссылается на эту таблицу стилей. 

геасіопіу зігіпд *уре 

МІМЕ-тип данной таблицы стилей. Таблицы стилей С88 имеют тип «іехі/сзз». 

Методы 

ѵоісі Ре1е*еВи1е(ип5ідпес1 Іопд іпсіех) 

Удаляет правило в позиции іпсіех из массива сззЯиІез. В ІЕ версии 8 и ниже следует 
использовать эквивалентный метод гетоѵеЯи1е(). 

ипзідпесі Іопд іпзег1Ви1е(з1:гіпд гиіе , ипзідпесі Іопд іпсіех) 

Вставляет (или добавляет в конец) новое С88-правило (строку, определяющую се¬ 
лектор и стили в фигурных скобках) в позицию іпсіех в массив сззЯиІез данной таб¬ 
лицы стилей. В ІЕ версии 8 и ниже следует использовать эквивалентный метод 
асісіЯи1е() и передавать ему две строки, строку селектора и строку со стилями (без 
фигурных скобок) в первом и втором аргументах, а позицию іпсіех передавать 
в третьем аргументе. 

ОаІаТгапБ^ег 

передача данных в операциях буксировки мышью 

Когда пользователь выполняет операцию буксировки мышью (сіга^-апсі-сігор), в ис¬ 
точнике или в приемнике (или в обоих сразу, если оба они находятся в окне броузера) 
возбуждается целая последовательность событий. Вместе с этими событиями переда¬ 
ется объект события, имеющий свойство сіаІаТгапзІ'ег (см. Еѵепі:), ссылающееся на объ¬ 
ект РаІаТгапзІ'ег. Объект ОаІіаТгапзІ'ег занимает центральное место в любой операции 
буксировки: источник сохраняет в нем передаваемые данные, а приемник извлекает 
из него переданные данные. Кроме того, объект ОаІаТгапзІ'ег обеспечивает возмож¬ 
ность добиться договоренности между источником и приемником о том, должны ли 
буксируемые данные копироваться, перемещаться или в приемнике должна быть ус¬ 
тановлена лишь ссылка на них. 

Описываемый здесь АРІ был разработан в корпорации Місгозоіі для использования 
в ІЕ и реализован, по крайней мере частично, в других броузерах. Спецификация 
НТМЬб стандартизует базовый АРІ, реализованный в ІЕ. Когда эта книга была уже 
передана в печать, в стандарт НТМЬб было добавлено определение новой версии АРІ, 
в которой предусмотрено свойство ііетз, являющееся объектом, подобным массиву, 
хранящему объекты РаІаТгапзІ'егІіет. Это достаточно привлекательный и разумный 
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АРІ, но, поскольку он пока еще не реализован в броузерах, он здесь не рассматривает¬ 
ся. Вместо этого в данной статье описываются возможности, которые можно исполь¬ 
зовать (почти) во всех текущих броузерах. Подробное обсуждение этого замысловато¬ 
го АРІ представлено в разделе 17.7. 

Свойства 

зТгіпд йгорЕГГесІ: 

Это свойство определяет тип передачи данных, представленных этим объектом. 
Свойство должно иметь одно из значений: «попе», «сору», «шоѵе» или «Ипк». Как 
правило, объект-приемник устанавливает это свойство в обработчике события 
«сіга^епіег» или «сіга^оѵег». Значение этого свойства может также зависеть от 
клавиш модификаторов, удерживаемых пользователем в процессе буксировки, но 
это во многом зависит от платформы. 

зігіпд е^есІАПомегі 

Это свойство определяет допустимую комбинацию операций перемещения из чис¬ 
ла: копирование, перемещение и создание ссылки. Это свойство обычно устанав¬ 
ливается источником в ответ на событие «сіга^зіагі». Допустимыми значениями 
являются: «попе» (ни одна), «сору» (копирование), «соруЬіпк» (копирование и соз¬ 
дание ссылки), «соруМоѵе» (копирование и перемещение), «Ипк» (создание ссыл¬ 
ки), «ІіпкМоѵе» (создание ссылки и перемещение), «шоѵе» (перемещение) и «аіі» 
(все). (Обратите внимание, что в мнемониках, определяющих две операции, назва¬ 
ния операций следуют в алфавитном порядке.) 

геасіопіу Рі1е[] ^ііез 

Если перемещаемые данные являются одним или более файлами, это свойство будет 
ссылаться на массив или на объект, подобный массиву, содержащий объекты Рііе. 

геасіопіу зігіпдП Іурез 

Это объект, подобный массиву, содержащий строки, которые определяют МІМЕ- 
типы данных, сохраняемых в объекте ОаіаТгапзіег (устанавливается методом зеі:- 
ОаіаО, если источник располагается в броузере, или каким-либо другим механиз¬ 
мом, если источник находится за пределами броузера). Объект, подобный массиву, 
хранящий типы, должен иметь метод сопіаіпзО для проверки присутствия опре¬ 
деленной строки. Однако некоторые броузеры передают в этом свойстве истинный 
массив, и в этом случае для проверки можно использовать метод іпсІехОіО* 

Методы 

ѵоісі а(1(1Е1етеп1(Е1етеп1: еіетепі) 

Сообщает броузеру элемент еіетепі , который можно использовать для воспроизве¬ 
дения визуального эффекта, который будет наблюдать пользователь во время бук¬ 
сировки. Обычно этот метод вызывается буксируемым источником, но он может 
быть реализован или иметь хоть какой-нибудь эффект не во всех броузерах. 

ѵоісі Сіеаг0а1:а([з1:гіпд іогтаі]) 

Удаляет все данные в формате іогтаі , которые были добавлены методом зеЮаіаО. 
зігіпд де1:0а1:а(з1:гіпд іогтаі) 

Возвращает отбуксированные данные в формате іогтаі. Если в аргументе іогтаі 
передано значение «іехі» (без учета регистра символов), возвращаются данные 
в формате «іехі/ріаіп». А если передано значение «игі» (без учета регистра симво¬ 
лов), возвращаются данные в формате «іехі/игі-іізі». Этот метод вызывается при¬ 
емником в ответ на событие «сігор» в конце операции буксировки. 
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ѵоісі зеЮа^аСзігіпд ТогтаТ, зігіпд сІаТа) 

Принимает данные сІаТа для передачи и МІМЕ-тип этих данных в аргументе ТогтаТ. 
Источник вызывает этот метод в ответ на событие «йга^зіагі» в начале операции 
буксировки. Он не может вызываться из какого-либо другого обработчика собы¬ 
тий. Если источник способен представить данные более чем в одном формате, он 
может вызвать этот метод несколько раз, чтобы определить значения для каждого 
поддерживаемого формата. 

ѵоісі зе*0гадІтаде(Е1етепі ітаде , Іопд х, Іопд у) 

Определяет изображение ітаде (обычно элемент <ітд>), которое должно отобра¬ 
жаться как визуальное представление буксируемых данных. Аргументы х и у оп¬ 
ределяют смещение указателя мыши относительно изображения. Этот метод мо¬ 
жет вызываться только буксируемым источником, в ответ на событие «(Іга^зіагі». 

РаіаѴіеѵѵ 

реализует чтение/запись значений в АггауВиНег АггауВиііегѴіеѵѵ 

ОаІіаѴіеѵ/ — это подтип АггауВиііегѴіем, который служит оберткой для АггауВиііег (или 
фрагмента АггауВиііег) и определяет методы чтения/записи 1-, 2- и 4-байтовых целых 
со знаком и без знака, а также 4- и 8-байтовых вещественных чисел в буфере. Методы 
поддерживают прямой (Ъі^-епсііап) и обратный (ИШе-епсІіап) порядок следования 
байтов. См. также Ту ресІАггау. 

Конструктор 

п еѵі Оа*аѴіем(АггауВиііег ЬиТТег, [ипзідпесі Іопд ЬуТеОТТзеТ], [ипзідпесі Іопд ЬуТеТепдТН]) 

Этот конструктор создает новый объект ОаТаѴіехл/, обеспечивающий доступ на чте¬ 
ние и запись к байтам в буфере или во фрагменте буфера. При вызове с одним ар¬ 
гументом создает представление всего буфера. При вызове с двумя аргументами 
создает представление, простирающееся от байта с номером ЬуТеОТТзеТ до конца 
буфера. И при вызове с тремя аргументами создает представление длиной ЬуТе- 
ТепдТЬ, начинающееся с байта с номером ЬуТеОТТзеТ. 

Методы 

Следующие методы читают или записывают числовые значения в буфер АггауВиііег, 
представленный объектом ОаіаѴіем. Имя метода определяет тип читаемого или запи¬ 
сываемого числового значения. Все методы, выполняющие чтение или запись более 
одного байта, принимают необязательный последний аргумент ІіТТІеЕпсІіап . Если 
этот аргумент отсутствует или имеет значение іаізе, используется прямой (Ьі^-епсііап) 
порядок следования байтов, когда старшие байты читаются или записываются пер¬ 
выми. Однако если этот аргумент имеет значение ігие, используется обратный (ИШе- 
епсііап) порядок следования байтов. 

ііоаі де1Р1оа1:32(ип$ідпес1 Іопд ЬуТеОТТзеІ [Ьооіеап ІіТТІеЕпсІіап]) 

Интерпретирует 4 байта, начиная с позиции ЬуТеОТТзеТ , как вещественное число 
и возвращает его. 

сІоиЫе де!Р1оа1;64(ипзідпес1 Іопд ЬуТеОТТзеТ, [Ьооіеап ІіТТІеЕпсІіап ]) 

Интерпретирует 8 байтов, начиная с позиции ЬуТеОТТзеТ, как вещественное число 
и возвращает его. 

зЬогі де*Іп*16(ипзідпес1 Іопд ЬуТеОТТзеТ , [Ьооіеап ІіТТІеЕпсІіап ]) 

Интерпретирует 2 байта, начиная с позиции ЬуТеОТТзеТ , как целое число со знаком 
и возвращает его. 
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Іопд деТІп1:32(ип5ідпес1 Іопд ЬуТеОТТзеТ, [Ьооіеап ІіТТІеЕпсІіап]) 

Интерпретирует 4 байта, начиная с позиции ЬуТеОТТзеТ, как целое число со знаком 
и возвращает его. 

Ьуіе де1Іпі8(ипзідпес1 Іопд ЬуТеОТТзеТ) 

Интерпретирует байт в позиции ЬуТеОТТзеІ ", как целое число со знаком и возвраща¬ 
ет его. 

ипзідпесі зЬогі; деТІЛпТ16(ипзідпес1 Іопд ЬуТеОТТзеТ, [Ьооіеап ІіТТІеЕпсІіап ]) 

Интерпретирует 2 байта, начиная с позиции ЬуТеОТТзеТ, как целое число без знака 
и возвращает его. 

ипзідпесі Іопд деШ.п1:32(ип5ідпес1 Іопд ЬуТеОТТзеТ, [Ьооіеап ІіТТІеЕпсІіап]) 

Интерпретирует 4 байта, начиная с позиции ЬуТеОТТзеІ ", как целое число без знака 
и возвращает его. 

ипзідпесі ЬуТе деТІЛпТ8(ипзідпес1 Іопд ЬуТеОТТзеТ) 

Интерпретирует байт в позиции ЬуТеОТТзеТ , как целое число без знака и возвраща¬ 
ет его. 

ѵоісі зеТР1оаТ32(ипзідпес! Іопд ЬуТеОТТзеТ, ТІоаТ ѵаіие , [Ьооіеап ІіТТІеЕпсІіап]) 

Преобразует значение ѵаіие в 4-байтовое вещественное представление и записыва¬ 
ет полученные байты в буфер, начиная с позиции ЬуТеОТТзеТ. 

ѵоісі зеТР1оаТ64(ипзідпес1 Іопд ЬуТеОТТзеІ ", ЬоиЫе ѵаіие, [Ьооіеап ІіТТІеЕпсІіап ]) 

Преобразует значение ѵаіие в 8-байтовое вещественное представление и записыва¬ 
ет полученные байты в буфер, начиная с позиции ЬуТеОТТзеТ. 

ѵоісі зеТІпТ16(ипзідпес1 Іопд ЬуТеОТТзеТ, зЬогТ ѵаіие, [Ьооіеап ІіТТІеЕпсІіап]) 

Преобразует значение ѵаіие в 2-байтовое целочисленное представление и записы¬ 
вает полученные байты в буфер, начиная с позиции ЬуТеОТТзеТ. 

ѵоісі зе1Іп132(ипзідпес1 Іопд ЬуТеОТТзеТ, Іопд ѵаіие, [Ьооіеап ІіТТІеЕпсІіап ]) 

Преобразует значение ѵаіие в 4-байтовое целочисленное представление и записы¬ 
вает полученные байты в буфер, начиная с позиции ЬуТеОТТзеТ. 

ѵоісі зе1Іп18(ипзідпес1 Іопд ЬуТеОТТзеТ, Ьуіе ѵаіие) 

Преобразует значение ѵаіие в 1-байтовое целочисленное представление и записы¬ 
вает полученный байт в буфер, в позицию ЬуТеОТТзеТ. 

ѵоісі зеІІЛпІІбСипзідпесІ Іопд ЬуТеОТТзеТ, ипзідпесі зЬогі ѵаіие, [Ьооіеап ІіТТІеЕпсІіап ]) 

Преобразует значение ѵаіие в 2-байтовое целочисленное представление без знака 
и записывает полученные байты в буфер, начиная с позиции ЬуТеОТТзеТ. 

ѵоісі зе11Лп132(ипз1дпес1 Іопд ЬуТеОТТзеТ, ипзідпесі Іопд ѵаіие , [Ьооіеап ІіТТІеЕпсІіап ]) 

Преобразует значение ѵаіие в 4-байтовое целочисленное представление без знака 
и записывает полученные байты в буфер, начиная с позиции ЬуТеОТТзеТ. 

ѵоісі зе11Лп18(ипз1дпес1 Іопд ЬуТеОТТзеТ, оспе! ѵаіие) 

Преобразует значение ѵаіие в 1-байтовое целочисленное представление без знака 
и записывает полученный байт в буфер в позицию ЬуТеОТТзеТ. 

Ооситепі 

НТМІ.- или ХМ (.-документ ІЧосІе 

Объект Ооситепі: - это узел ИоЬе, играющий роль корня дерева документа. Свойство Ьо- 
ситепіЕІетепІ: объекта представляет корневой элемент Еіетепі документа. Узел Ооси¬ 
тепі: может иметь несколько дочерних узлов (таких как узлы Соттепі и ОоситепіТуре), 
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но он имеет только один дочерний узел типа Еіетепі, хранящий все содержимое доку¬ 
мента. 

Проще всего доступ к объекту Ооситепі получить через свойство сіоситепі объекта 
Ѵл/іпсіоѵу/. Доступ к объекту Ооситепі: можно также пол учить через свойство сопіепЮоситепі 
элемента ІРгате или через свойство омпегОоситепі любого узла типа Иосіе. 

Большинство свойств объекта Ооситепі: обеспечивают доступ к элементам документа 
или к другим важным объектам, связанным с документом. Некоторые методы объек¬ 
та Ооситепі: обеспечивают похожие возможности, предоставляя средства поиска эле¬ 
ментов в дереве документа. Многие другие методы являются «фабричными метода¬ 
ми», используемыми для создания элементов и других объектов. 

Объекты Ооситепі:, подобно объектам Еіетепі:, которые они содержат, являются целе¬ 
выми объектами событий. Они реализуют методы, определяемые интерфейсом Еѵепі- 
Тагдеі, а также поддерживают множество свойств обработчиков событий. 

Создать новый объект Ооситепі можно с помощью методов сгеаіеОостепіО и сгеаіеНТМІ_- 
ОоситепіО объекта ООМІтрІетепіаііоп: 

сіоситепі.ітріетепіаііоп.сгеаіеНТМЮоситепіС'Мем Бос” ): 

Кроме того, можно загрузить НТМЬ- или ХМЬ-файл из сети и преобразовать его в объ¬ 
ект Ооситепі. См. описание свойства гезропзеХМІ. объекта ХМІ_НіірВедиезі. 

Справочная статья НТМЮоситепІ, имевшаяся в предыдущем издании этой книги, те¬ 
перь объединена с этой справочной статьей. Обратите внимание, что некоторые свой¬ 
ства, методы и обработчики, описываемые здесь, могут использоваться только при 
работе с НТМЬ-документами и не могут применяться к ХМЬ-документам. 

Свойства 

Помимо свойств, перечисленных ниже, в качестве свойств документа можно также 
использовать значения атрибутов пате элементов <і!гате>, <1огт> и <ітд>. Значениями 
этих свойств являются соответствующие объекты Еіетепі или ИосІеНзІ этих элемен¬ 
тов. Однако для элементов <і!гате> свойство ссылается на объект Іл/іпсісм элемента 
<і!гате>. Подробности приводятся в разделе 15.2.2. 

геасіопіу Еіетепі асІіѵеЕІетепІ 

Элемент документа, владеющий в настоящий момент фокусом ввода. 

Еіетепі Ъобу 

В НТМЬ-документах это свойство ссылается на элемент <ЬосІу>. (Однако в докумен¬ 
тах, определяющих элементы <1гатезе1>, это свойство ссылается на самый внеш¬ 
ний элемент <1гатезе1>.) 

геасіопіу зігіпд сМагас1ег$е1 

Кодировка символов документа, 
зігіпд сМагзе! 

Кодировка символов документа. Это свойство подобно свойству сПагасіегЗеі, но его 
значение можно изменить, чтобы сменить кодировку документа. 

геасіопіу зігіпд сотраіМойе 

Это свойство содержит строку «ВаскСотраі», если документ отображается в «ре¬ 
жиме совместимости» для обратной совместимости с очень старыми броузерами. 
Иначе это свойство содержит строку «С881Сотра1;». 

зігіпд соокіе 

Это свойство позволяет читать, создавать, изменять и удалять соокіез, которые 
применяются к данному документу. Соокіез - это небольшие блоки именованных 
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данных, хранимых веб-броузером. Они позволяют броузеру «запомнить» некото¬ 
рые данные, которые могут быть введены в одной странице, а использоваться 
в другой, или повторно использовать предпочтения пользователя между вызовами 
страниц в рамках сеанса. Данные в соокіез автоматически передаются между веб¬ 
броузером и веб-сервером, благодаря чему серверные сценарии могут читать и из¬ 
менять значения в соокіез. Клиентские сценарии на языке ^ѵа8сгірі также могут 
читать и изменять значения в соокіез, используя это свойство. Обратите внимание, 
что это свойство доступно для чтения/записи, но в целом прочитанное из него зна¬ 
чение доступно только для чтения, как и записанное в него значение. Подробности 
приводятся в разделе 20.2. 

геасіопіу зітіпд йе^аиИСЬагзе! 

Кодировка символов в броузере по умолчанию, 
геасіопіу Іл/іпсіом йе^аиІІѴіеѵѵ 

Объект Шпбсм броузера, в котором отображается данный документ, 
зітіпд (ІезідпМогіе 

Если это свойство имеет значение «оп», документ целиком доступен для редактиро¬ 
вания. Если это свойство имеет значение «о іі», документ целиком недоступен для 
редактирования. (Но при этом доступными для редактирования могут быть от¬ 
дельные элементы с установленным свойством сопіепіесІііаЫе.) Подробности при¬ 
водятся в разделе 15.10.4. 

зітіпд біг 

В НТМЬ-документах это свойство соответствует атрибуту сііг элемента <М:т1>. То 
есть это то же самое значение, что и сІоситепіЕІетепі.сІіг. 

геасіопіу ОоситепіТуре йосіуре 

Узел ОоситепіТуре, представляющий объявление <Ю0СТУРЕ> документа, 
геасіопіу Еіетепі (ІоситепІЕІетепІ 

Корневой элемент документа. В НТМЬ-документах это свойство всегда является 
объектом Еіетепі, представляющим тег <Ы:т1>. Этот корневой элемент также досту¬ 
пен через массив сППсШойезП, унаследованный от Иосіе, но он необязательно будет 
первым элементом этого массива. См. также описание свойства Ьосіу. 

зітіпд (Іотаіп 

Доменное имя сервера, откуда был загружен документ, или піііі, если он отсутст¬ 
вует. В отдельных случаях это свойство может использоваться для ослабления по¬ 
литики общего происхождения и получения доступа к документам из родствен¬ 
ных доменов. Подробности приводятся в разделе 13.6.2.1. 

геасіопіу НТМЮоІІесііоп етЬегіз 

Объект, подобный массиву, содержащий элементы <етЬес1>, присутствующие в до¬ 
кументе. 

геасіопіу НТМЮоПесИоп ^огглз 

Объект, подобный массиву, содержащий все элементы Еогт, присутствующие в до¬ 
кументе. 

геасіопіу Еіетепі Меагі 

В НТМЬ-документах это свойство ссылается на элемент <Иеас1>. 
геасіопіу НТМІ_Со11ес1:іоп ітадез 

Объект, подобный массиву, содержащий все элементы Ітаде, присутствующие в до¬ 
кументе. 
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геасіопіу ООМІтрІетепІіаііоп ітріетепіаііоп 

Объект ООМІтрІетепіаііоп для данного документа, 
геасіопіу зітіпд ІазгМойі^іей 

Содержит дату и время последнего изменения документа. Это значение поставля¬ 
ется в НТТР-заголовке «Ьазі-МосШіесІ», который может передаваться веб-серве¬ 
ром по требованию. 

геасіопіу НТМІ_Со11ес1:іоп Ііпкз 

Объект, подобный массиву, содержащий все гиперссылки, присутствующие в до¬ 
кументе. Этот объект НТМЮоІІесІііоп содержит все элементы <а> и <агеа>, имеющие 
атрибут Пгеі, но не включает элементы <1іпк>. См. также І_іпк. 

геасіопіу І_оса1:іоп Іоса^іоп 

Синоним свойства Іл/іпсісж. Іосаііоп. 
геасіопіу НТМЮоІІесііоп ріидіпз 
Синоним свойства етЬесІз. 
геасіопіу зітіпд геа<1у31:а1:е 

Это свойство содержит строку «ІоасНп^», пока продолжается загрузка документа, 
и строку «сотріеіе» по ее окончании. Когда это свойство получает значение «сотр- 
Іеіе», броузер возбуждает событие «геасІузіаіесЬап^е» в объекте Ооситепі:. 

геасіопіу зітіпд ге^еггег 

ИКЬ-адрес документа, ссылающегося на данный документ, или пи 11, если доку¬ 
мент был открыт не через гиперссылку, или если веб-сервер не сообщил адрес до¬ 
кумента, содержащего ссылку на данный документ. Это свойство позволяет полу¬ 
чить доступ к НТТР-заголовку геіегег. Обратите внимание на правописание: имя 
заголовка включает три символа «г», а имя ^ѵа8сгірі-свойства - четыре. 

геасіопіу НТМЮоІІесііоп зсгір^з 

Объект, подобный массиву, содержащий все элементы <зсгір1:>, присутствующие 
в документе. 

геасіопіу СЗЗЗіуІеЗИееіС] з1у1еЗІіее*з 

Коллекция объектов, представляющих все таблицы стилей, встроенные в доку¬ 
мент, или на которые есть ссылки из него. В НТМЬ-документах они включают таб¬ 
лицы стилей, определенные с помощью тегов <1іпк> и <з1:у1е>. 

зітіпд Ііііе 

Текстовое содержимое тега <1:Ше> данного документа. 

геасіопіу зітіпд ІІВЬ 

ШПі-адрес документа. Это значение часто совпадает со значением свойства Іосаіі- 
оп. Иге^. Однако если сценарий изменит идентификатор фрагмента документа (свой¬ 
ство Іосаііоп.ИазП), свойства Іосаііоп и ІШІ_ будут ссылаться на разные ІШЬ-адреса. 
Не путайте свойство Ооситепі:. 11ВІ со свойством Іл/іпс1о\л/.иПІ_. 

Методы 

Мосіе а0орТМо0е(Ыос1е поде) 

Удаляет узел поде из любого документа, частью которого он являлся на момент вы¬ 
зова, и записывает в свойство омпегОоситепІ: узла ссылку на текущий документ, 
подготавливая его к добавлению в текущий документ. Похожий на него метод 
ітрогіМосІеО копирует узел из другого документа, не удаляя его. 
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ѵоісі с1озе() 

Закрывает поток вывода документа, открытый методом ореп(), заставляя вывести 
все буферизовангіые данные. 

Соттепі сгеа1еСоттеп1:(5Ігіпд баХа) 

Создает и возвращает новый узел Соттепі с указанным содержимым. 
РоситепІРгадтепІ сгеаТеОоситепТРгадтепТО 

Создает и возвращает новый пустой узел РоситепІРгадтепІ. 

Еіетепі сгеа1еЕ1етеп1(з1гіпд ІосаШате) 

Создает и возвращает новый пустой узел Еіетепі: с указанным именем тега. В НТМЬ- 
документах символы в имени тега преобразуются в верхний регистр. 

Еіетепі сгеаІеЕІетепІМЗСзІгіпд патезрасе , зігіпд диаІіХіебМате) 

Создает и возвращает новый пустой узел Еіетепі. Первый аргумент определяет 
идентификатор ШИ пространства имен элемента, а второй - префикс пространст¬ 
ва имен, двоеточие и имя тега элемента. 

Еѵепі сгеа1еЕѵеп1(з1гіпд еѵепХІпХегХасе ) 

Создает и возвращает неинициализированный объект Еѵепі искусственного собы¬ 
тия. Аргумент определяет тип события и должен быть строкой, такой как «Еѵепі», 
«ШЕѵепі», «МоизеЕѵепі», «Мезза^еЕѵепі» и так далее. После создания объекта 
Еѵепі можно инициализировать его свойства, доступные только для чтения, вызо¬ 
вом соответствующих методов инициализации, таких как і п іі Е ѵе п 1 (), і п іі ІЯ Е ѵе п 1: (), 
іпіІМоизеЕѵепіО и так далее. Большая часть методов инициализации не рассмат¬ 
риваются в этой книге, но описание простейшего из них приводится в справочной 
статье Еѵепі . іпіі: Еѵеп1:( ). После создания и инициализации объекта искусственного 
события его можно отправить вызовом метода сІізраІсПЕѵепіО интерфейса Еѵепі- 
Тагдеі. Искусственные события всегда имеют значение іаізе в свойстве ізТгизІесІ. 

Ргосеззіпдіпзігисііоп сгеаіеРгосеззіпдІпзігисііогКзІгіпд ХагдеХ, зігіпд баХа) 

Создает и возвращает новый узел Ргосеззіпдіпзігисііоп со строками ХагдеХ и баХа. 
Тех! сгеаіеТех!Мо(1е(5Ігіпд баХа) 

Создает и возвращает новый узел Техі, представляющий текст ХехХ. 

Еіетепі еІегпепіРготРоіпіСіІоаІ х, ііоаі у) 

Возвращает самый глубоко вложенный элемент Еіетепі с оконными координатами 

(*, у)- 

Ьооіеап ехесСоттап(1(з1гіпд соттапбіб, [Ьооіеап зХіомІЛ, [зігіпд ѵаіие]]) 

Выполняет команду редактирования с именем в аргументе соттапбіб в любом дос¬ 
тупном для редактирования элементе, в котором находится текстовый курсор. 
Спецификация НТМЬб определяет следующие команды: 


Ьоісі 

сгеа1еІ_іпк 

сіеіеіе 

ІогтаІВІоск 

ІопѵагсЮеІеІе 

іпзегіітаде 

іпзегІНТМІ 


іпзегНіпеВгеак 

Іпзег10гс1егес11_і5і 

іпзеПЬпогсіегесІІ-ізІ 

іпзеПРагадгарЬ 

іпзегІТех! 

ііаііс 

гесіо 


зеІесІАП 

зиЬзсгір! 

зирегзсгірі 

ипсіо 

ііпііпк 

ипзеіесі 


Некоторые из этих команд (такие как сгеа!еІ_іпк) требуют аргумент ѵаіие . Если вто¬ 
рой аргумент метода ехесСоттапсК) имеет значение Іаізе, то значение аргумента ко¬ 
манды определяется третьим аргументом метода. Иначе броузер предложит поль- 
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зователю ввести необходимое значение. Подробнее о методе ехесСоттапсІО расска¬ 
зывается в разделе 15.10.4. 

Еіетепі деіЕ1етепіВуІ(1(5ігіпд еІетепТІР) 

Отыскивает в документе узел Еіетепі с атрибутом ісі, значение которого совпадает 
со значением аргумента еІетепТІР , и возвращает этот элемент. Если такой элемент 
не найден, он возвращает пиіі. Значение атрибута ісі предполагается уникальным 
в пределах документа, а если этот метод найдет более одного элемента с указан¬ 
ным значением еіетепі:Ісі, то он вернет первый из них. Этот метод важен и часто 
используется, т.к. обеспечивает простой способ получения объекта Еіетепі, пред¬ 
ставляющего определенный элемент в документе. Обратите внимание: имя этого 
метода оканчивается суффиксом «И», а не «ГО». 

МосІеИзі деіЕ1етепізВуС1аззМате(зігіпд сІазз/Ѵа/иез) 

Возвращает объект, подобный массиву, содержащий элементы, в атрибуте сіазз 
которых присутствуют все имена классов, указанные в с1а88Nате8. Аргумент сіазз- 
Матез может содержать единственное имя класса или список имен классов, разде¬ 
ленных пробелами. Возвращаемый объект МосІеИзі - «живой» объект, который 
автоматически обновляется при изменении документа. Элементы в возвращаемом 
объекте МосІеИзі располагаются в том же порядке, в каком они присутствуют в до¬ 
кументе. Обратите внимание, что этот метод также определен в объекте Еіетепі. 

МосІеИзі деіЕ1етепізВуМате(зігіпд еІетепТМате) 

Возвращает «живой», доступный только для чтения объект, подобный массиву, со¬ 
держащий элементы со значением е1етепТNате в атрибуте пате. Если искомые эле¬ 
менты отсутствуют, возвращается объект МосІеИзі со значением 0 в свойстве ІепдіИ. 

МосІеИзі деіЕ1етепізВуТадМате(зігіпд рсіаШіеРІУате) 

Возвращает доступный только для чтения объект, подобный массиву, содержа¬ 
щий все узлы Еіетепі из документа, имеющие указанное имя тега, в том порядке, 
в котором они располагаются в исходном тексте документа. Объект МосІеИзі - «жи¬ 
вой», т.е. его содержимое по необходимости автоматически обновляется, если эле¬ 
менты с указанным именем тега добавляются или удаляются из документа. Срав¬ 
нение с именами тегов НТМЬ-элементов выполняется без учета регистра симво¬ 
лов. Как особый случай, имени тега «*» соответствуют все элементы документа. 

Обратите внимание: интерфейс Еіетепі определяет метод с тем же именем, кото¬ 
рый выполняет поиск по поддереву документа. 

МосІеИзі деіЕ1етепізВуТадМатеМЗ(зігіпд патезрасе, зігіпд ІосаМате) 

Этот метод работает точно так же, как деіЕ1етепізВуТадМате(), но при его использо¬ 
вании имя тега указывается как комбинация идентификатора ШН пространства 
имен и локального имени тега в этом пространстве имен. 

Ьооіеап МазРосизО 

Возвращает ігие, если окно с данным документом владеет фокусом ввода (или, ес¬ 
ли это окно не является окном верхнего уровня, все его родители владеют фокусом 
ввода). 

Мосіе ітрогіМо(1е(Мос1е поре , Ьооіеап Реер) 

Получает узел, определенный в другом документе, и возвращает копию узла, под¬ 
ходящую для вставки в данный документ. Если аргумент Реер имеет значение ігие, 
копируются также все потомки узла. Исходный узел и его потомки никак не моди¬ 
фицируются. В полученной копии свойство омпегОоситепі устанавливается рав¬ 
ным данному документу, а рагепіМосІе - пиіі, поскольку копия пока не вставлена 
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в документ. Обработчики событий, зарегистрированные в исходном узле или дере¬ 
ве, не копируются. См. также асІорІМосІеО. 

Ѵл/іпсіоѵу/ ореп(з1:гіпд игі , зігіпд пате, зігіпд ТеаТигез, [Ьооіеап геріасе ]) 

Когда метод ореп() документа вызывается с тремя и более аргументами, он дейст¬ 
вует подобно методу ореп() объекта Іл/іпсісм. См. также Міпсісм. 

Ооситепі ореп([з1гіпд Туре], [зіігіпд геріасе ]) 

При вызове с двумя и менее аргументами этот метод стирает текущий документ 
и начинает новый (используя существующий объект Ооситепі:, который является 
возвращаемым значением). После вызова ореп() можно использовать методы ѵѵгіі:е( ) 
и \л/гііе1п(), чтобы вывести содержимое в поток документа, и метод с1озе(), чтобы 
завершить создание документа и заставить броузер отобразить его. Подробности 
приводятся в разделе 15.10.2. 

Новый документ будет являться НТМЬ-документом, если аргумент Туре отсутству¬ 
ет или имеет значение «Іехі/Ьіті». Иначе будет создан простой текстовый доку¬ 
мент. Если аргумент геріасе имеет значение Ігие, новый документ заменит преж¬ 
ний в истории посещений броузера. 

Этот метод не должен вызываться сценарием или обработчиком событий, являю¬ 
щимся частью переписываемого документа, т.к. сам сценарий или обработчик 
также будет переписан. 

Ьооіеап диегуСоттагк1ЕпаЫе(1(5Ігіпд соттапсіісі) 

Возвращает 1: г и е, если в настоящий момент можно передать команду соттапсіісі мето¬ 
ду ехесСоттапсК), и Іаізе - в противном случае. Например, бессмысленно передавать 
команду «ипсіо», когда нечего отменять. Подробности приводятся в разделе 15.10.4. 

Ьооіеап диегуСоттап(1Іп(1еіеггп(5Ігіпд соттапсИд) 

Возвращает Ігие, если соттапсіісі находится в состоянии, для которого диегуСоттапсІ- 
Зіа1е() не может вернуть какое-то определенное значение. Команды, определяемые 
спецификацией НТМЬ5, не могут находиться в неопределенном состоянии, но ко¬ 
манды, определяемые броузером, - могут. Подробности приводятся в разделе 15.10.4. 

Ьооіеап диегуСоттагк18іаіе(5Ігіпд соттапсіісі) 

Возвращает состояние команды соттапсіісі . Некоторые команды редактирования, 
такие как «ЪоЫ» и «ііаііс», имеют состояние Ігие, если под текстовым курсором 
или в выделенной области находится текст, набранный курсивом, и Іаізе - в про¬ 
тивном случае. Однако большинство команд не имеют состояния, и для них этот 
метод всегда возвращает Іаізе. Подробности приводятся в разделе 15.10.4. 

Ьооіеап диегуСоттап(18иррогіе(1(5Ігіпд соттапсіісі) 

Возвращает Ітие, если броузер поддерживает указанную команду, и Іаізе - в про¬ 
тивном случае. Подробности приводятся в разделе 15.10.4. 

зііг іпд диегуСоттап(1Ѵа1ие(з1:гіпд соттапсіісі) 

Возвращает состояние указанной команды в виде строки. Подробности приводят¬ 
ся в разделе 15.10.4. 

Еіетепі диегу8е1есіог(з1гіпд зеІесТогз) 

Возвращает первый элемент в данном документе, соответствующий С88-селекто- 
рам зеІесТогз (это может быть единственный С88-селектор или группа селекторов, 
разделенных запятыми). 

№)СІеІ_і5І: диегу8е1есіогА11(з1:гіпд зеІесТогз) 

Возвращает объект, подобный массиву, содержащий все элементы Еіетепі в дан¬ 
ном документе, соответствующие селекторам зеІесТогз (это может быть единствен- 
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ный С88-селектор или группа селекторов, разделенных запятыми). В отличие от 
объектов МосІеІ_ізі, возвращаемых методом деіЕ1етепізВуТадМате() и аналогичными 
ему, объект МосІеІ_ізі, возвращаемый этим методом, является статическим и содер¬ 
жит элементы, соответствующие селекторам, существовавшие на момент вызогік 
метода. 

ѵоісі ѵ*гііе(зігіпд іехі...) 

Добавляет текст ТехТ в конец документа. Этот метод можно использовать в ходе за¬ 
грузки документа для вставки текста в позицию тега <зсгірі> или после вызова 
метода ореп(). Подробности приводятся в разделе 15.10.2. 

ѵоісі ѵ*гііе1п(зігіпд іехі...) 

Этот метод похож на НТМЮоситепі .ѵ»/гііе( ) за исключением того, что за добавляемым 
текстом следует символ перевода строки, что может быть удобным, например, при 
формировании содержимого тега <рге>. 

События 

Непосредственно в объекте Ооситепі броузеры возбуждают немного событий, но собы¬ 
тия, генерируемые в элементах, будут всплывать до объекта Ооситепі:, вмещающего 
их. По этой причине объект Ооситепі: поддерживает все свойства обработчиков собы¬ 
тий, перечисленные в справочной статье Еіетепі. Подобно элементам Еіетепі, объект 
Ооситепі реализует методы интерфейса ЕѵепіТагдеі. 

Непосредственно в объекте Ооситепі броузеры возбуждают два события. Когда изменя¬ 
ется значение свойства геасІуЗіаіе, броузеры возбуждают событие « геасіузіаіесЬап^е *. 
Зарегистрировать обработчик этого события можно с помощью свойства оп геасІузіаіе - 
сРапде. Кроме того, броузеры возбуждают событие «ООМСопіепіЬоасІесЬ (раздел 17.4), 
когда дерево документа будет готово к манипуляциям (но до окончания загрузки 
внешних ресурсов). Однако для регистрации обработчиков этого события необходимо 
использовать метод интерфейса ЕѵепіТагдеі, потому что в объекте Ооситепі отсутствует 
свойство с именем опООМСопіепіІ_оас!ес!. 

ОоситепіРгадтепі 

смежные узлы и их поддеревья Иосіе 

Интерфейс ОоситепіРгадтепі представляет часть (фрагмент) документа. Если говорить 
конкретно, то он представляет список смежных узлов документа и всех их потомков, 
но без общего родительского узла. Узлы ОоситепіРгадтепі никогда не являются частью 
дерева документа, а унаследованное свойство рагепіМосІе в них всегда равно пиіі. Одна¬ 
ко особенность узлов ОоситепіРгадтепі делает их очень полезными: когда поступает за¬ 
прос на вставку ОоситепіРгадтепі в дерево документа, вставляется не сам узел Ооситепі¬ 
Ргадтепі, а все его дочерние узлы. Поэтому интерфейс ОоситепіРгадтепі хорош в качест¬ 
ве временного хранилища для узлов, которые требуется вставить в документ все сразу. 

Создать новый пустой узел ОоситепіРгадтепі можно с помощью метода Ооситепі.сгеаіе- 
ОоситепіРгадтепі(). 

Поиск элементов в узле ОоситепіРгадтепі можно выполнить с помощью методов диегу- 
Зе1есіог() и диегуЗе1есіогА11(), которые действуют так же, как одноименные методы 
объекта Ооситепі. 

Методы 

Еіетепі диегуЗе1есіог(зігіпд зеіесіогз) 

См. Ооситепі.диегуЗе!есіог(). 
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Мос1еІ_із1: диегу8е1есТогА11(з1:гіпд зеіесіогз) 

См. 0оситеп1:.диегу8е1ес1:огА11(). 

ОоситепІТуре 

объявление <!ООСТѴРЕ> документа Ыосіе 

Этот редко используемый интерфейс представляет объявление <Ю0СТУРЕ> документа. 
Свойство сіосіуре объекта Оосішепі: хранит узел ОоситептТуре этого документа. Узлы 
ОоситепіТуре являются неизменяемыми, и нет никакого способа изменить их. 

Узлы ОосішепТТуре используются для создания новых объектов Ооситепі: с помощью ме¬ 
тода ООМІтрІетепіаііоп.сгеаіеОоситепіО. Новый объект ОоситепТТуре можно создать с по¬ 
мощью ООМІтрІетепіаііоп.сгеаІіеОоситепіТуреО. 

Свойства 

геасіопіу зігіпд паше 

Имя типа документа. Это идентификатор, который следует непосредственно за 
объявлением <! РОСТУ РЕ > в начале документа и совпадает с именем тега корневого 
элемента документа. В НТМЬ-документах это свойство содержит значение «ЬішЬ. 

геасіопіу зігіпд риЬИсІй 

Внешний идентификатор ЭТИ или пустая строка, если идентификатор не указан, 
геасіопіу зігіпд зуз*етІ<1 

Системный идентификатор БТБ или пустая строка, если идентификатор не указан. 

РОМЕхсерйоп 

исключение, возбужденное ѴѴеЬ АРІ 

Большинство прикладных интерфейсов в клиентском ЛѵаЗсгірі возбуждают исклю¬ 
чение ООМЕхсерііоп, когда им требуется сообщить об ошибке. Более подробная инфор¬ 
мация об ошибке содержится в свойствах сосіе и пате объекта. Обратите внимание, что 
исключение РОМЕхсерІіоп может быть возбуждено при чтении или изменении свойства 
или при вызове метода объекта. 

РОМЕхсерІіоп не является подклассом типа Еггог базового ЛѵаЗсгірі, но функциональ¬ 
но похож на него, и некоторые броузеры добавляют в него свойство теззаде для совмес¬ 
тимости с классом Еггог. 

Константы 

ипзідпесі зйогі ІВ0ЕХ__8І2Е_ЕВВ = 1 
ипзідпес! зПогі НІЕВАВСНѴ_ВЕ0иЕ8Т_ЕВВ = 3 
ипзідпесі зПогі МВ(Ш_ООСиМЕМТ_ЕВВ = 4 
ипзідпесі зПогі ІМѴАІ_Ю_СНАВАСТЕВ_ЕВВ = 5 
ипзідпесі зПогі М0_М00ІРІСАТІ0М_АИ0Ѵі/Е0_ЕНН = 7 
ипзідпесі зИогі М0Т_Р0иМ0_ЕВВ = 8 
ипзідпесі зйогі М0Т_ЗиРР0ВТЕ0_ЕВВ = 9 
ипзідпесі зПогі ІМѴАІ_Ю_8ТАТЕ_ЕВВ = 11 
ипзідпесі зИогі 8ѴМТАХ_ЕВВ = 12 
ипзідпесі зПогі ІМѴАИ0_М00ІРІСАТІ0М_ЕВВ = 13 
ипзідпесі зйогі МАМЕ8РАСЕ_ЕВВ = 14 
ипзідпесі зПогі ІМѴАІ_Ю_АССЕ38_ЕВВ = 15 
ипзідпесі зМогі ТѴРЕ_МІ8МАТСН_ЕВВ = 17 
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ипзідпесі зИогІ: 8ЕСІШТѴ_ЕВВ = 18 
ипзідпес) зИогІ: ВЕТМОВК_ЕВВ = 19 
ипзідпесі зйогі АВ0ВТ_ЕВВ = 20 
ипзідпесі зЬогі иві._МІ8МАТСН_ЕВВ = 21 
ипзідпесі зйогі 01ЮТА_ЕХСЕЕ0Е0_ЕВВ = 22 
ипзідпесі зйогі ТІМЕ01Л_ЕВВ = 23 
ипзідпесі зИогІ: ОАТА_СЮВЕ_ЕВВ = 25 

Эти константы определяют допустимые значения для свойства сосіе. Имена кон¬ 
стант достаточно полно объясняют причины, повлекшие исключение 

Свойства 

ипзідпесі зИогІ; сойе 

Значение одной из констант, перечисленных выше, определяющих тип исключения, 
зігіпд паше 

Имя типа исключения. Это будет имя одной из констант, перечисленных выше, 
в виде строки. 

ООМІтрІетепіаііоп 

глобальные методы ООМ 

Объект ООМІтрІетепіаііоп определяет методы, не относящиеся к какому-либо конкрет¬ 
ному объекту Ооситепі, а являющиеся «глобальными» для реализации БОМ. Ссылку 
на объект ООМІтрІетепіаііоп можно получить через свойство ітріетепіаііоп любого объ¬ 
екта Ооситепі. 

Методы 

Ооситепі сгеаіеОоситепі(зігіпд патезрасе , зігіпд диаІі/ѵіесМ/а/ие, ОоситепіТуре РосТуре) 

Создает и возвращает новый объект Ооситепі ХМЬ-документа. Если указан аргу¬ 
мент риаІіТіеРЫате , создается корневой элемент с этим именем и добавляется в до¬ 
кумент как значение его свойства йоситепіЕІетепі. Если диаІі/ѵіесМ/ате включает 
префикс пространства имен и двоеточие, пространство имен должно быть пред¬ 
ставлено идентификатором ІІНІ, уникально идентифицирующим его. Если аргу¬ 
мент Росіуре содержит значение, отличное от пиіі, свойству омпегОоситепі этого 
объекта ОоситепіТуре присваивается вновь созданный документ, а узел ОоситепіТуре 
добавляется в новый документ. 

ОоситепіТуре сгеаіеОоситепіТуре(зігіпд риаІіТіеРИате, рііЫісІР , зузііетір) 

Создает новый узел ОоситепіТуре, представляющий объявление <! 00СТУРЕ>, который 
можно передать методу сгеаіеОоситепі(). 

Ооситепі сгеаіеНТМЮоситепіСзігіпд іШе) 

Создает новый объект НТМЮоситепі с готовым деревом документа, включающий 
указанный заголовок. Значением свойства йоситепіЕІетепі возвращаемого объекта 
является элемент <Міт1>, и этот корневой элемент содержит вложенные теги <Меас1> 
и <Ьойу>. Элемент <1іеас1> в свою очередь включает вложенный элемент <ііі1е> с до¬ 
черним текстовым узлом, содержащим строку ТШе. 

ООМ5еНаЫеТокепІ_і$і 

список лексем с настраиваемым строковым значением ООМТокепИзІ 

Объект ООМЗеііаЫеТокеШізі является подтипом 00МТокепІ_ізі, имеющим дополнитель¬ 
ное свойство ѵаіие, которому можно присвоить сразу полный список лексем. 
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Свойство сІаззИзІ объекта Еіетепі: является ссылкой на объект ООМТокепИзТ, который 
представляет множество лексем в свойстве сІаззМате в виде строки. Если потребуется 
присвоить свойству сІаззИзТ сразу все лексемы, можно просто присвоить новую стро¬ 
ку свойству с1азз№те. Свойство запсІЬох элемента ІРгате несколько отличается. Это 
свойство и НТМЬ-атрибут, на который оно опирается, было определено в специфика¬ 
ции НТМЬб, и потому не было никакой необходимости использовать смесь из старого 
строкового представления и объекта 00МТокепІ_і5І:. Это свойство просто определено как 
объект 00МЗе1:1:аЫеТокепІ_із1:, что позволяет читать его и присваивать ему значение, как 
если бы это была простая строка, или использовать методы и интерпретировать его 
как множество лексем. Свойство ІгітІРог объекта Ои^риі и свойство аийіо объекта Ѵісіео 
также являются объектами 00МЗе1:1:аЫеТокепІ_із1:. 

Свойства 

зТгіпд ѵаіие 

Представление множества лексем в виде строки, в которой лексемы разделены 
пробелами. Это свойство позволяет обрабатывать множество как единственную 
строку. Однако обычно не возникает необходимости использовать это свойство яв¬ 
но: при использовании объекта 00МЗе1:1:аЫеТокепІ_із1: в контексте, где требуется стро¬ 
ка, возвращается именно это строковое значение. Л если выполнить присваивание 
строки объекту 00МЗе1:1:аЫеТокепІ_і5І:, строка неявно будет записана в это свойство. 

ООМТокепЫзІ 

множество лексем, разделенных пробелами 

Объект ООМТокепИзІ: представляет результат разбора строки со списком лексем, разде¬ 
ленных пробелами как, например, свойство с1азз№те объекта Еіетепі. Объект ООМТо- 
кепИзІ, как следует из его имени, является списком, точнее объектом, подобным мас¬ 
сиву, со свойством ІепдіП, который можно индексировать для получения доступа к от¬ 
дельным лексемам. Но более важно, что он определяет методы соп1:аіпз( ), ас!с1(), гетоѵе( ) 
и 1одд1е(), позволяющие работать с ним как со множеством лексем. Если использо¬ 
вать объект ООМТокепИз! в строковом контексте, он будет интерпретироваться как 
строка со списком лексем, разделенных пробелами. 

Свойство сІаззИзІ объектов Еіетепі:, определяемое спецификацией НТМЬб, является 
объектом ООМТокепИз! в броузерах, поддерживающих это свойство. И это единствен¬ 
ный объект ООМТокепИзІ, который вам наверняка придется часто использовать на 
практике. См. также 00МЗеПаЬ1еТокепІ_із1:. 

Свойства 

геасіопіу ипзідпесі Іопд ІепдІИ 

ООМТокепИз! - это объект, подобный массиву; данное свойство определяет количе¬ 
ство уникальных лексем, содержащихся в нем. 

Методы 

ѵоісі а<1<1(з1:гіпд Токеп ) 

Если ООМТокепИзІ: еще не содержит лексему Токеп , она будет добавлена в конец спи¬ 
ска. 

Ьооіеап соп1аіпз(з1:гіпд Токеп) 

Возвращает Ігие, если объект ООМТокепИз! содержит лексему Токеп , или Іаізе- 
в противном случае. 
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зігіпд ігет(ипзідпес1 Іопд іпсіех) 

Возвращает лексему по указанному индексу или піЛІ, если индекс іпсіех выходит 
за границы массива. Объект ООМТокеШізі: можно также индексировать непосредст¬ 
венно, не прибегая к этому методу. 

ѵоісі гешоѵе(з1:гіпд Токеп) 

Если ООМТокеШізі: содержит лексему іокеп , этот метод удалит ее. Иначе он ничего 
делать не будет. 

Ьооіеап 1одд1е(5Шпд Токеп) 

Если ООМТокеШізі: содержит лексему Токеп , этот метод удалит ее. Иначе - добавит. 

ЕІетепІ 

элемент документа Иогіе, ЕѵепіГагдеі 

Объект Еіетепі представляет элементы НТМЬ- или ХМЬ-документа. Свойство іадМате 
определяет имя тега или тип элемента. Стандартные НТМЬ-атрибуты элемента доступ¬ 
ны в виде ЛѵаЗсгірі-свойств объекта Еіетепі. Доступ к атрибутам, включая ХМЬ-атри- 
буты и нестандартные НТМЬ-атрибуты, можно также получить с помощью методов 
деіАіігіЬиіеО и зеіАШгіЬіііеО. Содержимое элемента Еіетепі доступно через свойства, 
унаследованные от объекта Мойе. Если требуется выполнить операции с элементами, 
связанными отношениями с данным элементом, можно воспользоваться свойствами 
сйіісігеп, ШгзіЕІетепіСШІсІ, пехіЕІетепіЗіЫіпд и другими похожими свойствами. 

Существует несколько способов получения объектов Еіетепі из документов. Свойство 
сІоситепіЕІетепі: объекта Ооситепі: содержит ссылку на корневой элемент этого докумен¬ 
та, такой как элемент <Иіт1> НТМЬ-документа. В НТМЬ-документах имеются похо¬ 
жие на него свойства ИеасІ и Ьосіу - они ссылаются на элементы <ШасІ> и <Ьос!у> докумен¬ 
та. Чтобы отыскать элемент документа по уникальному значению атрибута ісі, можно 
воспользоваться методом 0оситепі.деіЕ1етепіВуІс!(). Как описывается в разделе 15.2, 
объекты Еіетепі можно также получить с помощью методов деіЕІетепізВуТадМатеО, 
деіЕІетепізВуСІаззМатеО идиегуЗеІесіогАІІО. Наконец, с помощью метода Ооситепі:. с ге- 
аіеЕІетепіО можно создавать новые объекты Еіетепі для вставки в документ. 

Веб-броузеры возбуждают в элементах документа множество различных видов собы¬ 
тий, и объекты Еіетепі определяют множество свойств обработчиков событий. Кроме 
того, объекты Еіетепі определяют методы интерфейса ЕѵепіТагдеІ: (подробнее о нем 
в справочной статье ЕѵепіТагдеІ:), позволяющие добавлять и удалять обработчики со¬ 
бытий. 

Справочная статья НТМ1_Е1етеп1:, имевшаяся в предыдущем издании этой книги, те¬ 
перь объединена с этой справоч ной статьей. Обратите внимание, что некоторые свой¬ 
ства, методы и обработчики, описываемые здесь, могут использоваться только при 
работе с НТМЬ-документами и не могут применяться к ХМЬ-документам. 

Свойства 

Помимо свойств, перечисленных ниже, НТМЬ-атрибуты НТМЬ-элементов доступны 
в виде свойств объектов Еіетепі. НТМЬ-теги и их стандартные атрибуты перечислены 
в конце этой справочной статьи. 

геасіопіу АЫ:г[] аІІгіЬиІез 

Объект, подобный массиву, содержащий объекты АШг, представляющие НТМЬ- 
или ХМЬ-атрибуты данного элемента. Однако в общем случае объекты Еіетепі 
обеспечивают доступ к атрибутам, как к ^ѵа8сгірі- свойствам, поэтому почти ни¬ 
когда не возникает необходимости использовать массив аіігіЬиіезП. 
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геасіопіу ипзідпес! Іопд сИіІйЕІешепТСоипТ 

Количество дочерних элементов (не дочерних узлов), которые имеет данный эле¬ 
мент. 

геасіопіу НТМЮоІІесІііоп сНПсІгеп 

Объект, подобный массиву, содержащий дочерние элементы (исключая дочерние 
узлы, не являющиеся элементами Еіетепіі, такие как Тех! и Соттепіі). 

геасіопіу ООМТокепИзТ сІаззИзТ 

Значение атрибута сіазз элемента представляет собой список имен классов, разде¬ 
ленных пробелами. Данное свойство позволяет получить доступ к отдельным эле¬ 
ментам этого списка и определяет методы чтения, добавления, удаления и пере¬ 
ключения отдельных имен классов. Подробности смотрите в справочной статье 

00МТокепІ_із1і. 

зігіпд сІаззМате 

Это свойство представляет атрибут сіазз элемента. В языке ЛѵаЗсгірі сіазз явля¬ 
ется зарезервированным словом, поэтому свойство получило имя сІаззМате, а не 
сіазз. Обратите внимание, что такое имя этого свойства 1 может вводить в заблуж¬ 
дение, поскольку атрибут сіазз часто включает более одного имени класса. 

геасіопіу Іопд с1іеп*НеідН* 
геасіопіу Іопд сНепШчЛН 

Если данный элемент является корневым элементом (с!оситеп1.с!оситеп1Е1етеп1:), 
эти свойства возвращают внутренние размеры окна, т. е. размеры видимой облас¬ 
ти, куда не входят полосы прокрутки и другие элементы управления, добавляе¬ 
мые броузером. Иначе эти свойства возвращают размеры содержимого элемента 
плюс отступы. 

геасіопіу Іопд с1іеп*І_е?* 
геасіопіу Іопд сІіеггПор 

Эти свойства возвращают расстояние в пикселах между левой или верхней рам¬ 
кой элемента и левой или верхней границей отступов. Обычно это просто толщина 
левой или верхней стороны рамки, но сюда также может входить ширина полос 
прокрутки, если они отображаются вдоль левого или верхнего края элемента. 

СЗЗЗііуІеОесІагаІііоп сиггеп*$*у1е 

Это свойство, реализованное только в ІЕ, является представлением каскадного на¬ 
бора всех С88-свойств, применяемых к элементу. В ІЕ версии 8 и ниже его можно 
использовать как замену стандартному методу 1л/іпс!см.деіСотри1ес13і:у1е(). 

геасіопіу оЬ^есі: сіаііазеі: 

С любым НТМЬ-элементом можно связать любые значения, присваивая их атри¬ 
бутам, имена которых начинаются с префикса «баіа-». Данное свойство сіаііазеі: 
представляет множество атрибутов с данными и упрощает работу с ними. 

Значение этого свойства ведет себя как обычный объект. Каждое свойство объекта 
соответствует одному атрибуту с данными. Если элемент имеет атрибут с именем 
сіаіа-х, объект сіаііазеі: получит свойство с именем х, и сіаііазеі:.х будет возвращать то 
же значение, что и вызов де1:А1і1ігіІэи1іе("с1аііа-х’'). 

Операции чтения и присваивания значений свойствам объекта сіаііазеі: будут чи¬ 
тать и присваивать значения соответствующим атрибутам с данными этого эле¬ 
мента. Оператор сіеіеііе можно использовать для удаления атрибутов с данными, 
а цикл І^ог/іп - для их перечисления. 


і 


Имя свойства указывается в форме единственного числа. - Прим . перев. 
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геасіопіу Еіетепі ІігзІЕІетепіСЫІй 

Это свойство подобно свойству 1і гвііСМіісі объекта Мосіе, но оно игнорирует узлы Тех* 
и Соттепі и возвращает только элементы типа Еіетепі:. 

зігіпд і(1 

Значение атрибута ісі. Никакие два элемента в одном документе не должны иметь 
одинаковые значения атрибута ісі. 

зігіпд іппегНТМІ. 

Доступная для чтения и записи строка, которая определяет текст разметки НТМЬ 
или ХМЬ, содержащийся внутри элемента, за исключением открывающего и за¬ 
крывающего тегов самого элемента. Операция чтения этого свойства возвращает 
содержимое элемента в виде строки НТМЬ- или ХМЬ-текста. Операция записи за¬ 
мещает содержимое элемента представлением НТМЬ- или ХМЬ-текста после его 
синтаксического разбора. 

геасіопіу Ьооіеап ізСопІепІЕсІіІаЫе 

Это свойство имеет значение Ігие, если элемент доступен для редактирования, 
и Іаізе - в противном случае. Элемент может быть доступен для редактирования 
вследствие установки свойства сопІепІесІіІаЫе в нем или в его родителе, или вслед¬ 
ствие установки свойства сІезідпМосІе вмещающего объекта Ооситепі. 

зігіпд Іапд 

Значение атрибута Іапд, определяющее код языка для содержимого элемента, 
геасіопіу Еіетепі: ІазІЕІетепІСИіІР 

Это свойство подобно свойству ІазіСШсІ объекта Мосіе, но оно игнорирует узлы Тех! 
и Соттепі: и возвращает только элементы типа Еіетепі. 

геасіопіу зігіпд ІосаІИате 

Локальное имя данного элемента без префикса. Значение этого свойства отличает¬ 
ся от значения атрибута іадМате, которое может включать префикс пространства 
имен, если таковой имеется (и все символы которого для НТМЬ-элементов преоб¬ 
разуются в верхний регистр). 

геасіопіу зігіпд патезрасеІШ 

IIКЬ -адрес, формально определяющий пространство имен данного элемента. Мо¬ 
жет иметь значение пиі 1 или содержать строку, такую как «Ыір://лѵлѵлѵ.лѵ3.ог§/1999/ 
хМшЬ. 

геасіопіу Еіетепі пех1Е1етеп1$іЫіпд 

Это свойство подобно свойству пехіЗіЬІіпд объекта Мосіе, но оно игнорирует узлы 
Техі и Соттепі и возвращает только элементы типа Еіетепі. 

геасіопіу Іопд оІІзеІНеідИІ 
геасіопіу Іопд оІІзеШчШі 

Высота и ширина элемента и всего его содержимого в пикселах, включая отступы 
и рамки, но без учета полей. 

геасіопіу Іопд оІІзеНеП 
геасіопіу Іопд оіізеіТор 

Координаты X и У верхнего левого угла С88-рамки элемента относительно контей¬ 
нерного элемента оІІзеіРагепі. 

геасіопіу Еіетепі оІІзеіРагепі 

Ссылается на контейнерный элемент, определяющий систему координат, относи¬ 
тельно которой измеряются свойства оіізеНеіі и оІІзеІТор. Для большинства эле- 
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ментов свойство о^зеІРагепІ: ссылается на вмещающий их объект <Ьос1у>. Однако 
если контейнерный элемент имеет динамическое позиционирование, ссылка на не¬ 
го становится значением свойства о^зеІРагепТ динамически позиционируемого 
элемента, а если элемент располагается в таблице, значением свойства оІ^зеІРагеп* 
может быть ссылка на элемент <Тс!>, <ТИ> или <ТаЫе>. Подробности приводятся в раз¬ 
деле 15.8.5. 

зТгіпд оиТегНТМІ. 

Разметка НТМЬ или ХМЬ, определяющая данный элемент и его содержимое. Если 
присвоить этому свойству строку, она заменит данный элемент (и все его содержи¬ 
мое) результатом синтаксического разбора нового значения как фрагмента НТМЬ- 
или ХМЬ-документа. 

геасіопіу зігіпд рге^іх 

Префикс пространства имен для данного элемента. Обычно это свойство содержит 
значение піЛІ. Исключение составляют ХМЬ-документы, в которых используются 
пространства имен. 

геасіопіу Еіетепі: ргеѵіоизЕІетепІЗіЫіпд 

Это свойство подобно свойству ргеѵіоизЗіЫіпд объекта Мосіе, но оно игнорирует уз¬ 
лы Тех! и Соттепі: и возвращает только элементы типа Еіетепі:. 

геасіопіу Іопд зсгоІІНеідМ: 
геасіопіу Іопд зсгоІШчШі 

Общая высота и ширина элемента в пикселах. Когда элемент имеет полосы про¬ 
крутки (например, потому что был установлен С88-атрибут оѵегИом), значения 
этих свойств отличаются от значений свойств о^зеІНеідІтЕ и о^зеІІл/ісЛИ, которые 
просто содержат размеры видимой части элемента. 

Іопд зсгоШеГЬ 
Іопд зсгоПТор 

Число пикселов, на которое элемент был прокручен за левую или верхнюю границу. 
Обычно эти свойства полезны только для элементов с полосами прокрутки, у кото¬ 
рых, например, С88-атрибут оѵегИом имеет значение аиіо. В элементе <И1:т1> (см. 
ОоситепІ.сІосіітепіЕІетепІ:) эти свойства определяют общую величину прокрутки все¬ 
го документа. Обратите внимание: эти свойства не определяют величину прокрут¬ 
ки в теге <і1тате>. Этим свойствам можно присваивать значения, чтобы выполнять 
прокрутку элемента или всего документа. Подробности приводятся в разделе 15.8.5. 

геасіопіу С333і:у1е0ес1ага1:іоп зіуіе 

Значение атрибута зіуіе, задающее встроенные С88-стили для элемента. Обратите 
внимание: значение этого свойства является не строкой, а объектом, свойства ко¬ 
торого соответствуют 088-атрибутам и доступны для чтения и записи. Подробно¬ 
сти см. в справочной статье об объекте СЗЗЗіуІеОесІагаІіоп. 

геасіопіу зігіпд іадМаше 

Имя тега элемента. Для элементов НТМЬ-документа имя тега возвращается в верх¬ 
нем регистре независимо от регистра символов в исходном тексте документа, т. е. 
элемент <р> будет иметь в свойстве ІадМате строку «Р». ХМЬ-документы чувстви¬ 
тельны к регистру, и имя тега возвращается в точности в том виде, в каком оно за¬ 
писано в исходном тексте документа. Это свойство имеет то же значение, что 
и свойство посІеМате интерфейса Мосіе. 

зігіпд Ш1е 

Значение атрибута Шіе элемента. Многие броузеры отображают значение этого ат¬ 
рибута в виде всплывающей подсказки при наведении указателя мыши на элемент. 
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Методы 

ѵоісі Ыиг() 

Передает фокус ввода элементу Ьосіу вмещающего объекта Ооситепі. 
ѵоісі с1іск() 

Имитирует щелчок мышью на элементе. Если в случае щелчка на данном элемен¬ 
те должно что-то происходить (например, переход по ссылке), вызов этого метода 
также приведет к выполнению этих действий. В противном случае этот метод про¬ 
сто сгенерирует событие «сііск» в элементе. 

ѵоісі іосиз() 

Передает фокус ввода в данный элемент, 
зігіпд деіА«гіЬиіе(з1:гіпд ^^а1і1 : іесINате) 

Метод деіАіігіЬиіеО возвращает значение указанного атрибута для элемента или 
піЛІ, если такого атрибута не существует. Обратите внимание, что объекты, пред¬ 
ставляющие НТМЬ-элементы, определяют ЛѵаЗсгірі-свойства, соответствующие 
стандартным НТМЬ-атрибутам, поэтому надобность в этом методе возникает толь¬ 
ко при необходимости обратиться к нестандартным атрибутам. В НТМЬ-докумен- 
тах сравнение имен атрибутов выполняется без учета регистра символов. 

В ХМЬ-документах значения атрибутов недоступны непосредственно как свойства 
элемента, и к ним надо обращаться путем вызова этого метода. Для ХМЬ-докумен- 
тов, в которых используются пространства имен, когда в имя атрибута включает¬ 
ся префикс пространства имен и двоеточие, может потребоваться использовать 
метод деіАіігіІэиіеМЗО или деіАіігіІэиіеМосІеМЗО. 

зігіпд де*А«гіЬЩеМ8(з1:гіпд патезрасе, зігіпд ІосаМате) 

Этот метод действует так же, как метод деіАіігіЬиіеО, кроме того, что атрибут за¬ 
дается комбинацией ШН пространства имен и локального имени, определенного 
в данном пространстве имен. 

СІіепіВесІ: деіВоипс]іпдС1іеп1:Вес1;( ) 

Возвращает объект СІіепіВесІ:, описывающий прямоугольник, ограничивающий 
данный элемент. 

СІіепіВесіП деіС1іепіНесіз() 

Возвращает объект, подобный массиву, содержащий объекты СІіепіВесіз, которые 
описывают один или более прямоугольников, ограничивающих данный элемент. 
(Чтобы точно описать область окна, занимаемую строчными элементами, разме¬ 
щающимися в нескольких строках, обычно требуется более одного прямоуголь¬ 
ника.) 

Мосіеі-ізі: деіЕІетепізВуСІаззМаіпеСзігіпд сІаззИатез) 

Возвращает объект, подобный массиву, содержащий вложенные элементы, в кото¬ 
рых значение атрибута сіазз включает все имена классов с1азз№тез. Аргумент 
сІаззМатез может содержать имя одного класса или список нескольких имен клас¬ 
сов, разделенных пробелами. Возвращаемый объект МосІеІ_із1: является «живым» 
и автоматически обновляется при изменении документа. Элементы в возвращаемом 
объекте МосІеІ_і5І: располагаются в том же порядке, в каком они присутствуют в доку¬ 
менте. Обратите внимание, что этот метод также определен в объекте Ооситепі. 

Мос!еІ_ізі: деіЕ1етепізВуТадМате(з1:гіпд рііаІіГіесІМате) 

Выполняет обход всех вложенных элементов и возвращает «живой» объект Мосіе¬ 
і-ізі: узлов Еіетепі, представляющих все элементы документа с указанным именем 
тега. Элементы в возвращаемом объекте МосІеІ_і5І: располагаются в том же порядке, 
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в каком они присутствуют в исходном документе. Обратите внимание, что объект 
Ооситепі: также имеет метод деіЕІетепізВуТадМатеО, действующий подобным обра¬ 
зом, но выполняющий обход всего документа, а не только элементов, вложенных^ 
в данный элемент. 

№)СІеІ_і8І: де*Е1етеп*зВуТадМапіеМ8(з1:гіпд патезрасе, зТгіпд ІосаМате) 

Этот метод действует подобно методу деіЕІетепізВуТадМатеО, за исключением того, 
что имя тега требуемых элементов указывается как комбинация ІІКІ пространст¬ 
ва имен и локального имени в этом пространстве имен. 

Ьооіеап НазА«гіЬи*е(з1:гіпд риаІіТіеРЦатё) 

Возвращает Ігие, если этот элемент имеет атрибут с указанным именем, или Шзе 
в противном случае. В НТМЬ-документах имена атрибутов нечувствительны к ре¬ 
гистру символов. 

Ьооіеап НазА«гіЬи*еМ8(зі:гіпд патезрасе, зігіпд ІосаМате) 

Этот метод действует так же, как метод ИазАИгіЬиІеО, за исключением того, что 
атрибут задается комбинацией ІІКІ пространства имен и локального имени в этом 
пространстве имен. 

ѵоісі іпзегЬА(Цасеп*НТМІ_(з1:гіпд розШоп, зігіпд іехі) 

Вставляет разметку НТМЬ ТехТ в позицию розШоп относительно данного элемен¬ 
та. Аргумент розШоп может иметь одно из следующих строковых значений: 


Значение аргумента розШоп 

Описание 

ЪеІогеЪе&іп 

Вставляет текст перед открывающим тегом элемента 

аііегегкі 

Вставляет текст после закрывающего тега элемента 

аНегЬе^іп 

Вставляет текст сразу после открывающего тега элемента 

Ъеіогееікі 

Вставляет текст непосредственно перед закрывающим те¬ 
гом элемента 


Еіетепі: диегу8е1ес*ог(з1:гіпд зеІесТогз) 

Возвращает первый вложенный элемент, соответствующий С88-селекторам зеіес- 
Тогз (это может быть единственный С88-селектор или группа селекторов, разде¬ 
ленных запятыми). 

№)СІеІ_і5І: диегу8е1ес*огА11(з1:гіпд зеіесіогз) 

Возвращает объект, подобный массиву, содержащий все элементы, вложенные 
в данный элемент, которые соответствуют селекторам зеіесіогз (это может быть 
единственный С88-селектор или группа селекторов, разделенных запятыми). В от¬ 
личие от объекта МосІеНзі, возвращаемого методом де*Е1етегЦзВуТадМате(), объект 
МосІеНзІ:, возвращаемый этим методом, является статическим: он содержит набор 
элементов, соответствовавших селекторам на момент вызова метода. 

ѵоісі гетоѵеА«гіЬи*е(з1:гіпд риаІіТіедНатё) 

Удаляет из элемента атрибут с указанным именем. Попытки удалить несущест¬ 
вующие атрибуты просто игнорируются. В НТМЬ-документах имена атрибутов 
нечувствительны к регистру символов. 

ѵоісі гетоѵеА«гіЬи*еМ8(з1:гіпд патезрасе, зігіпд ІосаІИате ) 

Метод гетоѵеАИгіЬиІеМ8() действует так же, как метод гетоѵеАНгіЬи^еО, за исклю¬ 
чением того, что удаляемый атрибут задается ІІКІ пространства имен и локально¬ 
го имени. 
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ѵоій зсго11Іп*оѴіеи([Ьоо1еап Тор]) 

Если НТМЬ-элемент в настоящий момент находится за пределами окна, этот метод 
прокрутит документ так, что элемент окажется в пределах окна. Аргумент Тор яв¬ 
ляется необязательным и подсказывает методу, должен ли элемент оказаться бли¬ 
же к верхнему или к нижнему краю окна. Если он равен Ігие или отсутствует, бро¬ 
узер старается выполнить прокрутку так, чтобы элемент оказался ближе к верхне¬ 
му краю окна. Если он равен Шве, броузер старается выполнить прокрутку так, 
чтобы элемент оказался ближе к нижнему краю окна. Для элементов, принимаю¬ 
щих фокус ввода, таких как элементы Іприі, метод ^осіізС ) неявно выполняет точно 
такую же операцию прокрутки. См. также описание метода всгоІІТоО объекта 
Міпсісм. 

ѵоісі зе*А«гіЬи*е(зі:гіпд ^^а1іТіесINате, зігіпд ѵаіііе) 

Присваивает указанное значение атрибуту с указанным именем. Если атрибут 
с таким именем еще не существует, в элемент добавляется новый атрибут. В НТМЬ- 
документах перед присваиванием значения символы в имени атрибута преобразу¬ 
ются в нижний регистр. Обратите внимание: в НТМЬ-доку менте Лѵа8сгірІ-свой- 
ства, соответствующие всем стандартным НТМЬ-атрибутам, определяются объек¬ 
тами НТМІ_Е1етеп1і. Поэтому данный метод обычно используется лишь для доступа 
к нестандартным атрибутам. 

ѵоісі зе*А«гіЬи*еМ$($1:гіпд патезрасе . зігіпд ^^а1іТіесINате, віігіпд ѵаіие ) 

Этот метод действует так же, как метод зеІАИгіЬиіеО, за исключением того, что 
имя атрибута указывается как комбинация ІШІ пространства имен и квалифици¬ 
рованного имени, состоящего из префикса пространства имен, двоеточия и ло¬ 
кального имени в этом пространстве имен. 

Обработчики событий 

Объекты Еіетепі, представляющие НТМЬ-элементы, определяют достаточно много 
свойств обработчиков событий. Достаточно присвоить функцию любому свойству из 
числа перечисленных ниже, и эта функция будет вызываться при возникновении со¬ 
бытия данного типа в элементе (или по достижении элемента в результате всплытия). 
Для регистрации обработчиков событий можно также использовать методы, опреде¬ 
ляемые интерфейсом ЕѵепіТагдеІ:. 

Большинство событий всплывают вверх по дереву документа до узла Оосіігпепі: и затем 
передаются объекту Міпсісм. Поэтому все свойства обработчиков событий, перечислен¬ 
ные ниже, определены также в объектах Ооситепі: и Міпсісм. Однако объект Міпсісм обла¬ 
дает достаточно большим количеством собственных обработчиков событий, и свойст¬ 
ва, помеченные звездочкой в таблице ниже, в объекте Іл/іпсіом имеют другой смысл. По 
историческим причинам обработчики событий, зарегистрированные посредством 
НТМЬ-атрибутов в элементе <ЬосІу>, регистрируются в объекте Міпсісм, а это означает, 
что свойства, помеченные звездочкой, в элементе <ЬосІу> имеют другой смысл. См. так¬ 
же Міпсісж. 

Многие события, перечисленные здесь, возбуждаются только в НТМЬ-элементах оп¬ 
ределенных типов. Но, так как многие из этих событий всплывают вверх по дереву 
документа, свойства обработчиков событий определены во всех элементах. Мультиме¬ 
дийные события, введенные спецификацией НТМЬб, которые возбуждаются в тегах 
<аис!іо> и <ѵійео>, не всплывают, поэтому они описываются в справочной статье Месііа- 
Еіетепіі. Аналогично некоторые события форм, введенные спецификацией НТМЬб, 
также не всплывают и описываются в справочной статье РоплСопіігоі. 
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Справочник по клиентскому )аѵа5сгір1: 


Обработчик 

события 

опаЬогТ 

опЫиг* 

операнде 

опсііск 

опсопТехТглепи 

опсіЫсІіск 

опсігад 

опсігадепсі 

опйгадепТег 

опсігадіеаѵе 

опсігадоѵег 

опсігадзтагі: 

опсігор 

опеггог* 

оп^осиз* 

опіприі: 

опкеусіомп 

опкеургезз 

опкеуіір 

опіоасі* 

оптоизесіомп 

оптоизетоѵе 

оптсшзеоііі: 

оптоызеоѵег 

оптоизеыр 

оптсшземііееі 

опгезеТ 

0П5СГ0І1* 

опзеіесі: 

опзиЬтіІ: 


Вызывается, когда... 

загрузка ресурса прервана по требованию пользователя 
элемент потерял фокус ввода 

пользователь изменил содержимое или состояние элемента формы (возбуж¬ 
дается по окончании редактирования, а не по каждому нажатию клавиши) 

элемент активирован щелчком мыши или каким-то другим способом 

контекстное меню готово к отображению, обычно в результате щелчка 
правой кнопки 

выполнен двойной щелчок мышью 

буксировка продолжается (возбуждается в элементе-источнике) 

буксировка завершена (возбуждается в элементе-источнике) 

буксируемые данные оказались над элементом (возбуждается в элементе- 
приемнике) 

буксируемые данные вышли за границы элемента (возбуждается в элемен¬ 
те-приемнике) 

буксировка продолжается (возбуждается в элементе-приемнике) 

пользователь начал операцию буксировки (возбуждается в элементе-ис¬ 
точнике) 

пользователь завершил буксировку (возбуждается в элементе-приемнике) 
возникла ошибка загрузки ресурса (обычно вследствие сетевой ошибки) 
элемент получил фокус ввода 

выполнен ввод в элемент формы (возбуждается значительно чаще, чем 

операнде) 

пользователь нажал клавишу 

в результате нажатия на клавишу сгенерирован печатаемый символ 
пользователь отпустил клавишу 

загрузка ресурса (например, изображения для элемента <ітд>) завершена 

пользователь нажал кнопку мыши 

пользователь переместил указатель мыши 

указатель мыши вышел за границы элемента 

указатель мыши оказался над элементом 

пользователь отпустил кнопку мыши 

пользователь повернул колесико мыши 

выполнен сброс формы 

выполнена прокрутка элемента, имеющего полосы прокрутки 
пользователь выделил текст в элементе формы 
выполнена отправка формы 


НТМІ_-элементы и атрибуты 

Этот раздел включает справочные статьи для следующих типов НТМЬ-элементов: 
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Элемент 

Справочная статья 

Элемент 

Справочная статья 

<аис!іо> 

Аисііо 

<ои1:ри'*:> 

ОиХриХ 

<Ьииоп>, <іприІ 
Іуре="Ьи1:1:оп"> 

ВиПоп 

<ргодгезз> 

Ргодгезз 

<сапѵаз> 

Сапѵаз 

<5СГІрІ> 

Зсгірі 

<Гіе1сІ5е1> 

РіеІсіЗеІ: 

<5е1ес1> 

Зеіесі 

<Еогт> 

Рогт 

<з1у1е> 

Зіуіе 

<і!тате> 

ІРгате 

<1с1> 

ТаЫеСеІІ 

<ітд> 

Ітаде 

<1г> 

ТаЫеВом 

<іприі> 

Іприі: 

<ІЬос1у>, <1?оо1>, <ІМеас1> 

ТаЫеЗесІіоп 

<1аЬе1> 

І_аЬе1 

<1аЫе> 

ТаЫе 

<а>, <агеа>, <1іпк> 

1_іпк 

<1ех1агеа> 

ТехіАгеа 

<те1ег> 

Меіег 

<ѵіс!ео> 

Ѵісіео 

<орІіоп> 

Орііоп 




НТМЬ-элементы, для которых отсутствуют собственные справочные статьи, относят¬ 
ся к числу тех, чьи свойства просто соответствуют НТМЬ-атрибутам элементов. Ниже 
перечислены атрибуты, допустимые в любых НТМЬ-элементах и потому являющиеся 
свойствами всех объектов Еіетепі:: 


Атрибут _ 

ассеззКеу 

сіазз 

сопІепІЕсііІіаЫе 

сопіехІМепи 


(Иг 

сІгаддаЫе 

сігоріопе 

Иісісіеп 

ісі 

Іапд 

зреІІсМеск 

зііуіе 

ІаЫпсіех 

Шіе 


Описание _ 

Горячая комбинация клавиш на клавиатуре 

С88-класс: см. описание свойств с1азз№те и сіаззизі выше. 

Доступно ли содержимое элемента для редактирования. 

Значение атрибута ісі элемента стегни, который должен отображаться как 
контекстное меню. На момент написания этих строк поддерживался толь¬ 
ко в ІБ. 

Направление письма: «11г» (слева направо) или «гіЬ (справа налево). 

Логический атрибут, устанавливаемый в элементах, которые могут слу¬ 
жить элементами-источниками для АРІ буксировки. 

Логический атрибут, устанавливаемый в элементах, которые могут слу¬ 
жить элементами-приемниками для АРІ буксировки. 

Логический атрибут, устанавливаемый в элементах, которые не должны 
отображаться. 

Уникальный идентификатор элемента. 

Основной язык текста в элементе. 

Требуется ли проверять орфографию в текстовом содержимом элемента. 

Встроенные стили С88 элемента. См. описание свойства зіуіе выше. 

Определяет порядковый номер элемента в операциях передачи фокуса 
ввода. 

Текст всплывающей подсказки для элемента. 
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Следующие НТМЬ-элементы не имеют атрибутов, кроме тех, что перечислены выше: 


<аЬЬг> 

<сос!е> 

<іооіег> 

<Ьг> 

<п> 

<зыр> 

<асІсІге53> 

<(1аіа1ізі> 

<М> 

<і> 

<гиЬу> 

<ІЬос1у> 

<а гііс1е> 

<66> 

<Ь2> 

<кЬс!> 

<5> 

<ІІООІ> 

<азіс!е> 

<с!іп> 

<МЗ> 

<1едепс1> 

<затр> 

<1:Иеас1> 

<Ь> 

<СІІѴ> 

<М> 

<тагк> 

<зесііоп> 

<ІШе> 

<Ь(Л> 

<СІ1> 

<М5> 

<паѵ> 

<зта11> 

<и> 

<Ьс1о> 

<сИ> 

<М6> 

<позсгірі:> 

<зрап> 

<іЛ> 

<Ьг> 

<ет> 

<ИеасІ> 

<Р> 

<5ігопд> 

<ѵаг> 

<сарііоп> 

<іідсарІіоп> 

<Иеас1ег> 

<рге> 

<зиЬ> 

<ѵіЪг> 

<сііе> 

<іідиге> 

<Мдгоир> 

<гр> 

<5ілптагу> 



Остальные НТМЬ-элементы и поддерживаемые ими атрибуты перечислены ниже. Об¬ 
ратите внимание, что в этой таблице перечислены только атрибуты, отличающиеся 
от глобальных атрибутов, перечисленных выше. Также отметьте, что эта таблица 
включает элементы, для которых имеются отдельные справочные статьи: 

Элемент Атрибуты 

<а> Ьге^, іаг^еі, ріп&, геі, тесііа, ЬгеНап&, іуре 

<агеа> аіі, соогсіз, зЬаре, Ъгеі, іаг^еі, ріп&, геі, тесііа, ЬгеПап&, Іуре 

<аисЛо> зге, ргеіоасі, аиіоріау, Іоор, сопігоіз 

<Ьазе> ЪгеЬ іаг&еі 

<ЫоскдиоІе> сііе 

<Ьос1у> опаЛегргіпі, опЬе^огергіпі, опЪеіогеипІоасІ, опЫиг, опеггог, опіосиз, опЬазЬ- 

сЬап&е, опіоасі, оптевза&е, опоШіпе, опопііпе, опра^еЬкіе, опра&евЬолѵ, 
опрорзіаіе, опгесіо, опгезіге, опзсгоіі, опзіога&е, опипсіо, опипіоасі 

<Ьы11оп> аиіоіосиз, (ІізаЫесІ, й>гт, іогтасііоп, ^огтепсіуре, іогттеііюсі, ^огтпоѵа- 

Іісіаіе, {огтіаг&еі, пате, Іуре, ѵаіие 

<сапѵаз> лѵісШі, Ьеі&Ьі 

<со1> зрап 

<со1дгоир> зрап 

<соттапс!> іуре, ІаЬеІ, іеоп, (ІізаЫесІ, сЬескесІ, гасНо^гоир 
<с!е1> сііе, сіаіеііте 

<с1е1:аіІ5> ореп 

<етЬесі> зге, іуре, лѵісШі, Ьеі^Ьі 

<ііе1сІ5е1:> (ІізаЫесІ, й>гт, пате 

<іогт> ассері-сЬагзеі, асііоп, аиіосотріеіе, епсіуре, теіЬосі, пате, поѵаіісіаіе, іаг&еі 

<И1:т1> тапі&зі 

<іігате> зге, згссіос, пате, запсІЬох, зеатіезз, лѵісіііі, Ьеі^Ьі 
<ітд> аіі, зге, изетар, ізтар, лѵісШі, Ьеі&Ьі 

<іпри1:> ассері, аіі, аиіосотріеіе, аиіоіосиз, сЬескесІ, сіігпате, сіізаЫесІ, іогт, іогт- 

асііоп, ^огтепсіуре, іогттеііюсі, ^огтпоѵаіісіаіе, й)гтіаг&еі, Ьеі^Ьі, Изі, 
тах, тахІеп&іЬ, тіп, тиіііріе, пате, раііегп, рІасеЬоЫег, геасіопіу, ^е^иі^ес1, 
зіге, зге, зіер, іуре, ѵаіие, лѵісШі 

<іпз> сііе, сіаіеііте 
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Элемент 

Атрибуты 

<кеудеп> 

аиіоіосиз, сЬаІІеп^е, сіізаЫесі, іогт, кеуіуре, пате 

<1аЬе1> 

іогт, іог 

<1і> 

ѵаіие 

<1іпк> 

Ьгеі, геі, тесііа, Ьгеі1ап&, іуре, зігез 

<тар> 

пате 

<тепи> 

іуре, ІаЪеІ 

<теіа> 

пате, Ьіір-ециіѵ, сопіепі, сЬагзеі 

<теіег> 

ѵаіие, тіп, тах, Іолѵ, Ъі&Ъ, оріітит, іогт 

<ок^есі> 

(Іаіа, іуре, пате, изетар, іогт, лѵісііЪ, Ъеі^Ъі 

<0І> 

геѵегзесі, зіагі 

<орідгоир> 

сіізаЫесі, ІаЪеІ 

<орііоп> 

сіізаЫесі, ІаЪеІ, зеіесіесі, ѵаіие 

<оиіріЦ> 

іог, іогт, пате 

<рагат> 

пате, ѵаіие 

<ргодгезз> 

ѵаіие, тах, іогт 

<д> 

сііе 

<зсгірі> 

зге, азупс, сіеіег, іуре, сЬагзеі 

<зе1есі> 

аиіоіосиз, сіізаЫесі, іогт, тиіііріе, пате, гециігесі, зіге 

<зоигсе> 

зге, іуре, тесііа 

<зіу1е> 

тесііа, іуре, зсоресі 

<іаЫе> 

зиттагу 

<1с1> 

соізрап, голѵзрап, Ъеасіегз 

<іехіагеа> 

аиіоіосиз, соіз, сіізаЫесі, іогт, тахІеп^іЬ, пате, рІасеЪокіег, геасіопіу, ^е^иі- 
гесі, голѵз, лѵгар 

<іР> 

соізрап, голѵзрап, Ъеасіегз, зсоре 

<ііте> 

сіаіеііте, риЪсІаіе 

<ігаск> 

сіеіаиіі, кіпсі, ІаЪеІ, зге, згс1ап& 

<ѵіс!ео> 

зге, розіег, ргеіоасі, аиіоріау, Іоор, сопігоіз, лѵісІіЪ, Ьеі^Ьі 


ЕггогЕѵепІ 

необработанное исключение в фоновом потоке выполнения Еѵепі 

Когда в фоновом потоке выполнения, который представляет объект Могкег, возникает 
необработанное исключение, которое также не было обработано функцией о пег го г 
в объекте МогкегбІоЬаІЗсоре, оно вызывает невсплывающее событие «еггог» в объекте 
Могкег. Вместе с событием обработчику передается объект события ЕггогЕѵепІ, содер¬ 
жащий информацию об исключении. Вызов метода ргеѵепЮеіаиІіО объекта ЕггогЕѵепІ: 
(или возврат значения іаізе из обработчика события) предотвратит дальнейшее рас¬ 
пространение события по объемлющим потокам выполнения и также может предот¬ 
вратить вывод сообщения об ошибке в консоли. 
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Свойства 

геасіопіу зігіпд Іііепате 

ІШЬ-адрес файла со сценарием на языке ЛѵаВсгірі, в котором возникло исключе¬ 
ние. 

геасіопіу ипзідпесЗ Іопд Ііпепо 

Номер строки в этом файле, в которой возникло исключение, 
геасіопіу зТгіпд теззаде 

Сообщение с описанием исключения. 

Еѵепі 

информация о стандартных событиях, события ІЕ и іОиегу 

Когда вызывается обработчик события, ему передается объект Еѵепі, чьи свойства со¬ 
держат дополнительную информацию о событии, такую как тип события и элемент, 
в котором оно возникло. С помощью методов этого объекта Еѵепі: можно управлять 
распространением события. Все современные броузеры реализуют стандартную мо¬ 
дель событий, кроме ІБ, который в версии 8 и ниже определяет свою собственную, не 
совместимую с другими броузерами модель. Эта справочная статья описывает стан¬ 
дартные свойства и методы объекта события, альтернативные им свойства и методы, 
поддерживаемые в ІБ, а также охватывает объект события, реализованный в библио¬ 
теке і(}иегу, который имитирует стандартный объект события в ІЕ. Более подробно 
о событиях рассказывается в главе 17, а о поддержке событий в библиотеке і(}иегу - 
в разделе 19.4. 

В стандартной модели событий для различных типов событий определены различные 
типы объектов событий, связанных с ними: по событиям мыши, например, обработ¬ 
чикам передается объект МоизеЕѵепІ со свойствами, имеющими отношение к мыши, 
а по событиям клавиатуры передается объект КеуЕѵепІ со свойствами, имеющими от¬ 
ношение к клавиатуре. Оба типа, МоизеЕѵепІ и КеуЕѵепІ, наследуют общий суперкласс 
Еѵепі:. Однако в моделях событий ІЕ и і(}иегу по всем событиям, возникающим в объ¬ 
ектах Еіетепі, передаются объекты единого типа Еѵепі. Свойства объекта Еѵепі, имею¬ 
щие отношение к клавиатуре, не будут иметь сколько-нибудь осмысленные значения 
в обработчике события мыши, но сами свойства будут определены в объекте. Для про¬ 
стоты в этой справочной статье не рассматривается иерархия событий и описываются 
свойства всех событий, которые могут получить объекты Еіетепі (и затем всплыть до 
объектов Ооситепі и Міпсісм). 

Первоначально практически все события в клиентских сценариях генерировались 
в элементах документа, поэтому такое смешивание свойств, имеющих отношение к до¬ 
кументу, в одном объекте выглядит вполне естественным. Однако НТМЬб и связанные 
с ним стандарты определяют множество новых типов событий, которые генерируются 
в объектах, не являющихся элементами документа. Для этих типов событий часто оп¬ 
ределяются собственные объекты событий, и этим объектам посвящены собственные 
справочные статьи. См. статьи ВеІогеІМоасІЕѵепІ, СІозеЕѵепІ, ЕггогЕѵепІ, НазІіСМапдеЕѵепІ, 
МеззадеЕѵепІ, РадеТгапзіІіопЕѵепі, РорЗіаІеЕѵепІ, РгодгеззЕѵепІ и ЗіогадеЕѵепІ. 

Большинство из этих типов объектов событий расширяют тип Еѵепі. Для других но¬ 
вых типов событий, появившихся в стандарте НТМЬб, их отдельные типы объектов 
событий не определяются - обработчикам этих событий передается обычный объект 
Еѵепі. Данная справочная статья описывает этот «обычный» объект Еѵепі, плюс неко¬ 
торые из его подтипов. Свойства в списке ниже, помеченные звездочкой, определяют¬ 
ся непосредственно типом Еѵепі. Эти свойства наследуются такими объектами собы- 
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тий, как МеззадеЕѵепі:, и используются при работе с простыми событиями, такими как 
событие «Іоасі» объекта Міпсіоѵѵ и событие «р1ауіп&» объекта МейіаЕІетепІ:. 

Константы 

Следующие константы определяют значения свойства еѵепіРПазе. Это свойство и эти 
константы не поддерживаются моделью событий, реализованной в ІБ. 

ипзідпесі зГюгі САРТШМС.РНА8Е = 1 

Событие посылается перехватывающим обработчикам событий в предках целево¬ 
го объекта. 

ипзідпей зГіогі АТТАН6ЕТ = 2 

Событие посылается обработчикам целевого объекта 
ипзідпесі зііогі ВІШВІ_ІН6_РНА$Е = 3 

Событие всплывает и посылается обработчикам событий в предках целевого объ¬ 
екта. 

Свойства 

Следующие свойства определяются стандартной моделью для объекта Еѵепі событий, 
а также для объектов событий, связанных с событиями мыши и клавиатуры. В этот 
список также включены свойства, определяемые моделями событий ІБ и і(}иегу. Свой¬ 
ства, помеченные звездочкой, определены непосредственно в объекте Еѵепі и доступ¬ 
ны в любых стандартных объектах событий, независимо от типов событий, с которы¬ 
ми они связаны. 

геасіопіу Ьооіеап аШеу 

Указывает, удерживалась ли нажатой клавиша АН в момент события. Определено 
для событий мыши и клавиатуры, а также в модели событий ІБ. 

геасіопіу Ьооіеап ЬиЬЫез* 

Значение 1:гие, если тип события поддерживает «всплытие» (и если не вызван метод 
зіорРгорадаііопО), и іаізе - в противном случае. Отсутствует в модели событий ІБ. 

геасіопіу ипзідпесі зМогі Ьиііоп 

Указывает, изменение состояния какой кнопки мыши вызвало событие «тоизе- 
с!о\ѵп», «тоизеир» или «сііск». Значение 0 соответствует левой кнопке, значение 2 - 
правой и значение 1 - средней кнопке мыши. Обратите внимание, что значение это¬ 
го свойства определено только для событий, связанных с изменением состояния 
кнопки мыши - оно не используется, например, чтобы сообщить, какая кнопка 
удерживалась при возникновении события «тоизетоѵе». Кроме того, это свойство 
не является битовой маской: оно не позволяет сообщить обработчику об измене¬ 
нии состояния более чем одной кнопки. Наконец, некоторые броузеры генерируют 
события только для левой кнопки. 

Модель событий ІБ определяет несовместимое свойство Ьиііоп. В этом броузере 
данное свойство является битовой маской: бит 1 устанавливается, когда была на¬ 
жата левая кнопка, бит 2 - когда была нажата правая кнопка и бит 4 - когда была 
нажата средняя кнопка (трехкнопочной) мыши. Библиотека іСіиегу не имитирует 
стандартное свойство Ьиііоп в ІБ, вместо этого она реализует свойство ѵѵРісІі. 

геасіопіу Ьооіеап сапсеІаЫе* 

Значение ігие, если действие, предлагаемое по умолчанию и связанное с событи¬ 
ем, может быть отменено с помощью метода ргеѵепЮеіаиІіО, и іаізе - в противном 
случае. Определено во всех стандартных объектах событий и отсутствует в модели 
событий ІБ. 
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Ьооіеап сапсеІВиЬЬІе 

В модели событий ІЕ, чтобы в обработчике события остановить дальнейшее рас¬ 
пространение события вверх по дереву вмещающих объектов, в это свойство нуж¬ 
но записать значение Ігие. В стандартной модели событий для этой цели следует 
использовать метод 5І:орРгорада1:іоп(). 

геасіопіу іпіедег сЬагСоРе 

Для событий «кеургезз» это свойство содержит код Юникода сгенерированного пе¬ 
чатного символа. Данное свойство равно нулю в случае нажатия функциональной 
клавиши. Оно не используется событиями «кеуйолѵп» и «кеуир». Преобразовать это 
число в строку можно с помощью метода Зігіпд.ІтотСЬагСосІеО. Для событий «кеу- 
ргезз» то же самое значение большинство броузеров записывают в свойство кеуСоРе. 
Однако в Рігеіох свойство кеуСоРе не определено для события «кеургезз», поэтому 
следует использовать свойство сЬагСоЬе. Данное свойство является нестандарт¬ 
ным, отсутствует в модели событий ІЕ и не имитируется в модели событий іСіиегу. 

геасіопіу Іопд сііепіх 
геасіопіу Іопд сііепіѵ 

Координаты X и У указателя мыши относительно клиентской области или окна 
броузера. Обратите внимание: эти координаты не учитывают величину прокрутки 
документа; если событие происходит на верхнем краю окна, свойство сііепіѵ будет 
равно 0 независимо от того, как далеко выполнена прокрутка документа. Эти свой¬ 
ства определены для всех типов событий мыши, и в модели событий ІЕ, и в стан¬ 
дартной модели. См. также радеХ и радеУ. 

геасіопіу Ьооіеап сІгІКеу 

Указывает, удерживалась ли нажатой клавиша Сііі в момент события. Определено 
для событий мыши и клавиатуры, а также в модели событий ІЕ. 

геасіопіу ЕѵепіТагдеІ: сиггеп^Тагде^* 

Объект Еіетепі:, Ооситепі: или Міпсіом, обрабатывающий событие в данный момент. 
Во время фазы перехвата и всплытия значение свойства отличается от іа где*. От¬ 
сутствует в модели событий ІЕ, но имитируется в модели событий іСіиегу. 

геасіопіу ОаІаТгапзІег РаІаТгапзІег 

Для событий буксировки (сіга^-апсі-сігор) это свойство определяет объект РаІіаТгапз- 
{"ег, полностью координирующий выполнение операции буксировки. События 
буксировки относятся к событиям мыши; любое событие, имеющее это свойство, 
также будет иметь свойства сііепіх, сііепіѵ и другие, свойственные событиям мы¬ 
ши. События буксировки «йга^зіагі», «сіга&» и «сІга&епсЬ возбуждаются в объек¬ 
те-источнике; а события «сіга&епіег», «сіга&оѵег», «<1га&1еаѵе» и «сігор» - в объек¬ 
те-приемнике. Дополнительные сведения об операциях буксировки приводятся 
в справочной статье ОаІаТгапзІег и в разделе 17.7. 

геасіопіу Ьооіеап бе^аиІІРгеѵепіеб* 

Значение Ігие, если обработчик этого события вызвал йе^аиІіРгеѵепІесІО, и Іаізе - 
в противном случае. Это новое расширение стандартной модели событий, и потому 
может быть реализовано не всеми броузерами. (Модель событий і(}иегу определя¬ 
ет метод ізОеІаіЛІРгеѵепІіесіО, действующий подобно этому свойству.) 

геасіопіу Іопд йеіаіі 

Сведения о событии (число). Для событий «сііск», «тоизесіолѵп» и «тоизеир» это 
свойство показывает количество щелчков: 1 - одинарный щелчок, 2 - двойной 
щелчок, 3 - тройной щелчок и т. д. В Рігеіох это свойство используется событиями 
«БОММоизеЗсгоІЬ, чтобы сообщить величину прокрутки колесика мыши. 
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геасіопіу ипзідпей зМогі: еѵепІРНазе* 

Текущая фаза распространения события. Значение свойства - одна из трех кон¬ 
стант, описанных выше. Не поддерживается в модели событий ІБ. 

геасіопіу Ьооіеап ізТгизіей* 

Значение Іігие, если это событие было создано и послано броузером, и Шзе - если 
это искусственное событие, созданное и посланное сценарием на языке ^ѵаЗсгірі. 
Это относительно новое расширение стандартной модели событий, и потому мо¬ 
жет быть реализовано не всеми броузерами. 

геасіопіу Еіетепі: УготЕІетепІ: 

Для событий «тоизеоѵег» и «тоизеоиі» в модели ІЕ свойство ІтотЕІетепІ: содержит 
ссылку на объект, с которого двигался указатель мыши. В стандартной модели со¬ 
бытий следует использовать свойство геіаііесітагдеі:. 

геасіопіу іпііедег кеуСогіе 

Виртуальный код нажатой клавиши. Это свойство используется всеми типами со¬ 
бытий клавиатуры. Код клавиши может зависеть от броузера, операционной сис¬ 
темы, самой клавиатуры. Обычно, если на клавише изображен печатный символ, 
виртуальный код этой клавиши совпадает с кодом символа. Коды функциональ¬ 
ных клавиш, не соответствующих печатным символам, могут существенно отли¬ 
чаться, тем не менее множество наиболее часто используемых кодов клавиш мож¬ 
но увидеть в примере 17.8. Это свойство не было стандартизовано, но определяется 
всеми броузерами, включая ІЕ. 

геасіопіу Ьооіеап ліеІаКеу 

Признак, показывающий, удерживалась ли клавиша Меіа, когда произошло собы¬ 
тие. Свойство определено для всех типов событий мыши и клавиатуры, а также 
в модели событий ІЕ. 

геасіопіу іпііедег о^зеіХ, о^зеІѴ 

В модели событий ІБ эти свойства определяют координаты, в которых возникло 
событие, в координатной системе элемента-источника события (см. описание свой¬ 
ства згсЕІетепІ). Стандартная модель событий не имеет эквивалентных свойств. 

геасіопіу іпііедег радеХ, радеУ 

Эти нестандартные, но широко поддерживаемые свойства подобны свойствам 
сІіепІіХ и сПепіУ, но вместо системы координат окна используют систему координат 
документа. Эти свойства отсутствуют в модели событий ІЕ, но библиотека і(}иегу 
имитирует их во всех броузерах. 

геасіопіу ЕѵепіТагдеІ: геІаІейТагдеІ* 

Ссылается на элемент (обычно элемент документа), который имеет отношение 
к целевому элементу события. Для событий «тоизеоѵег» это элемент, который по¬ 
кинул указатель мыши при наведении на целевой элемент. Для событий «тоизе¬ 
оиі;» это элемент, на который наводится указатель мыши, когда он покидает целе¬ 
вой элемент. Это свойство отсутствует в модели событий ІЕ, но оно имитируется 
в модели событий і(}иегу. См. также свойства ІтотЕІетепІ: и іоЕІетепІ:, определяе¬ 
мые в модели событий ІЕ. 

Ьооіеап геіигпѴаІие 

Чтобы в модели событий ІЕ предотвратить выполнение действия, предусмотрен¬ 
ного по умолчанию элементом-источником, в котором возникло событие, данное 
свойство следует установить в значение 1"а1зе. В стандартной модели событий сле¬ 
дует использовать метод ргеѵепЮе^аиНО. 
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геасіопіу Іопд зсгеепХ, зсгеепѴ 

Для событий мыши эти свойства определяют координаты указателя мыши отно- # 
сительно верхнего левого угла экрана. Сами по себе эти свойства не используются, 
но они определены во всех типах событий мыши и поддерживаются обеими моде¬ 
лями событий, стандартной и ІБ. 

геасіопіу Ьооіеап зНі**Кеу 

Указывает, удерживалась ли нажатой клавиша 5МП в момент события. Определе¬ 
но для событий мыши и клавиатуры, а также в модели событий ІЕ. 

геасіопіу ЕѵепІТагдеІ: згсЕІешеп* 

В модели событий ІЕ это свойство определяет объект, в котором было сгенерирова¬ 
но событие. В стандартной модели событий вместо этого свойства следует исполь¬ 
зовать свойство 1:а где*. 

геасіопіу ЕѵепіТагдеІ: Іагдеі* 

Целевой объект события, т. е. объект, в котором было сгенерировано событие. (Все 
объекты, которые могут быть целевыми объектами событий, реализуют методы 
интерфейса ЕѵепіТагдеІ:.) Это свойство отсутствует в модели событий ІЕ, но имити¬ 
руется в модели событий і(}иегу. См. также згсЕІетеп*. 

геасіопіу ипзідпесі Іопд *іше8*атр* 

Число, определяющее дату и время, когда произошло событие, или которое можно 
использовать для определения очередности событий. Многие броузеры возвраща¬ 
ют значение времени в секундах, которое можно передать конструктору Оа*е(). Од¬ 
нако в Еігеіох версии 4 и ниже это свойство содержит количество миллисекунд, 
прошедших с момента включения компьютера. Это свойство не поддерживается 
в модели событий ІБ. Модель событий іСіиегу записывает в это свойство значение 
в формате, возвращаемом методом 0а*е.де1:Тіте(). 

Еіетеп* іоЕІетеп* 

Для событий «тоизеоѵег» и «тоизеоиі» в модели событий ІБ содержит ссылку на 
объект, в пределы которого был перемещен указатель мыши. В стандартной моде¬ 
ли событий вместо этого свойства следует использовать свойство ге1а*ес1Тагде1:. 

геасіопіу зігіпд Іуре* 

Тип события, которое представляет данный объект Еѵеп*. Это имя, под которым 
был зарегистрирован обработчик события, или имя свойства обработчика события, 
без префикса «оп». Например, «сііск», «Іоасі» или «зиЬтіі». Это свойство поддер¬ 
живаются обеими моделями событий, стандартной и ІЕ. 

геасіопіу Ѵ\/іпс1о\л/ ѵіеи 

Окно (исторически называется «представлением» («ѵіелѵ»)), в котором было сгене¬ 
рировано событие. Это свойство определено для всех стандартных событий поль¬ 
зовательского интерфейса, таких как события мыши и клавиатуры. Не поддержи¬ 
вается в модели событий ІБ. 

геасіопіу іпііедег ѵЛшеЮеІіа 

Для событий колесика мыши это свойство определяет величину прокрутки по 
оси У. Различные броузеры записывают в это свойство разные значения; подроб¬ 
нее об этом рассказывается в разделе 17.6. Это нестандартное свойство, но оно под¬ 
держивается всеми броузерами, включая ІЕ версии 8 и ниже. 

геасіопіу іпіедег ѵЛіееЮеІІаХ 
геасіопіу іпіедег ѵЛіееЮеИаѴ 

В броузерах, поддерживающих мыши с двумя колесиками, эти события определя¬ 
ют величину прокрутки по осям X и У. Описание, как следует интерпретировать 
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эти свойства, приводится в разделе 17.6. Если определено свойство мМееЮеІіаѴ, оно 
будет содержать то же значение, что и свойство ѵЛіееЮеІіа. 

геасіопіу іпіедег мііісіі 

Это нестандартное, устаревшее свойство поддерживается всеми броузерами, кро¬ 
ме ІЕ, и имитируется в библиотеке іС^иегу. Для событий мыши это еще одно свой¬ 
ство, аналогичное свойству Ьиііоп: значение 1 соответствует левой кнопке, 2 - 
средней кнопке и 3 - правой. Для событий клавиатуры оно получает то же значе¬ 
ние, что и свойство кеуСосІе. 

Методы 

Все следующие методы определены непосредственно в классе Еѵепі, поэтому все они 

доступны в любом стандартном объекте Еѵепі:. 

ѵоісі іпііЕѵепі($ігіпд Туре, Ьооіеап ЬиЬЫез, Ьооіеап сапсеІаЫё) 

Инициализирует свойства іуре, ЬыЬЫез и сапсеІаЫе объекта Еѵепі:. Создать новый 
объект события можно вызовом сгеаіеЕѵепі() объекта Ооситепі, передав ему строку 
«Еѵепі». После инициализации объекта события вызовом этого метода его можно 
послать любому объекту, поддерживающему интерфейс ЕѵепіТагдеі, вызвав метод 
Ьі$раісЬЕѵепі( ) этого объекта. Другие стандартные свойства объекта события (поми¬ 
мо іуре, ЬыЬЫез и сапсеІаЫе) будут инициализированы во время отправки. Если по¬ 
требуется создать, инициализировать и послать более сложное искусственное собы¬ 
тие, необходимо передать методу сгеаіеЕѵепі() другой аргумент (такой как «Моизе- 
Еѵепі») и затем инициализировать полученный объект события с помощью специа¬ 
лизированной функции, такой как іпііМоизеЕѵепіО (не описывается в этой книге). 

ѵоісі ргеѵепіОеіаиГіО 

Сообщает веб-броузеру, чтобы он не выполнял действие по умолчанию для этого 
события, если таковое предусмотрено. Если событие относится к категории неот¬ 
меняемых, вызов этого метода не оказывает никакого влияния. Этот метод отсут¬ 
ствует в модели событий ІЕ, но имитируется библиотекой іС^иегу. В модели собы¬ 
тий ІЕ вместо вызова этого метода следует присваивать значение іаізе свойству 
геіигпѴаІие. 

ѵоісі зіорІттеРіаіеРгорадаііопО 

Действует подобно методу зіорРгорадаііоп(), но, кроме того, предотвращает вызов 
остальных обработчиков, зарегистрированных в этом же элементе документа. 
Этот метод является новым расширением стандартной модели событий, и потому 
может быть реализован не во всех броузерах. Не поддерживается моделью собы¬ 
тий ІЕ, но имитируется библиотекой іС^иегу. 

ѵоісі зіорРгорадаііоп() 

Останавливает распространение события по фазам захвата или всплытия и пере¬ 
дачу его целевому элементу. Этот метод не отменяет вызов других обработчиков 
событий того же узла документа, но предотвращает передачу событий любым дру¬ 
гим узлам. Не поддерживается моделью событий ІЕ, но имитируется библиотекой 
ІСІиегу. В ІЕ вместо вызова метода зіорРгорадаііоп() следует присваивать значение 
ігые свойству сапсеІВиЬЫе. 

Предлагаемые к реализации свойства 

Свойства, перечисленные ниже, предлагаются проектом спецификации «БОМ Ьеѵеі 3 

Еѵепіз». Они должны решить основные проблемы несовместимости между броузера¬ 
ми, но пока (на момент написания этих слов) не реализованы ни в одном из броузеров. 

Если они будут реализованы совместимым способом, это существенно упростит соз- 
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дание переносимого программного кода для обработки событий ввода текста, нажа¬ 
тий клавиш и событий мыши. 

геагіопіу ипзідпесі зПогТ ЬиТТопз 

Напоминает свойство Ьиііоп, поддерживаемое в модели событий ІБ и описанное 
выше. 

геасіопіу зігіпд с&аг 

Для событий клавиатуры это свойство хранит строку символов (т. е. может содер¬ 
жать более одного символа), сгенерированную событием. 

геасіопіу зігіпд <1аТа 

Для событий «Іехііприі» определяет введенный текст. 

геасіопіу ипзідпесі Іопд сІеІІіаНосЗе 

Для событий колесика мыши это свойство определяет соответствующую интер¬ 
претацию свойств сІеІіаХ, йеІіаѴ и сіеііаг. Значением этого свойства может быть од¬ 
на из констант: 00М_0ЕІ_ТА_РІХЕІ_, 00М_0ЕІ_ТА_І_ІМЕ, 00М_0Е1_ТА_РАСЕ. Конкретное значе¬ 
ние определяется платформой и может зависеть от настроек системы или от факта 
удерживания нажатыми клавиш-модификаторов во время возникновения собы¬ 
тия колесика мыши. 

геасіопіу Іопд гіеГСаХ, гіеГСаѴ, (]еГСа2 

Для событий колесика мыши эти свойства определяют величину прокрутки по ка¬ 
ждой из трех осей. 

геасіопіу ипзідпесі Іопд іпригМе'НюсІ 

Для событий «іехііприі» это свойство определяет способ ввода текста. Значением 
этого свойства может быть одна из констант: 00М_ІМРІІТ_МЕТН00_ІІМКМ0ММ, 00М_ІМРІІТ_ 
МЕТНСЮ.КЕУВОАВО, 00М_ІМРІЯ_МЕТНСЮ_РА5ТЕ, 00М_1МР1ГГ_МЕТН(Ю_0В0Р, ООМ_ІМРІЯ_МЕТНСЮ_ІМЕ, 
00М_ІМРиТ_МЕТН00_0РТІ0М, 00М_ІМРиТ_МЕТН00_НАМ0МВІТІМе, 00М_ІМРиТ_МЕТН00_Ѵ0ІСЕ, оом_ 

імрит_мЕтноо_мииімооАі, оом_імрія_метнсю_5Свірт. 

геасіопіу зігіпд кеу 

Для событий клавиатуры, генерирующих символы, это свойство получает то же 
значение, что и свойство сііаг. Для событий клавиатуры, не генерирующих симво¬ 
лы, это свойство содержит имя нажатой клавиши (такое как, «ТаЪ» или «Болѵп»). 

геасіопіу зігіпд іосаіе 

Для событий клавиатуры и событий «іехііприі» это свойство определяет код язы¬ 
ка (например, «еп-ОВ»), идентифицирующий выбранную раскладку клавиатуры, 
если эта информация доступна. 

геасіопіу ипзідпесі Іопд 1оса*іоп 

Для событий клавиатуры это свойство определяет местоположение нажатой кла¬ 
виши. Значением этого свойства может быть одна из констант: 00М_КЕѴ_І_0САТІ0М_ 
ЗТАШВб, 00М_КЕУ_І_0САТІ0М_І_ЕРТ, 00М_КЕУ_І_0САТІ0М_ВІСНТ, ООМ.КЕУ.ЮСАТЮОУМРАО, 00М_ 
КЕУ_І_0САТІ0М_М0ВІІ_Е, 00М_КЕУ_10САТІ0М^0У5ТІСК. 

геасіопіу Ьооіеап гереаі 

Для событий клавиатуры это свойство будет иметь значение ігие, если событие вы¬ 
звано длительным удержанием клавиши в нажатом состоянии, вызвавшем авто¬ 
повтор ввода. 

Предлагаемые к реализации методы 

Подобно предлагаемым к реализации свойствам, перечисленным выше, проектом 
стандарта предлагаются к реализации следующие методы, которые пока не реа¬ 
лизованы ни в одном из броузеров. 
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Ьооіеап де1:Мо<1Шѳг$*а*е(5І:гіпд тодіТіег) 

Для событий мыши и клавиатуры этот метод возвращает {тые, если в момент воз¬ 
буждения события удерживалась нажатой указанная клавиша-модификатор 
тодіТіег , и Шзе - в противном случае. Значением аргумента тосііТіег может быть 
одна из строк: «АИСгарЬ*, «СарвЬоск», «СопігоЬ, «Еп*, «Меіа», «№ітЬоск», 

«8сго1Ь, «8ЬШ*, «8утЪо1Ьоск» и «АУіп». 

ЕѵепіЗоигсе 

Сотеі-соединение с НТТР-сервером ЕѵепІТагдеі 

Объект ЕѵепіЗоигсе представляет долгоживущее НТТР-соединение, посредством кото¬ 
рого веб-сервер может отправлять клиенту текстовые сообщения. Чтобы использо¬ 
вать события, определяемые стандартом «8егѵег-8епі Еѵепіа», следует передать ІЖЬ- 
адрес сервера конструктору ЕѵепіЗоигсеО и затем зарегистрировать обработчик собы¬ 
тия «теваазе» в полученном объекте ЕѵепіЗоигсе. 

Спецификация «8егѵег-8епі Еѵепіб» появилась совсем недавно и на момент написа¬ 
ния этих строк поддерживалась не во всех броузерах. 

Конструктор 

пе\л/ Еѵеп*$оигсѳ(з1:гіпд игі) 

Создает новый объект ЕѵепіЗоигсе, подключенный к веб-серверу, определяемому 
аргументом игі. Адрес игі интерпретируется относительно ІЖЬ-адреса документа. 

Константы 

Следующие константы определяют допустимые значения свойства геаОуЗТаТе. 
ипзідпесі зіюгі: ССШЕСТІИС = О 

Идет установка соединения, или соединение было закрыто и объект ЕѵепіЗоигсе 
пытается восстановить его. 

ипзідпесі зМогТ ОРЕИ = 1 

Соединение установлено и готово к приему событий. 

ипзідпесі зПогі СШЗЕй = 2 

Соединение было закрыто либо вызовом метода с1озе(), либо в результате фаталь¬ 
ной ошибки, не позволяющей восстановить его. 

Свойства 

геасіопіу ипзідпесі зПогі гѳа<1у$*а*е 

Состояние соединения. Возможные значения определяются константами, пере¬ 
численными выше. 

геасіопіу зігіпд игі 

Абсолютный ШІЬ-адрес, к которому подключен объект ЕѵепіЗоигсе. 

Методы 

ѵоісі с1озе() 

Закрывает соединение. После вызова этого метода объект ЕѵепіЗоигсе не может 
больше использоваться. Если потребуется вновь установить соединение, следует 
создать новый объект ЕѵепіЗоигсе. 
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Обработчики событий 

Сетевые взаимодействия выполняются асинхронно, поэтому объект ЕѵепіЗоигсе воз¬ 
буждает события после открытия соединения, при появлении ошибок'и при получе¬ 
нии сообщений от сервера. Обработчики событий можно зарегистрировать с помощьк? 
перечисленных далее свойств или воспользовавшись методами интерфейса Еѵепі- 
Тагдеі. Все события, генерируемые объектом ЕѵепіЗоигсе, посылаются самому объекту 
ЕѵепіЗоигсе. Они не всплывают, и для них не предусмотрены действия по умолчанию, 
которые можно было бы отменить. 

опеггог Вызывается при обнаружении ошибки. Обработчику передается простой 
объект Еѵепі. 

оптеззаде Вызывается при получении сообщения от сервера. Обработчику передает¬ 
ся объект события МеззадеЕѵепІ, а текст, отправленный сервером, досту¬ 
пен через свойство сіаіа этого объекта. 

о по реп Вызывается при открытии соединения. Обработчику передается простой 

объект Еѵепі:. 

ЕѵепІТагдеІ 

объект, способный принимать события 

Объекты, для которых генерируются события, и объекты, которые находятся на пути 
всплывающих событий, должны предоставлять возможность определять обработчи¬ 
ки этих событий. Такие объекты обычно определяют свойства обработчиков событий, 
имена которых начинаются с префикса «оп» и, как правило, определяют методы, 
описываемые ниже. Регистрация обработчиков событий - поразительно сложная те¬ 
ма. За подробностями обращайтесь к разделу 17.2 и обратите внимание, что ІБ версии 
8 и ниже использует другие методы, чем все остальные броузеры; эти методы будут 
описаны в специальном разделе ниже. 

Методы 

ѵоісі а<1<1ЕѵепШ.5Іепег(5Ігіпд Туре , Іипсііоп 1ізТепег \Ьооіеап изеСарТиге ]) 

Регистрирует функцию ІізТепег в качестве обработчика событий типа Туре. Аргу¬ 
мент Туре - строка с именем без префикса «оп». Аргумент изеСарТиге должен иметь 
значение 1:гие, если регистрируется перехватывающий обработчик (раздел 17.2.3) 
в предке элемента, являющегося истинной целью события. Обратите внимание, 
что некоторые броузеры все еще требуют передачи этой функции третьего аргу¬ 
мента, поэтому при регистрации обычного, неперехватывающего, обработчика 
в третьем аргументе следует передавать Іаізе. 

Ьооіеап <1і5раІс&Еѵеп1(Еѵепі еѵепТ) 

Отправляет данному элементу искусственное событие еѵепТ. Чтобы отправить со¬ 
бытие, необходимо создать новый объект Еѵепі: вызовом метода сіоситепі.сгеаіе- 
Еѵеп1() с именем события (таким как «Еѵепіз», в случае простого события). Затем 
инициализировать его методом инициализации созданного объекта Еѵепі: для 
простых событий - вызовом метода іпііЕѵепіО (см. Еѵепі). После этого отправить 
инициализированное событие, передав его рассматриваемому методу. В современ¬ 
ных броузерах каждый объект Еѵепі имеет свойство ізТгизІесі. Для искуственных 
событий, посылаемых программно, это свойство будет иметь значение Іаізе. 

Различные типы объектов событий определяют собственные методы инициализа¬ 
ции. Эти методы редко используются на практике, имеют длинные списки аргу¬ 
ментов и не описываются в этой книге. Если вам потребуется создать, инициали- 
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зировать и послать искуственное событие, более сложное, чем простой объект 
Еѵепі, поищите описание соответствующего метода инициализации в электронной 
документации. 

ѵоісі гетоѵеЕѵѳпіІ_ізіепег(5ігіпд Туре, іітсііоп ІізТепег, [Ьооіеап изеСарТиге ]) 

Удаляет зарегистрированный обработчик ІізТепег события. Принимает те же ар¬ 
гументы, что и метод ас!с1ЕѵепіІ_і5іепег(). 

Методы Іпіегпеі Ехріогег 

ІЕ версии 8 и ниже не поддерживает методы ас!сІЕѵепіІ_і 5 іепег() и гетоѵеЕѵепіІ_ізіепег(). 
Вместо них он реализует два более простых метода, которые описываются ниже. (Не¬ 
которые важные отличия перечислены в разделе 17.2.4.) 

ѵоісі аііас&Еѵепі(зігіпд Туре, іипсііоп ІізТепег) 

Регистрирует функцию ІізТепег как обработчик событий типа Туре. Обратите вни¬ 
мание, что этот метод требует, чтобы имя в аргументе Туре включало префикс «оп». 

ѵоісі <1ѳіасЬЕѵепі(зігіпд Туре, іипсііоп ІізТепег ) 

Этот метод действует как обратный методу аііасЬЕѵепі( ). 

РіеІсІЗеІ 

элемент <ПеІсІ$еі> в НТМЬ-формах Ыосіе, Еіетепі, РогтСопІгоІ 

Объект РіеІсІЗеІ представляет элемент <ііе1сІ5еі> в НТМЬ-формах <іогт>. Объекты 
РіеІсІЗеІ реализуют многие, но не все свойства и методы интерфейса РогтСопігоІ. 

Свойства 

Ьооіеап (ІізаЫесІ 

Значение ігие, если объект РіеІсІЗеІ: находится в неактивном состоянии. Деактива¬ 
ция элемента РіеІсІЗеІ: деактивирует содержащиеся в нем элементы форм. 

геасіопіу НТМІ_РогтСопіго1зСо11есііоп еіетепіз 

Объект, подобный массиву, содержащий все элементы форм, имеющиеся внутри 
тега <ііе1сІ5еі>. 

Рііе 

файл в локальной файловой системе ВІоЬ 

Тип Рііе является подтипом ВІоЬ. Объект Рііе имеет имя и, возможно, дату последнего 
изменения. Он представляет файл в локальной файловой системе. Получить выбран¬ 
ный пользователем файл можно из массива іііез элемента <іприі іуре=іі1е> или из 
массива іііез объекта ОаіаТгапзіег, связанного с объектом Еѵепі, который получает об¬ 
работчик события «бгор». 

Имеется также возможность получить объекты Рііе, представляющие файлы в за¬ 
крытой, изолированной файловой системе, как описано в разделе 22.7. Однако на мо¬ 
мент написания этих строк прикладной интерфейс доступа к файловой системе оста¬ 
вался нестабильным, поэтому он не описывается в этом справочнике. 

Содержимое файла можно выгрузить на сервер с помощью объекта РоггтЮаіа или пере¬ 
дав объект Рііе методу ХМІ_НіірВедиезі.зепс1(), однако непосредственно с объектом Рііе 
можно выполнить не очень много операций. Чтобы прочитать содержимое файла, 
следует использовать объект РіІеВеасІег (или любой объект ВІоЬ). 
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Свойства 

геасіопіу йаіе ІазіМойіііесЮаіе 

Дата последнего изменения файла или пи 11 , если эта информация недоступна, 
геасіопіу зігіпд паше 

Имя файла (без пути к нему). 

РіІеЕггог 

ошибка, возникшая во время чтения файла 

Объект РіІеЕггог представляет ошибку, возникшую при чтении файла с помощью объ¬ 
екта РіІеВеасІег или РіІеВеасІегЗупс. Если использовался синхронный прикладной ин¬ 
терфейс, возбуждается непосредственно объект РіІеЕггог. При использовании асин¬ 
хронного прикладного интерфейса объект РіІеЕггог передается обработчику в виде 
значения свойства еггог объекта РіІеВеасІег. 

Обратите внимание, что прикладной интерфейс объекта Рііеіл/гііег (который описывает¬ 
ся в разделе 22.7, но пока остается недостаточно стабильным, чтобы его можно было опи¬ 
сать в этом справочнике) добавляет в этот объект новые константы с кодами ошибок. 

Константы 

Ниже перечислены коды ошибок в объекте РіІеЕггог: 
ипзідпесі зіюгі М0Т_Р(Ш0_ЕВВ = 1 

Файл не существует. (Возможно, был удален после того, как пользователь выбрал 
его, но перед тем, как программа попыталась прочитать его.) 

ипзідпесі зіюгі $ЕСІ)ВІТѴ_ЕВВ = 2 

Неопределенная проблема, связанная с безопасностью, вынуждающая броузер за¬ 
претить вашей программе читать файл. 

ипзідпесі зіюгі: АВ0ВТ_ЕВВ = 3 

Операция чтения файла была прервана, 
ипзідпесі зіюгі: М0Т_ВЕА0АВ1.Е_ЕЯВ = 4 

Файл недоступен для чтения, возможно, потому что изменились права доступа 
к нему или другой процесс заблокировал файл. 

ипзідпесі зіюгі ЕШЮШз_ЕВЯ = 5 

Вызов геасІАзОаіаІІВЦ ) потерпел неудачу, потому что файл оказался слишком длин¬ 
ным, чтобы представить его в виде ІШЬ-адреса сіаіа://. 

Свойства 

геасіопіу ипзідпесі зіюгі сойе 

Это свойство определяет тип возникшей ошибки. Это свойство получает значение 
одной из констант, перечисленных выше. 

РіІеВеасІег 

асинхронный интерфейс чтения объекта Рііе или ВІоЬ ЕѵепіТагдеі 

Объект РіІеВеасІег определяет асинхронный прикладной интерфейс чтения содержи¬ 
мого объекта Рііе или любого объекта ВІоЬ. Чтобы прочитать файл, следует выпол¬ 
нить следующие действия: 

• Создать объект РіІеВеасІег вызовом конструктора Рі1еВеасІег( ). 
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• Определить необходимые обработчики событий. 

• Передать объект Рііе или ВІоЬ одному из четырех методов чтения. 

• Затем, когда будет вызван обработчик опіоасі, содержимое файла будет доступйЪ 
в свойстве гезиіі. Или, если будет вызван обработчик опеггог, свойство еггог будет 
ссылаться на объект РіІеЕггог, содержащий дополнительную информацию. 

• После окончания операции чтения при необходимости можно повторно использо¬ 
вать объект РіІеВеасІег или удалить его и создать новый. 

Синхронный прикладной интерфейс, который можно использовать в фоновых пото¬ 
ках выполнения, описывается в справочной статье РіІеВеасІегЗупс. 

Конструктор 

пе\л/ РПеВеагіегО 

Новый объект РіІеВеасІег создается с помощью конструктора РПеВеас1ег(), который 
не требует аргументов. 

Константы 

Следующие константы определяют возможные значения свойства геасІуЗіаіе: 
ипзідпесі зЬогІ: ЕНРТѴ = О 

Метод чтения еще не был вызван, 
ипзідпесі зЬогІ: ЮАРІИС = 1 

Выполняется операция чтения, 
ипзідпесі зИогТ РОИЕ = 2 

Операция чтения завершилась, успешно или с ошибкой. 

Свойства 

геасіопіу РіІеЕггог ѳггог 

Если ошибка возникнет во время чтения, это свойство будет ссылаться на объект 
РіІеЕггог, описывающий ошибку. 

геасіопіу ипзідпесі зПогі геаЬуВіаіе 

Это свойство описывает текущее состояние объекта РіІеВеасІег. Его значением бу¬ 
дет одна из трех констант, перечисленных выше. 

геасіопіу апу гезиіг 

Если операция чтения завершится успешно, это свойство будет хранить содержи¬ 
мое объекта Рііе или ВІоЬ в виде строки или объекта АггауВиііег (в зависимости от 
использовавшегося метода чтения). Когда свойство геасІуЗіаііе имеет значение 
ЮАОІМС или когда возбуждается событие «рго^гезз», это свойство может хранить 
неполное содержимое объекта Рііе или ВІоЬ. Если метод чтения еще не был вызван 
или если возникла ошибка, это свойство будет иметь значение пиіі. 

Методы 

ѵоісі аЬогіО 

Прерывает операцию чтения. Он присваивает свойству геасІуЗіаіе значение 0(Ж, 
свойству гезиіі - значение пиіі и свойству еггог - объект РіІеЕггог со свойством 
сосіе, установленным в значение РіІеЕггог. АВ0ВТ_ЕВВ. После этого возбуждаются со¬ 
бытия «аЪогі» и «Іоасіеші». 
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ѵоісі геа<1АзАггауВиііег(В1оЬ ЫоЬ) 

Асинхронно читает данные из объекта ЫоЬ и сохраняет их в свойстве гезыИ: в виде 
объекта АггауВиііег. 

ѵоісі гѳа<1АзВіпагу$ігіпд(В1оЬ ЫоЬ) 

Асинхронно читает байты данных из объекта ЫоЬ 9 преобразует их в двоичную 
строку и сохраняет ее в свойстве гезиіі. Каждый «символ» в двоичной строке пред¬ 
ставлен кодом символа в диапазоне от 0 до 255. Извлекать эти значения байтов 
можно с помощью метода 5ігіпд.сІіагСосіеАі(). Следует отметить, что двоичные 
строки являются не самым эффективным представлением двоичных данных: вме¬ 
сто них следует использовать объекты АггауВиііег, когда это возможно. 

ѵоісі геасІАзВаіаІІВЦВІоЬ ЫоЬ) 

Асинхронно читает байты данных из объекта ЫоЬ 9 преобразует их (учитывая тип 
объекта ВІоЬ) в ІЖЬ-адрес сіаіа :// и присваивает полученную строку свойству гезиіі:. 

ѵоісі геа<1А5Техі(В1оЬ ЫоЬ , [зігіпд епсосііпд ]) 

Асинхронно читает байты данных из объекта ЫоЬ 9 декодирует их с использовани¬ 
ем кодировки епсосііпд в текстовую строку Юникода и затем присваивает получен¬ 
ную строку свойству гезиіі:. Если аргумент епсосііпд не указан, используется коди¬ 
ровка ІІТГ-8 (текст в кодировке ІІТГ-16 определяется и декодируется автоматиче¬ 
ски, если он начинается с маркера Вуіе Огсіег Магк). 

Обработчики событий 

Подобно всем асинхронным прикладным интерфейсам, в своей работе объект РіІеВе- 
асіег опирается на события. Для регистрации обработчиков событий можно использо¬ 
вать свойства, перечисленные ниже, или методы интерфейса ЕѵепіТагдеі, реализуемо¬ 
го объектом РіІеВеасІег. 

События объекта РіІеВеасІег возбуждаются в самом объекте РіІеВеасІег. Они не всплы¬ 
вают, и для них не предусматриваются действия по умолчанию. Обработчикам собы¬ 
тий в объекте РіІеВеасІег всегда передается объект РгодгеззЕѵепі. Успешная операция 
чтения начинается с события «Іоасізіагі», за которым следует ноль или более событий 
«рго^гезз», событие «Іоасі» и событие «Іоасіепсі». Неудачная операция чтения начина¬ 
ется с события «Іоасізіагі», за которым следует ноль или более событий «рго&гезз», 
событие «еггог» или «аЪогі» и событие «Іоасіепсі». 

опаЬогі 

Вызывается, если операция чтения была прервана методом аЬогі(). 
опеггог 

Вызывается, если возникла какая-либо ошибка. Свойство еггог объекта РіІеВеасІег 
будет ссылаться на объект Рііе Еггог, который имеет свойство сосіе с кодом ошибки. 

опіоасі 

Вызывается в случае успешного завершения операции чтения объекта Рііе или 
ВІоЬ. Свойство гезиіі объекта РіІеВеасІег хранит содержимое объекта Рііе или ВІоЬ 
в виде, зависящем от использовавшегося метода чтения. 

опіоасіепсі 

Каждый вызов метода чтения объекта РіІеВеасІег в конечном итоге возбуждает со¬ 
бытие «Іоасі», «еггог» или «аЪогі». Кроме того, после каждого из этих событий объ¬ 
ект РіІеВеасІег возбуждает событие «Іоасіепсі» для программ, в которых было бы же¬ 
лательно обрабатывать единственное событие вместо трех. 
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опіоасізіагі: 

Вызывается после вызова метода чтения, но перед тем как будут прочитаны ка¬ 
кие-либо данные. 

опргодгезз 

Возбуждается примерно 20 раз в секунду, пока выполняется чтение данных из 
объекта Рііе или ВІоЬ. Объект РгодгеззЕѵепІ: позволяет узнать количество прочитан¬ 
ных байтов, а свойство гезиіі: объекта РіІеВеасІег может содержать представление 
этих байтов. 

РіІеВеасІегЗупс 

синхронный интерфейс чтения объекта Рііе или ВІоЬ 

Объект РіІеВеасІегЗупс является синхронной версией объекта РіІеВеасІег, доступной толь¬ 
ко в фоновых потоках выполнения, представленных объектами Іл/огкег. Синхронный 
интерфейс проще в использовании, чем асинхронный: достаточно просто создать объ¬ 
ект вызовом конструктора Рі1еВеас1ег5упс( ) и затем вызвать один из его методов чтения, 
который либо вернет содержимое объекта Рііе или ВІоЬ, либо возбудит объект РіІеЕггог. 

Конструктор 

пе\л/ Рі1еВеас1ег5упс() 

Новый объект РіІеВеасІегЗупс создается с помощью конструктора Рі1еВеас1ег5упс(), 
который не требует аргументов. 

Методы 

Следующие методы возбуждают объект РіІеЕггог, если операция чтения потерпит не¬ 
удачу по каким-либо причинам. 

АггауВиіРег гѳа<1АзАггауВи^ег(В1оЬ ЫоЬ) 

Читает байты из объекта ЫоЬ и возвращает их в виде объекта АггауВиРРег. 
зігіпд геа<1АзВіпагу$ггіпд(В1оЬ ЫоЬ) 

Читает байты из объекта ЫоЬ , преобразует их в двоичную строку (Зігіпд.ІтотСЬаг- 
СосіеО) и возвращает ее. 

зігіпд геасІАзВаТаІЖЦВІоЬ ЫоЬ) 

Читает байты из объекта ЫоЬ 9 преобразует их с учетом свойства іуре объекта ЫоЬ 
в ІЖЬ-адрес сіаіа:// и возвращает его. 

зігіпд геа(1АзТехг(В1оЬ ЫоЬ, [зігіпд епсобіпд ]) 

Читает байты данных из объекта ЫоЬ 9 декодирует их с использованием кодировки 
епсосііпд (или с использованием кодировки ІІТГ-8 или ІІТГ-16, если аргумент епсо¬ 
біпд не указан) и возвращает полученную строку. 

Рогт 

тег <{огт> в НТМЬ-д оку менте Иосіе, Еіетепі 

Объект Рогт представляет элемент <?огт> в НТМЬ-документе. Свойство еіетепіз - это 
объект НТМЮоІІесііоп, который дает удобный доступ ко всем элементам в форме. Мето¬ 
ды зііЬтііО и гезеіО позволяют программным способом отправлять данные формы 
или сбрасывать все элементы формы в значения, предлагаемые по умолчанию. 

Каждая форма в документе представлена элементом массива с!оситепі:.іогтз[]. Элемен¬ 
ты формы (кнопки, поля ввода, переключатели и т. д.) собраны в объекте Рогт. еіетепіз, 
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подобном массиву. К именованным элементам форм можно обращаться непосредст¬ 
венно по имени - имя элемента выступает в качестве имени свойства объекта Гогт. 
Другими словами, обратиться к элементу ІприТ со значением «рЬопе» в свойстве пате- 
в форме Т можно посредством ^ѵа8сгірІ-выражения Т. рГіопе. 

Подробнее об НТМЬ-формах рассказывается в разделе 15.9. Кроме того, дополнитель¬ 
ную информацию об элементах форм можно найти в справочных статьях РогтСопТгоІ, 
РіеІсіЗеІ:, Іприі:, І_аЬе1, Зеіесі: иТехТАгеа. 

Данная справочная статья описывает некоторые особенности форм, определяемые 
спецификацией НТМЬ5, которые на момент написания этих строк были реализованы 
не во всех броузерах. 

Свойства 

Большинство свойств, перечисленных ниже, просто соответствуют НТМЬ-атрибутам 
с теми же именами. 

зігіпд ассеріСИагзеІ 

Список из одного или более допустимых кодировок символов, которые могут ис¬ 
пользоваться для кодирования данных формы при отправке. 

зігіпд асііоп 

ІШЬ-адрес, по которому должна быть отправлена форма, 
зігіпд аиіосотріеіе 

Строка «оп» или «о іі*. Если содержит строку «оп», броузер будет предварительно 
заполнять элементы формы значениями, сохраненными при предыдущем посеще¬ 
нии страницы. 

геасіопіу НТМІРогтСопітоІзСоІІесІііоп ѳіѳтепіз 

Объект, подобный массиву, содержащий элементы формы, 
зігіпд епсіуре 

Определяет способ кодирования значений элементов формы при отправке. Допус¬ 
тимыми значениями являются: 

• «арр1ісаііоп/х-\ѵ\ѵ\ѵ-:Гогт-иг1епсо(1е(Ь (по умолчанию) 

• «ти1іірагіДогт-(1аІа» 

• «іехі/ріаіп» 

геасіопіу Іопд 1епд{Ь 

Количество элементов формы, представляемых свойством е1етеп1:з. Формы дейст¬ 
вуют, как если бы они сами были объектами, подобными массивам, содержащими 
элементы форм, поэтому для формы Т и целого числа п выражение Р[п] будет экви¬ 
валентно выражению ?.е1етепіз[п]. 

зігіпд тегінхі 

НТТР-метод отправки формы по ШІЬ-адресу в свойстве ас1:іоп. Может иметь зна¬ 
чение «|ге1» или «розі». 

зіігіпд пате 

Имя формы, определяемое НТМЬ-атрибутом пате. Значение этого свойства можно 
использовать в качестве имени свойства объекта документа, значением которого 
будет данный объект Рогт. 

Ьооіеап поѴаІіЛаіѳ 

Значение 1 гие, если форма не должна проверяться перед отправкой. Соответствует 
НТМЬ-атрибуту поѵаіісіаіе. 
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зігіпд іагде* 

Имя окна или фрейма, где должен отображаться документ, возвращаемый в ответ 
на выполнение операции отправки формы. 

Методы 

Ьооіеап сйескѴаІісІііу () 

В броузерах, поддерживающих возможность проверки форм, этот метод проверяет 
корректность введенных данных в каждом элементе формы. Он возвращает Тгие, 
если все данные корректны. Если какой-либо элемент управления содержит недо¬ 
пустимые данные, он возбуждает событие «іпѵаІісЬ в этом элементе формы и воз¬ 
вращает іаізе. 

ѵоісі (ІізраісНРогтСНапдеО 

Возбуждает событие «?огтсЬап&е» в каждом элементе данной формы. Обычно это 
делается автоматически, когда действия пользователя приводят к возбуждению 
события «сЬап&е», поэтому вызывать этот метод обычно не требуется. 

ѵоісі йізраШіРогтІпрігіО 

Возбуждает событие «Іогтіприі* в каждом элементе данной формы. Обычно это 
делается автоматически, когда действия пользователя приводят к возбуждению 
события «іприі», поэтому вызывать этот метод обычно не требуется. 

ѵоісі гезе*() 

Сбрасывает все элементы ввода формы к их значениям по умолчанию, 
ѵоісі зиЬтііО 

Выполняет отправку формы вручную, не возбуждая событие «зиЪпгіі». 

Обработчики событий 

Следующие обработчики событий, связанные с формами, определены в объекте 
Еіеглепі:, но описываются здесь, потому что возбуждаются в элементах Рогт. 

опгезеі 

Вызывается непосредственно перед тем, как форма будет сброшена в исходное со¬ 
стояние. Чтобы предотвратить сброс, обработчик может вернуть іаізе или отме¬ 
нить событие. 

опзыЬтіі 

Вызывается непосредственно перед отправкой формы. Чтобы предотвратить от¬ 
правку, обработчик может вернуть Іаізе или отменить событие. 

РогтСопігоІ 

общие особенности всех элементов форм 

Большинство элементов НТМЬ-форм являются элементами <іприі>, но формы могут 
также содержать элементы <Ьиі1:оп>, <зе1есі> и <іехіагеа>. Данная справочная статья 
описывает общие особенности всех этих элементов. Введение в НТМЬ-формы приво¬ 
дится в разделе 15.9, а дополнительную информацию о формах и об элементах форм 
можно найти в справочных статьях Рогт, Іприі, Зеіесі и ТехіАгеа. 

Элементы <Ііе1с1зеі> и <оиіриі> реализуют большинство, но не все, свойства, описы¬ 
ваемые здесь. Данный справочник классифицирует объекты РіеІсІЗеі и Оиіриі как под¬ 
типы объекта РогтСопігоІ, хотя они реализуют не все свойства. 
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Данная справочная статья описывает некоторые особенности форм (такие как про¬ 
верка данных формы), введенные спецификацией НТМЬб, которые на момент напи¬ 
сания этих строк были реализованы не во всех броузерах. 

Свойства 

Ьооіеап аиРоРосиз 

Значение Ргие, если элемент должен автоматически получать фокус ввода сразу 
после загрузки документа. (Элементы РіеІсІЗеІ: и ОиРриР не реализуют это свойство.) 

Ьооіеап йізаЫей 

Значение Ргие, если элемент формы находится в неактивном состоянии. Неактив¬ 
ные элементы не откликаются на ввод пользователя и не подвергаются проверке. 
(Элементы ОиТриТ не реализуют это свойство; элементы РіеІсІЗеІ: используют его для 
управления активностью всех элементов, содержащихся в них.) 

геасіопіу Рогт Рогт 

Ссылка на элемент Рогт, который является владельцем данного элемента, или пиіі, 
если таковой отсутствует. Если элемент формы находится внутри элемента <Рогт>, 
эта форма является его владельцем. В противном случае, если элемент формы 
имеет НТМЬ-атрибут Рогт, определяющий значение атрибута ісі элемента <Рогт>, 
владельцем элемента будет указанная форма. 

геасіопіу МосІеИзР ІаЬеІз 

Объект, подобный массиву, содержащий элементы 1_аЬе1, связанные с элементами 
этой формы. (Объекты РіеІсІЗеІ: не реализуют это свойство.) 

зРгіпд паше 

Значение НТМЬ-атрибута пате для данного элемента формы. Имена элементов форм 
можно использовать в качестве имен свойств элемента Рогт: значениями таких 
свойств являются элементы форм. Имена элементов форм также можно использо¬ 
вать для идентификации данных при отправке формы. 

зРгіпд Руре 

Для элементов <іприр> свойство Руре имеет значение атрибута Руре или значение 
«іехі», если атрибут Руре не указан в теге <іприр>. Для элементов <ЬиРРоп>, <зе1есР> 
и <РехРагеа> свойство Руре имеет значение «Ъиііоп*, «зеіесі-опе* (или «зеІесі-тиШр- 
1е», если установлен атрибут тиіріріе) и «іехіагеа», соответственно. Для элементов 
<Ріе1с1зеР> свойство Руре имеет значение «Ріеіеізеі», а для элементов <оиРриР> - значе¬ 
ние «оиіриі*. 

геасіопіу зРгіпд ѵаШаРіопМеззаде 

Если элемент формы содержит допустимые данные или не подвергается проверке, 
это свойство будет содержать пустую строку. Иначе это свойство будет содержать 
локализованную строку, описывающую причину, по которой введенные данные 
признаны некорректными. 

геасіопіу РогтѴаІісІіРу ѵаіійіру 

Это свойство ссылается на объект, который определяет корректность даных в этом 
элементе формы и описывает причину, если данные признаны некорректными. 

зРгіпд ѵаіие 

Каждый элемент формы имеет строковое свойство ѵаіие, которое используется при 
отправке формы. Для текстовых элементов форм значением этого свойства явля¬ 
ется текст, введенный пользователем. Для кнопок- значение НТМЬ-атрибута 
ѵаіие. Для элементов ОиРриР это свойство подобно свойству РехРСопРепР, унаследо¬ 
ванному от объекта Иосіе. Элементы РіеІсІЗеР не реализуют это свойство. 
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геасіопіу Ьооіеап міПѴаІійаіе 

Это свойство имеет значение 1:гие, если элемент формы подвергается проверке, 
и 'Раізе - в противном случае. 

Обработчики событий 

Элементы форм определяют следующие свойства обработчиков событий. Обработчи¬ 
ки можно также регистрировать с помощью методов интерфейса ЕѵепіТагдеІ:, который 
реализуют все элементы: 


Обработчик событий Когда вызывается 

опІхгтсЬапде Когда в любом элементе формы возбуждается событие «сЬапзе», 

форма рассылает невсплывающее событие «іогшсЬап^е» всем сво¬ 
им элементам. Элементы форм могут использовать это свойство 
для определения факта изменений в соседних элементах формы. 


оп^огтіпріЦ 


Когда в любом элементе формы возбуждается событие «іприі», 
форма рассылает невсплывающее событие «іогтіприі» всем своим 
элементам. Элементы форм могут использовать это свойство для 
определения факта изменений в соседних элементах формы. 


опіпѵаіісі 


Если в ходе проверки выяснится, что элемент формы содержит не¬ 
корректные данные, в нем будет возбуждено событие «іпѵаіісі*. Это 
событие не всплывает, но если его отменить, броузер не выведет со¬ 
общение об ошибке для этого элемента. 


Методы 

Ьооіеап сЬескѴаІісІіІіу () 

Возвращает Тгие, если элемент формы содержит корректные данные (или если этот 
элемент не подвергается проверке). Иначе возбуждает событие «іпѵаііси в данном 
элементе и возвращает Шзе. 

ѵоісі зеіСизІотѴа1і(1і1у(з1:гіпд еггог) 

Если в аргументе еггог передать непустую строку, этот метод пометит данный эле¬ 
мент формы как содержащий недопустимые данные и будет использовать аргу¬ 
мент еггог как локализованное сообщение, чтобы известить пользователя о причи¬ 
нах. Если передать в аргументе еггог пустую строку, все предыдущие строки еггог 
будут удалены, а объект будет помечен как содержащий допустимые данные. 

РогпгЮага 

тело НТТР-запроса ти№раг1/й>гт-с1а1а 

Тип РогтОаІа является частью спецификации «ХМЬНМрКециезі Ьеѵеі 2» (ХНК2), ко¬ 
торая упрощает отправку данных в формате «тиІІірагіДогт-сІаІа» в виде НТТР-за- 
просов РИТ с помощью объекта ХМЬНирВедиезІ:. Использование этого формата необхо¬ 
димо, например, когда в одном запросе требуется выгрузить несколько объектов Рііе. 

Создайте объект РогтОаІа с помощью конструктора и затем добавьте в него пары имя/ 
значение с помощью метода аррепсК). После того как будут добавлены все части, со¬ 
ставляющие тело запроса, объект РогтОаІа можно передать методу зепсЗО объекта 
ХМЫН1:1:рПедиез1:. 
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Конструктор 

пем РогпШаТаО 

Этот конструктор, не имеющий аргументов, возвращает пустой объект Рогтйаііа. * 

Методы 

ѵоісі аррепсКзІігіпд пате , апу ѵаіие) 

Добавляет в объект РогтйаТа новую часть с именем пате и значением ѵаіие. Аргу¬ 
мент ѵаіие может быть строкой или объектом ВІоЬ (напомню, что тип Рііе является 
подтипом ВІоЬ). 

РогтѴаІісІіІу 

реализует проверку элемента формы 

Свойство ѵаіісііііу объекта РогтСопіігоІ ссылается на объект РогтѴаІісІіІіу, который явля¬ 
ется представлением признака корректности данных в этом элементе формы. Если 
свойство ѵаіісі имеет значение Шзе, элемент формы содержит недопустимые данные 
и по крайней мере одно из других свойств, определяющих природу ошибки (или оши¬ 
бок), будет иметь значение ігие. 

Проверка форм является особенностью, введенной спецификацией НТМЬб, которая 
на момент написания этих строк была реализована не во всех броузерах. 

Свойства 

геасіопіу Ьооіеап сизіотЕггог 

Сценарий вызвал метод РогтСопіігоІ.зеТСизТотѴаІісЛТуС ) данного элемента, 
геасіопіу Ьооіеап раііегпМізтаісЬ 

Введенные данные не соответствуют регулярному выражению, 
геасіопіу Ьооіеап гапдеОѵегНом 

Объем введенных данных слишком велик, 
геасіопіу Ьооіеап гапдеІІпсІегИсм 

Объем введенных данных слишком мал. 
геасіопіу Ьооіеап зіерМізтаісЬ 

Введенные данные не соответствуют указанному шагу, 
геасіопіу Ьооіеап 1ооІ_опд 

Объем введенных данных слишком велик, 
геасіопіу Ьооіеап іуреМізтаісІі 

Введенные данные имеют неверный тип. 
геасіопіу Ьооіеап ѵаіісі 

Если это свойство имеет значение ігие, элемент формы содержит корректные дан¬ 
ные и все другие свойства имеют значение Шзе. Если это свойство имеет значение 
Раізе, элемент формы содержит недопустимые данные и, по крайней мере, одно из 
других свойств имеет значение ігие. 

геасіопіу Ьооіеап ѵаІііеМіззіпд 

Элемент формы пуст, хотя он должен быть заполнен. 
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6еосоогсііпаІе$ 

географическое местонахождение 

Объект этого типа является представлением точки на поверхности Земли. 

Свойства 

геасіопіу сІоиЫе ассигасу 

Точность определения широты и долготы (свойства ІаТіТисІе и ІопдіТисЗе) в метрах, 
геасіопіу сІоиЫе аШіийе 

Высота над уровнем моря в метрах или піЛ1, если информация о высоте недоступна, 
геасіопіу сІоиЫе аШіийеАссигасу 

Точность определения высоты (свойство а 11: іі и сіе) над уровнем моря в метрах. Если 
свойство аІШисІе имеет значение пыіі, свойство аІІіІіисІеАссигасу также будет иметь 
значение пиіі. 

геасіопіу сІоиЫе Неайіпд 

Направление движения пользователя в градусах относительно направления на 
истинный север или пиіі, если информация о направлении недоступна. Если ин¬ 
формация о высоте доступна, но скорость (свойство 8реей) движения равна нулю, 
то свойство Реайіпд будет иметь значение 

геасіопіу йоиЫе Іаіііікіе 

Широта местоположения пользователя в градусах с долями к северу от экватора, 
геасіопіу йоиЫе Іопдііийе 

Долгота местоположения пользователя в градусах с долями к востоку от Гринвич¬ 
ского меридиана. 

геасіопіу йоиЫе 8реей 

Скорость движения пользователя в метрах в секунду или пиіі, если информация 
о скорости недоступна. Это свойство никогда не принимает отрицательные значе¬ 
ния. См. также Пеайіпд. 

Сеоіосайоп 

позволяет получить широту и долготу местоположения пользователя 

Объект Оеоіосаііоп определяет методы, позволяющие получить точные географиче¬ 
ские координаты местоположения пользователя. В броузерах, поддерживающих та¬ 
кую возможность, объект Оеоіосаііоп можно получить через объекта №ѵіда1:ог, обра¬ 
тившись к свойству паѵідаіог.деоіосаііоп. Методы, описываемые ниже, опираются на 
использование некоторых других типов: местоположение определяется в форме объ¬ 
екта Оеорозіііоп, а ошибки - в форме объектов СеоІосаііопЕггог. 

Методы 

ѵоій с1еагМаісИ(1опд и/аіісііісі) 

Останавливает слежение за местонахождением пользователя. В аргументе іѵаГс/?Іс( 
должно передаваться значение, полученное соответствующим вызовом метода 

ѵу/а1сПРо5і1:іоп(). 

ѵоій деіСиггепІРозіІіоп^ипсііоп зиссезз, [ГипсТіоп еггог ], [ой^есі: орііопз]) 

Асинхронно определяет местонахождение пользователя с учетом параметров 
ортіопз (перечень свойств объекта орТіоп приводится ниже). Этот метод немедленно 
возвращает управление, а когда местонахождение пользователя будет определено. 
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указанной функции обратного вызова зиссезз будет передан объект СеорозШоп. 
Или в случае ошибки (возможно из-за того, что пользователь не дал разрешение на 
определение его координат) функции обратного вызова еггог будет передан объект 

СеоІосаТіопЕггог. 

Іопд иаТсИРозіТіоп^ипсТіоп зиссезз, [^ипсТіоп еггог], [окрест орИопз ]) 

Этот метод похож на метод деТСиг гепТРозі1:іоп( ), но после определения текущего ме¬ 
стонахождения пользователя он продолжает следить за его координатами и вызы¬ 
вает функцию зиссезз каждый раз, когда обнаружит существенное их изменение. 
Возвращает число, которое можно передать методу с1еагИаі:сГі(), чтобы остановить 
слежение за местонахождением пользователя. 

Параметры 

Аргумент орііопзу передаваемый методам де1:Сиггеп1:Розі1:іоп() и ѵѵаІісІіРозШопО, явля¬ 
ется обычным объектом, содержащим ноль или более свойств из числа следующих: 

Ьооіеап епаЬІеНідИАссигасу 

Этот параметр говорит о желательности определения координат с высокой точно¬ 
стью, даже если это повлечет увеличение расхода энергии в аккумуляторах. По 
умолчанию имеет значение ^аізе. В устройствах, способных определять местона¬ 
хождение посредством измерения мощности сигналов 'ЭДіРі или с помощью СР8, 
установка этого параметра в значение Ше обычно означает «использовать ОР8». 

Іопд тахіітлпАде 

Этот параметр определяет максимальное время (в миллисекундах), прошедшее с то¬ 
го момента, как объект СеорозШоп был передан функции обратного вызова зиссезз. 
По умолчанию имеет значение 0, т.е. каждый вызов метода де1:Сиг геп1:Розі1:іоп( ) 
или \ѵа1:сМРозі1:іоп( ) будет заново определять местонахождение. Если установить 
этот параметр в значение 60000, например, то реализации будет позволено возвра¬ 
щать любой объект СеорозШоп, полученный в течение последней минуты. 

Іопд Іішеоиі 

Этот параметр определяет продолжительность ожидания выполнения запроса 
в миллисекундах. По умолчанию имеет значение Шіпііу. По истечении указанно¬ 
го интервала времени будет вызвана функция обратного вызова еггог. Обратите 
внимание, что время ожидания разрешения пользователя на получение его место¬ 
нахождения не входит в это значение параметра *ітеощ. 

(ЗеоІосаііопЕггог 

ошибка, возникшая в ходе определения местонахождения пользователя 

Если попытка определить географическое местонахождение пользователя окончи¬ 
лась неудачей, будет вызвана функция обратного вызова еггог с объектом Сеоіосаіііоп- 
Еггог, описывающим ошибку. 

Константы 

Следующие константы являются возможными значениями свойства сосіе: 
ипзідпесЗ зНогИ РЕПМІЗЗІООЕМШ) = 1 

Пользователь не дал разрешение на определение его местонахождения, 
ипзідпесі зМогТ Р05ІТІ0М_ІЖАѴАІІ_АВІ_Е = 2 

Местонахождение не может быть определено по невыясненным причинам. Это мо¬ 
жет быть вызвано, например, сетевой ошибкой. 
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ипзідпесі зіюгі: ТІМЕОІГГ = 3 

Местонахождение не может быть определено в течение установленного интервала 
времени (см. описание параметра Іітеоиі: в справочной статье Оеоіосаііоп). 

Свойства 

геасіопіу ипзідпесі зіюгі: сойе 

Это свойство может иметь одно из трех значений, описанных выше, 
геасіопіу зігіпд теззаде 

Текст сообщения, более детально описывающего ошибку. Сообщение предназначе¬ 
но для отладки и не подходит для уведомления конечного пользователя. 

Сеорозіііоп 

информация о местонахождении с указанием времени определения 

Объект Сеорозіііоп представляет географическое местонахождение пользователя в ука¬ 
занный момент времени. Объекты этого типа имеют всего два свойства: время и ссылку 
на объект Сеосоогсііпаііез, хранящий фактические значения координат. 

Свойства 

геасіопіу Сеосоогсііпаіез соогйз 

Это свойство ссылается на объект Сеосоогсііпаіез, свойства которого определяют 
широту, долготу и другие параметры местонахождения пользователя. 

геасіопіу ипзідпесі Іопд ^ітезіатр 

Время в миллисекундах с начала эпохи, когда были определены эти координаты. 
При необходимости на основе этого значения можно создать объект йаіе. 

НазНСНапдеЕѵепі 

объект события, поставляемый по событию «НазНсНапде» Еѵепі 

Событие «ЬазЬсЬап&е» возбуждается броузером, когда изменяется идентификатор 
фрагмента (часть ІШЬ-адреса, начинающаяся с символа решетки #) документа. Это 
может происходить вследствие изменения свойства ПазП объекта Іюсаііоп или при пе¬ 
ремещении по истории посещений щелчком на кнопке броузера Васк (Назад) или Рог- 
ѵѵагсі (Вперед). В любом из этих случаев броузер генерирует событие «ЬазЬсЬап&е». Об¬ 
работчику этого события передается объект НазМСМапдеЕѵепІ:. Подробное обсуждение 
механизма управления историей посещения, а также свойства Іосаііоп.ІюзМ и собы¬ 
тия «ЬазЬсЬап^е» можно найти в разделе 22.2. 

Свойства 

геасіопіу зігіпд пе#ІЖІ_ 

Это свойство хранит новое значение свойства Іосаііоп.Мгеі. Обратите внимание, 
что это полный ІШЬ-адрес, а не только идентификатор фрагмента. 

геасіопіу зігіпд о1(11ЖІ_ 

Это свойство хранит прежнее значение свойства Іосаііоп.Мгеі. 
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Нізіогу 

журнал посещений объекта ѴѴіпсІоѵѵ 

Объект Нізіогу представляет историю посещений окна. Однако по соображениям без-" 
опасности объект Нізіогу не позволяет получать из сценариев доступ к хранящимся 
в нем ІШЬ-адресам. Методы объекта Нізіогу позволяют сценариям лишь переме¬ 
щаться вперед и назад по истории посещений и добавлять в нее новые записи. 

Свойства 

геасіопіу Іопд Іепдііі 

Это свойство определяет количество ІШЬ-адресов в журнале (истории) посещений 
броузера. Знание размера этого списка не особенно полезно, поскольку нет способа 
определить индекс текущего отображаемого документа в этом списке. 

Методы 

ѵоісі Ьаск() 

В результате вызова метода Ьаск( ) окно или фрейм, которому принадлежит объект 
НізТогу, заново открывает ІШЬ-адрес (если он есть), открытый непосредственно пе¬ 
ред текущим. Вызов этого метода имеет тот же эффект, что и щелчок на кнопке 
Васк броузера. Он также эквивалентен инструкции: 

Нізіогу. до( -1); 

ѵоісі ?огиагс)() 

В результате вызова метода іогмагсК ) окно или фрейм, которому принадлежит объ¬ 
ект Нізіогу, заново открывает ІШЬ-адрес (если он есть), открытый непосредствен¬ 
но после текущего. Вызов этого метода имеет тот же эффект, что и щелчок на кноп¬ 
ке Гогѵѵагсі броузера. Он также эквивалентен инструкции: 

Нізіогу. до(1); 

ѵоісі до([ Іопд беШ]) 

Метод Нізіогу. до() принимает целочисленный аргумент и вынуждает броузер от¬ 
крыть ІШЬ-адрес, отстоящий от текущего в журнале истории посещений на ука¬ 
занное число позиций. Положительное значение соответствует переходу вперед по 
истории посещений, а отрицательное - переходу назад. То есть вызов Нізіогу. до(-1) 
эквивалентен вызову Нізіогу. Ьаск( ) и имеет тот же эффект, что и щелчок на кнопке 
Васк. При вызове с аргументом 0 или вообще без аргумента этот метод перезагру¬ 
зит текущий документ. 

ѵоісі ризН8іаіе(апу с/аіа, зігіпд ііііе, [зігіпд игі ]) 

Добавляет новую запись в журнал посещений для данного окна, сохраняя струк¬ 
турированную копию (см. врезку «Структурированные копии» в главе 22) данных 
с/а іа, а также значения ііііе и игі. Если позднее пользователь воспользуется меха¬ 
низмом истории посещений броузера, чтобы вернуться к этому сохраненному со¬ 
стоянию, в окне будет сгенерировано событие «рорзіаіе» и обработчику будет пере¬ 
дан объект РорЗіаіеЕѵепі с еще одной структурированной копией значения аргу¬ 
мента ба іа в его свойстве зіаіе. 

Аргумент ііііе определяет имя сохраненного состояния, и броузеры могут отобра¬ 
жать его в графическом интерфейсе управления историей посещений. (На момент 
написания этих строк броузеры игнорировали данный аргумент). Если указан ар¬ 
гумент игі , он будет отображаться в строке ввода адреса и обеспечит сохранение 
информации о состоянии, благодаря чему его можно будет использовать для соз- 
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дания закладки или передачи другим пользователям. Аргумент игі интерпрети¬ 
руется относительно текущего значения сіосытепі Іосаііоп. Если в аргументе игі 
указан абсолютный ІЖЬ-адрес, он должен иметь то же происхождение, что и те¬ 
кущий документ. Чаще всего ІЖЬ-адреса используются на практике для измене¬ 
ния идентификатора фрагмента документа, начинающегося с символа #. 

ѵоісі гер1асе$іаіе(апу сіаіа , зігіпд іШе, [зігіпд игі]) 

Этот метод похож на метод ризМ5і:аі:е( ), за исключением того, что вместо создания 
новой записи в истории посещений окна он изменяет текущую запись, сохраняя 
в ней новые значения с(аІа, іШе и игі. 

НТМЮоНесИоп 

коллекция НТМ(.-элементов, доступных по позиции или по имени 

Объект НТМЮоІІесІіоп - это подобный массиву объект, доступный только для чтения, 
содержащий объекты Еіетепі и определяющий свойства, соответствующие значени¬ 
ям атрибутов пате и ісі хранящихся в нем элементов. Объект Оосцтепі определяет свой¬ 
ства типа НТМІХоІІесІіоп, такие как Іогтз и ітаде. 

Объекты НТМІ_Со11есІіоп определяют методы І1ет() и патесІПет() для извлечения эле¬ 
ментов по номеру позиции или имени, но они практически не используются на прак¬ 
тике: объект НТМІ_Со11есІіоп можно рассматривать как обычный объект и обращаться 
к его свойствам и элементам массива. Например: 

сіоситепі.ітадез[ 0] // По индексу элемента в коллекции НТМІ_Со11есІіоп 

сіоситепі. Іогтз.асісігезз // По имени элемента в коллекции НТМЮоІІесІіоп 

Свойства 

геасіопіу ипзідпесі Іопд ІепдіН 

Количество элементов в коллекции. 

Методы 

Еіетепі І1ет(ипзідпес1 Іопд іпсіех) 

Возвращает элемент коллекции, расположенный в позиции іпсіех , или пиіі, если 
индекс іпсіех выходит за границы массива. Этот метод можно не вызывать явно, 
а указать индекс в квадратных скобках (как для массива). 

оЦесІ пате(Иіет(зІгіпд пате) 

Возвращает первый элемент из коллекции, имеющий значение пате в атрибуте іб 
или пате либо пиіі, если такой элемент отсутствует. Этот метод можно не вызывать 
явно, а указать имя в квадратных скобках. 

НТМЮоситепІ 

см. Ооситепі 

НТМЬЕІетепі 

см. Еіетепі 

НТМІРогтСопІгоІзСоІІесііоп 

объект, подобный массиву, содержащий элементы форм НТМІСоІІесііоп 

Объект НТМЕРогтСопІгоІзСоІІесІіоп является специализированным подтипом НТМЮоІ- 
Іесііоп, используемым элементами Рогт для представления коллекций элементов 
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форм. Подобно объекту НТМІХоІІесТіоп, его можно использовать как массив, используя 
числовые индексы, или как объект, индексируя его значениями атрибутов паше или ісЗ 
элементов форм. НТМЬ-формы часто включают несколько элементов (обычно радио¬ 
кнопок или флажков), имеющих одинаковые значения в атрибуте пате, и объект 
НТМІРогтСопТгоІзСоІІесТіоп обрабатывает их иначе, чем обычный оъект НТМІ_Со11есіііоп. " 

При обращении к свойству объекта НТМІРогтСопТгоІзСоІІесТіоп, которому соответству¬ 
ют несколько элементов с одинаковыми именами, объект НТМІРогтСопТгоІзСоІІесТіоп 
возвращает объект, подобный массиву, содержащий все элементы формы, использую¬ 
щие это имя. Кроме того, возвращаемый объект, подобный массиву, имеет свойство 
ѵаіие, которое содержит значение атрибута ѵаіие первой отмеченной радиокнопки 
с этим именем. Этому свойству можно даже присвоить значение, чтобы отметить соот¬ 
ветствующую ему радиокнопку. 

НТМЮрііопзСоІІесІіоп 

коллекция элементов Орііоп НТМІ.СоІІесііоп 

Объект НТМШрІііопзСоІІесІііоп является специализированным подтипом НТМЮоІІесІіоп, 
который представляет элементы Орііоп, имеющиеся в элементе Зеіесі:. Он переопреде¬ 
ляет метод патесІІ1іет(), чтобы обеспечить возможность работы с несколькими элемен¬ 
тами Орііоп, имеющими одинаковые имена, и определяет методы добавления и удале¬ 
ния элементов. По историческим причинам объект НТМІ-ОрІііопзСоІІесІііоп определяет 
доступное для записи свойство ІепдііР, которое можно использовать для усечения или 
расширения коллекции. 

Свойства 

ипзідпесі Іопд ІепдІІі 

Возвращает количество элементов в коллекции. Однако, в отличие от свойства ІепдТМ 
обычного объекта НТМІ_Со11ес1ііоп, это свойство доступно не только для чтения. Если 
присвоить ему значение меньше текущего, коллекция элементов Оріііоп будет усече¬ 
на, а элементы Оріііоп, оказавшиеся за пределами коллекции, будут удалены из эле¬ 
мента беіесіі. Если присвоить свойству ІепдіМ значение больше текущего, будут соз¬ 
даны и добавлены в элемент Зеіесіі и в коллекцию новые пустые элементы <орііоп/>. 

Іопд зеіесгейіпйех 

Индекс первого выбранного элемента Оріііоп в коллекции или -1, если ни один эле¬ 
мент Оріііоп не был выбран. Это свойство можно использовать, чтобы программно 
выбрать требуемый элемент. 

Методы 

ѵоіР ай<1(Е1етепіі оріііоп, [апу ЬеТоге]) 

Вставляет элемент оріііоп (который должен быть элементом <орііоп> или <орідгоир>) 
в данную коллекцию (и в элемент Зеіесіі), в позицию, определяемую аргументом 
ЬеТоге . Если аргумент ЬеТоге имеет значение пиіі, новый элемент вставляется в ко¬ 
нец коллекции. Если аргумент ЬеТоге имеет целочисленное значение, новый эле¬ 
мент будет вставлен перед элементом, который в текущий момент имеет этот ин¬ 
декс. Если передать в аргументе ЬеТоге другой элемент Еіетепі, орТіоп будет встав¬ 
лен перед этим элементом. 

Еіетепі І1ет(ітзідпес1 Іопд іпЬех) 

Объект НТМШрІііопзСоІІесІііоп наследует этот метод от НТМШоІІесІііоп. Он возвращает 
элемент с индексом іпсіех или пиіі, если индекс выходит за границы коллекции. 
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Коллекцию можно также индексировать непосредственно, используя квадратные 
скобки и не вызывая этот метод явно. 

оЬ^есІ: пате(1Иет(5І:гіпд пате) 

Возвращает все элементы Орііоп из коллекции, имеющие значение пате в атрибу¬ 
те ісі или пате. Если элементы с таким именем отсутствуют, возвращается значе¬ 
ние пиіі. Этот метод можно не вызывать явно, а указать имя в квадратных скоб¬ 
ках. Если заданному имени соответствует только один элемент Орііоп, возвраща¬ 
ется этот элемент. Если заданному имени соответствует более одного элемента, 
возвращается объект МосІеНзі: с этими элементами. Обратите внимание, что объек¬ 
ты НТМЕОрІіопзСоІІесІіоп можно индексировать непосредственно, используя значе¬ 
ние пате как имя свойства, вместо явного вызова этого метода. 

ѵоісі гешоѵе(1опд іпбех) 

Удаляет из коллекции элемент сор! іо п> с индексом іпбех. При вызове без аргумен¬ 
та или со значением аргумента, которое выходит за границы коллекции, может 
удалить первый элемент коллекции. 

ІРгате 

НТМЬтег <ійгате> ЬІосІе, Еіетепі 

Объект ІРгате представляет элемент <і1тате> в НТМЬ-документе. Если попробовать 
отыскать элемент <іІгате> с помощью метода деіЕІетепіВуІсК) или подобного ему, вы 
получите объект ІРгате. Однако, если обратиться к элементу <і1тате> через свойство 
Ігатез объекта Іл/іпсісм или используя имя элемента <іІгате> как свойство содержащего 
его окна, вы получите объект Іл/іпсісм, представляющий элемент <іІгате>. 

Свойства 

геасіопіу Ооситепі: сопІепЮоситепі 

Документ, содержащий данный элемент <іІгате>. Если документ отображается 
в <іІгате> с другим происхождением, доступ к этому документу будет закрыт из-за 
ограничений, накладываемых политикой общего происхождения (раздел 13.6.2). 

геасіопіу Іл/іпсіо\л/ сопіепіМіпсІоѵ/ 

Объект іл/іпсісм, содержащий элемент <і!гате>. (Свойство ІгатеЕІетепІ: этого объекта 
іл/іпсісм будет ссылаться обратно на данный объект ІРгате.) 

зігіпд ЬеідМ 

Высота элемента <іІгате> в С88-пикселах. Это свойство соответствует атрибуту 
ИеідИі:. 

зігіпд пате 

Имя элемента <іІгате>. Это свойство соответствует атрибуту пате, а его значение 
можно присваивать свойству Іагдеі объектов 1_іпк и Рогт. 

геасіопіу ООМЗеНаЫеТокепИз!: запсІЬох 

Это свойство соответствует НТМЬб-атрибуту запсІЬох и может использоваться как 
строка или как множество отдельных лексем. 

Атрибут запсІЬох определяет, какие дополнительные ограничения должны накла¬ 
дываться броузером на содержимое, отображаемое в элементе <іігате>. Если атри¬ 
бут запсІЬох присутствует в элементе, но имеет пустое значение, содержимое фрей¬ 
ма <і1гате> будет интерпретироваться как имеющее другое происхождение, и ему 
не будет позволено запускать сценарии, отображать формы и изменять свойство 
Іосаііоп окна, содержащего фрейм. Атрибуту запсІЬох можно также присвоить спи- 




962 


Справочник по клиентскому ІаѵаБсгірІ: 


сок лексем, разделенных пробелами, снимающих эти дополнительные ограниче¬ 
ния. Допустимыми лексемами являются: «аііолѵ-вате-огі^іп», «аііолѵ-всгірів», «аі- 
Іоѵѵ-іогтв* и *а11олѵ-іор-паѵіеаііоп». 

На момент написания этих строк атрибут запРЬох был реализован не во всех бро¬ 
узерах. Дополнительные сведения приводятся в справочной статье НТМІ_. 

Ьооіеап зеатіезз 

Это свойство соответствует атрибуту зеатіезз. Если оно имеет значение Тгие, бро¬ 
узер должен отображать содержимое элемента <і1тате> так, как если бы оно было 
составной частью объемлющего документа. Отчасти это означает, что броузер дол¬ 
жен применить к содержимому фрейма стили С88 вмещающего документа. 

Атрибут зеатіезз был введен в спецификации НТМЬб и на момент написания этих 
строк был реализован не во всех броузерах. 

зігіпд зге 

Это свойство соответствует атрибуту зге элемента <і1тате>: он определяет ІШЬ-ад- 
рес содержимого фрейма. 

зігіпд згссіос 

Это свойство соответствует атрибуту згссіос и определяет содержимое элемента 
<і1тате> в виде строки. Атрибут згссіос был введен в спецификации НТМЬб совсем 
недавно и на момент написания этих строк был реализован не во всех броузерах. 

зігіпд ѵ/іс11:И 

Ширина фрейма в С88-пикселах. Это свойство соответствует атрибуту ѵл/ісНІі. 

Ітаде 

тег <ітд> в НТМЬдокументе КЫе, Еіетепі 

Объекты Іта&е встраиваются в НТМЬ-документ в виде тегов <ітд>. Изображения, при¬ 
сутствующие в документе, собираются в виде массива РоситепЫтадезП. 

Свойство згс объекта Ітаде представляет наибольший интерес. Когда вы устанавли¬ 
ваете это свойство, броузер загружает и показывает изображение, заданное новым 
значением. Это позволяет создавать такие эффекты, как смена изображений и анима¬ 
ция. Соответствующие примеры приводятся в разделе 21.1. 

Имеется возможность создавать невидимые объекты Ітаде, добавляя новые элементы 
<ітд> вызовом метода сіоситепі:. с геаІеЕІетепіО или конструктора Ітаде(). Обратите вни¬ 
мание: этот конструктор не имеет аргумента, который определял бы изображение для 
загрузки; чтобы загрузить изображение, достаточно просто установить свойство згс 
созданного вами объекта Ітаде. Чтобы фактически отобразить изображение, объект 
Ітаде необходимо вставить в документ. 

Конструктор 

пе\л/ Ітаде([ипзідпес1 іопд іипзідпесі іопд 

Как и любой другой НТМЬ-элемент, новый объект Ітаде можно создать с помощью 
метода Роситепі.сгеаіеЕІетепіО. Однако по историческим причинам клиентский 
Лѵа8сгірі также определяет конструктор Ітаде(), позволяющий сделать то же са¬ 
мое. Если указаны аргументы і ѵісІТІі и/или ЬеідЬТ, их значения будут присвоены 
атрибутам ѵу/ісИ:М и ИеідИі: тега <ітд>. 

Свойства 

Помимо свойств, перечисленных ниже, элементы Ітаде также предоставляют свойст¬ 
ва, соответствующие НТМЬ-атрибутам аИ, изетар, ізтар. 
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геасіопіу Ьооіеап сотріе^е 

Значение Іігие, если свойство зге не было определено или изображение было загру¬ 
жено полностью, в противном случае - ^аізе. 

ипзідпесі Іопд ІіеідШ 

Высота области на экране в С88-пикселах, в которой отображается данное изобра¬ 
жение. Изменение значения этого свойства приводит к изменению высоты изобра¬ 
жения на экране. 

геасіопіу ипзідпесі Іопд паІига1Неід№ 

Высота самого изображения, 
геасіопіу ипзідпесі Іопд пагигаІМігігИ 
Ширина самого изображения, 
зігіпд зге 

ІШЬ-адрес изображения. Присваивание значения этому свойству вынуждает бро¬ 
узер загрузить указанное изображение. Если объект Ітаде был вставлен в доку¬ 
мент, он отобразит новое изображение. 

ипзідпесі Іопд иі(1*іі 

Ширина области на экране в С88-пикселах, в которой отображается данное изо¬ 
бражение. Изменение значения этого свойства приводит к изменению ширины 
изображения на экране. 

ІтадеОаіа 

массив пикселов в элементе <сапѵаз> 

Объект ІтадеРаіа хранит красную, зеленую и синюю составляющие, а также уровень 
прозрачности для каждого пиксела в прямоугольной области. Получить объект Ітаде - 
Оаіа можно с помощью метода сгеаіеІтадеОаІіаО или деіІтаде0а1:а() объекта СапѵазРеп- 
сіегіпдСопі:ехі:20 из тега <сапѵаз>. 

Свойства місШі и Ііеідііі: определяют размеры прямоугольника в пикселах. Свойство 
сіаіа - это массив, хранящий информацию о пикселах. Пикселы размещаются в мас¬ 
сиве сІаіаП в направлении слева направо и сверху вниз. Каждый пиксел состоит из 
четырех байт, представляющих компоненты К, С, В и А, именно в этом порядке. Та¬ 
ким образом, получить доступ к компонентам цвета пиксела с координатами (х,у) 
внутри объекта ІтадеОаіа можно так: 

ѵаг о^зе* = (х + у* ітаде . \ѵіс!1;1п ) * 4; 
ѵаг гесі = ітаде. йаіа[о^5еІ]; 
ѵаг дгееп = ітаде.йаіа[о^5еі+1]; 
ѵаг Ыие = ітаде.йаіа[о^5еі+2]; 
ѵаг аірііа = ітаде. йаІа[о^5еІ+3]; 

Массив йа*а[ ] не является истинным массивом - это объект, подобный массиву, опти¬ 
мизированный для хранения целочисленных элементов со значениями в диапазоне 
от 0 до 255. Элементы массива доступны для чтения и записи, но свойство Іепдііі мас¬ 
сива имеет фиксированное значение. Для любого объекта і типа ІтадеОаіа значение 
свойства і.йаіа.іепдіііі всегда будет равно значению выражения і.ѵшШі * і.Ііеідііі: * 4. 

Свойства 

геасіопіу ЬуІе[] ОаТа 

Ссылка, доступная только для чтения, на объект, подобный массиву, доступный 
для чтения и записи, элементами которого являются байты. 
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геасіопіу ипзідпесі Іопд ЬеідЬІ: 

Количество строк пикселов изображения в массиве сіаіа. 
геасіопіу ипзідпесі Іопд мігіТИ 

Количество пикселов в строке изображения, в массиве сіаіа. 

Іприі 

НТМЬ-элемент <іприі> Иосіе, Еіетепі, РогтСопігоІ 

Объект Іприі представляет НТМЬ-тег <іпри1:>. Его внешний вид и поведение определя¬ 
ется атрибутом Туре: элемент ІприТ может представлять, например, простое текстовое 
поле ввода, флажок, радиокнопку, простую кнопку или элемент выбора файла. Так 
как элемент <іприі:> может представлять самые разные элементы форм, объект ІприТ 
является одним из самых сложных. Краткий обзор НТМЬ-форм и их элементов при¬ 
водится в разделе 15.9. Обратите внимание, что некоторые из важных свойств объекта 
Іприі (такие как іуре, ѵаіие, пате и Рогт) описываются в справочной статье РогтСопІігоІ. 

Свойства 

Помимо свойств, перечисленных ниже, объекты Іприі также поддерживают все свой¬ 
ства, определенные в объектах Еіетепі и РогтСопігоІ. Свойства в этом списке, помечен¬ 
ные звездочкой, являются новыми, введенными спецификацией НТМЬб, и на момент 
написания этих строк они были реализованы не во всех броузерах. 

зігіпд ассері 

Если свойство Руре имеет значение «Ше», это свойство содержит список МІМЕ-ти- 
пов, разделенных запятыми, определяющих типы файлов, которые могут быть 
выбраны. Допустимыми являются также строки «ашііо/*», «ѵісіео/*» и «іта^е/*». 
Соответствует атрибуту ассерр. 

зРгіпд аиіосотріеіе 

Значение Ргие, если броузеру разрешено предварительно заполнять этот элемент 
ІприР значением, сохранившимся с предыдущего сеанса. Соответствует атрибуту 
аиРосотрІеРе. См. также описание свойства аиРосотрІеРе объекта Рогт. 

Ьооіеап сЬескес! 

Для радиокнопок и флажков данное свойство указывает, является соответствую¬ 
щий элемент «отмеченным» или нет. Изменение этого свойства вызывает измене¬ 
ние визуального представления элемента ввода. 

Ьооіеап (ІеРаиІРСЬескесІ 

Для радиокнопок и флажков данное свойство хранит начальное значение атрибу¬ 
та сЬескесі, элемента. Когда выполняется сброс элементов формы, в свойство сЬескесі 
записывается значение этого свойства. Соответствует атрибуту сЬескесі. 

зРгіпд (Іе^аиІІѴаІие 

Для элементов с текстовым значением данное свойство хранит начальное значе¬ 
ние, отображаемое элементом. Когда выполняется сброс элементов формы, эле¬ 
мент восстанавливается в это значение. Соответствует атрибуту ѵаіие. 

геасіопіу Рі1е[] Рііез 

Для элементов, значением свойства Руре которых является строка «Ше», данное 
свойство ссылается на объект, подобный массиву, хранящий объект или объекты 
Рііе, соответствующие файлам, выбранным пользователем. 
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зігіпд ^огтАсСіоп* 

Для кнопок отправки форм это свойство определяет значение, переопределяющее 
значение свойства асііоп вмещающей формы. Соответствует атрибуту ^огтасііоп. 

зіігіпд ?огтЕпс*уре* 

Для кнопок отправки форм это свойство определяет значение, переопределяющее 
значение свойства епсіуре вмещающей формы. Соответствует атрибуту ^огтепсіуре. 

зігіпд ГогтМеНюс)* 

Для кнопок отправки форм это свойство определяет значение, переопределяющее 
значение свойства теІЬосІ вмещающей формы. Соответствует атрибуту І'огттеІЬосІ. 

Ьооіеап ^огтМоѴаІігіаге* 

Для кнопок отправки форм это свойство определяет значение, переопределяющее 
значение свойства поѴа1іс!а1:е вмещающей формы. Соответствует атрибуту І^огтпо- 
ѵаіісіаііе. 

зТгіпд ^огтТагде** 

Для кнопок отправки форм это свойство определяет значение, переопределяющее 
значение свойства Іагдеі вмещающей формы. Соответствует атрибуту ^огтіагде*. 

Ьооіеап іп(1е*егіпіпа*е 

Для флажков это свойство определяет, находится ли элемент в неопределенном со¬ 
стоянии (т. е. элемент ни отмечен, ни не отмечен). Это свойство не является отра¬ 
жением какого-либо НТМЬ-атрибута: его можно установить только в сценариях 
на языке ЛѵаЗсгірі. 

геайопіу Еіетепі; Из** 

Элемент <йа*а1із*>, содержащий элементы <ор!:іоп>, которые броузер может ис¬ 
пользовать в качестве значений для подсказки или автодополнения. 

зігіпд шах* 

Максимальное допустимое значение для данного элемента Іприі:. 

Іопд тахІ_епд*Ь 

Когда значением свойства Іуре является строка «Іехі» или «раззѵгопі», данное 
свойство определяет максимальное число символов, которые пользователь сможет 
ввести. Не путайте это свойство со свойством зіге. Соответствует атрибуту тахіепдіь. 

зігіпд тіп* 

Минимальное допустимое значение для данного элемента Іприі:. 

Ьооіеап тиШрІе* 

Значение Тгие, если элемент ввода должен принимать более одного значения ука¬ 
занного типа. Соответствует атрибуту тиііііріе. 

зігіпд раИегп* 

Текст регулярного выражения, которому должен соответствовать введенный текст, 
чтобы его можно было признать допустимым. Это свойство использует синтаксис 
регулярных выражений ЛѵаЗсгірі (без начального и конечного символов слэша), 
но имейте в виду, что значением этого свойства является строка, а не объект РедЕхр. 
Отметьте также - чтобы введенный текст был признан допустимым, шаблону дол¬ 
жен соответствовать текст целиком, а не только какая-то его часть. (Как если бы 
шаблон начинался с символа ~ и заканчивался символом $.) Это свойство соответ¬ 
ствует атрибуту раПегп. 




966 


Справочник по клиентскому ІаѵаБсгірі 


зігіпд рІасеЬоІйег 

Короткая текстовая строка, которая должна выводиться в элементе Іприі, как 
приглашение к вводу. Когда пользователь передаст элементу фокус ввода, текст, 
приглашения будет стерт и в элементе появится текстовый курсор. Это свойство 
соответствует атрибуту рІасеЬоІсІег. 

Ьооіеап геайОпІу 

Если имеет значение 1: гие, элемент будет недоступен для редактирования. Соответ¬ 
ствует атрибуту геасіопіу. 

Ьооіеап гедиігей* 

Если имеет значение Ігие, вмещающая форма не будет считаться корректной, пока 
пользователь не введет значение в данный элемент Іприі. Соответствует атрибуту 

гедиігесі. 

геасіопіу Орііоп зеІесІесЮрІіоп* 

Если свойство Из! определено и свойство тиіііріе имеет значение Іаізе, данное свой¬ 
ство возвращает выбранный элемент Орііоп из списка Из!, если таковой имеется. 

ипзідпесі Іопд зеІесІіопЕпй 

Возвращает или изменяет индекс первого символа, следующего за выделенным 
фрагментом. См. также зеі8е1ес!іопРапде(). 

ипзідпесі Іопд зе1есІіоп8ІагІ 

Возвращает или изменяет индекс первого символа в выделенном фрагменте в эле¬ 
менте <ІехІагеа>. См. также зе!8е1есІіопРапде(). 

ипзідпесі Іопд зіге 

Для текстовых элементов ввода данное свойство определяет ширину элемента 
в символах. Соответствует атрибуту зіге. Не путайте со свойством тахІ_епдІЬ. 

зігіпд зіер* 

Для элементов ввода чисел (включая элементы ввода даты и времени) это свойство 
определяет шаг изменения значения. Это свойство может быть строкой «апу» или 
вещественным числом. Соответствует атрибуту зіер. 

Раіе ѵаІиеАзОаІе* 

Возвращает значение элемента (см. РогтСопігоІ) в виде объекта Оаіе. 

ЬоиЫе ѵаІиеАзМитЬег* 

Возвращает значение элемента (см. РогтСопІгоІ) в виде числа. 

Методы 

В дополнение к методам, перечисленным ниже, элементы Іприі: реализуют также все 
методы объектов Еіетеп! и РогтСопІгоІ. Методы, отмеченные звездочкой в этом списке, 
являются новыми, определяемыми спецификацией НТМЬб, которые на момент на¬ 
писания этих строк были реализованы не во всех броузерах. 

ѵоісі зеІесіО 

Выделяет весь текст, отображаемый в элементе Іприі. Во многих броузерах это оз¬ 
начает, что при вводе очередного символа выделенный текст будет удален и заме¬ 
щен введенным символом. 

ѵоісі зеІ8е1есІіопНапде(ипзідпес! Іопд зТагі, ипзідпеР Іопд епсі) 

Этот метод выделяет текст, отображаемый в элементе Іприі, начиная с символа 
в позиции зТагТ и до (не включая) символа в позиции епсі. 
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ѵоісі з1ер0оип([1опд л])* 

Для элементов, поддерживающих свойство зіер, уменьшает текущее значение на п 
шагов. 

ѵоісі з*ерир([1опд л])* 

Для элементов, поддерживающих свойство зіер, увеличивает текущее значение на 
л шагов. 

ІОиегу ІОиегу 1.4 

библиотека ІОиегу 

Описание 

Это краткий справочник по библиотеке ІОиегу. Более полное описание библиотеки 
и примеры ее использования приводятся в главе 19. Эта справочная статья организо¬ 
вана несколько иначе, чем все остальные. При оформлении сигнатур методов здесь 
использовались следующие соглашения. Аргументы с именем зеі являются селекто¬ 
рами библиотеки ІОиегу. Аргументы с именем ібх являются целочисленными индек¬ 
сами. Аргументы с именем еІТ или еІТз являются элементами документа или объекта¬ 
ми, подобными массивам, содержащими элементы документа. Аргументы с именем Т 
являются функциями обратного вызова, а вложенные круглые скобки используются, 
чтобы показать аргументы, которые передаются библиотекой ІОиегу при вызове этой 
функции. Квадратные скобки указывают на необязательные аргументы. Если за име¬ 
нем необязательного аргумента следует знак «равно» и значение, это означает, что 
указанное значение используется по умолчанию, если аргумент был опущен. Вслед за 
закрывающей круглой скобкой и двоеточием следует значение, возвращаемое функ¬ 
цией или методом. Если возвращаемое значение не указано, это означает, что метод 
возвращает объект ]0иегу, относительно которого он был вызван. 

Фабричная функция ІОиегу 

Функция ]0иегу не только играет роль пространства имен для различных вспомога¬ 
тельных функций, но и является фабричной функцией для создания объектов ]0иегу. 
Функция ]0иегу() может вызываться во всех случаях, перечисленных ниже, но она 
всегда возвращает объект ]0иегу, представляющий коллекцию элементов документа 
(или сам объект Ооситепі). Имя $ является псевдонимом для имени ]0иегу, поэтому во 
всех формах вызова, представленных ниже, вместо іОиегуО можно использовать $(): 

]0иегу(5е1 [, сопТех^бостепі]) 

Возвращает новый объект ]0иегу, представляющий элементы документа, которые 
являются потомками для элемента сопТехТ и соответствуют строке селектора зеі. 

ІОиегу (еііз) 

Возвращает новый объект ІОиегу, представляющий указанные элементы. Аргу¬ 
мент еІТз может быть единственным элементом документа, массивом или объек¬ 
том, подобным массиву (таким как МосІеНзі или другой объект ІОиегу), содержа¬ 
щим элементы документа. 

І0иегу(/?*ж2, [ргорз ]) 

Выполняет синтаксический анализ строки ЬТтІ с разметкой НТМЬ и возвращает 
новый объект ІОиегу, с одним или более элементами верхнего уровня, содержащи¬ 
мися в строке. Если аргумент Шті содержит единственный НТМЬ-тег, в аргументе 
ргорз можно передать объект, определяющий НТМЬ-атрибуты и обработчики со¬ 
бытий для вновь созданного элемента. 
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]0иегу(О 

Регистрирует Т как функцию, которая должна быть вызвана после того, как доку¬ 
мент будет загружен и станет доступен для выполнения операций с ним. Если до¬ 
кумент уже готов к выполнению операций, функция Т будет вызвана немедленно, 
как метод объекта сіосішепі:. Возвращает объект ]0иегу, содержащий только объект 

сіосішепі:. 

Грамматика селекторов іОиегу 

Грамматика селекторов і(}иегу очень похожа на грамматику селекторов С883 и подроб¬ 
но описывается в разделе 19.8.1. Далее следует описание грамматики в кратком изло¬ 
жении: 

Простые селекторы по имени тега , класса и значению атрибута Ш 
* *адпате хіаззпате #іс! 

Комбинированные селекторы 

А В В - потомок А 

А > В В - дочерний по отношению к А 

А + В В - смежный, следующий за А 

А “ В В - смежный по отношению к А 

Фильтры атрибутов 

[аТТг] имеет атрибут 

[аі!г=ѵа1] имеет атрибут со значением ѵаі 

[а11г!=ѵа1] не имеет атрибута со значением ѵаі 

[аііг^ѵаі] значение атрибута начинается с ѵаі 

[а11г$=ѵа1] значение атрибута заканчивается на ѵаі 

[а!1г*=ѵа1] значение атрибута включает ѵаі 

[а!1г“=ѵа1] значение атрибута включает ѵаі как слово 

[а11г|=ѵа1] значение атрибута начинается с ѵаі и необязательного дефиса 

Фильтры по типам элементов 

:Ьііііоп :Ііеас1ег :раззѵу/огс1 : зиЬтіІ: 

хІіескЬох :ітаде ігасііо : ТехТ 

:^і1е :іпрііі: ігезеі 

Фильтры по состоянию элементов 

: апітаТесІ ісІізаЫесі :1йсісіеп :ѵізіЬ1е 
хііескесі хпаЫей ізеіесіесі 

Фильтры по позиции 

:ер(п) :^ігзі :1азІ :пІЬ(п) 

хѵеп :дІ(п) :11(п) : осісі 

Фильтры по позиции в документе 

: ”Гі гзТ-сіііісі :пііі-сіп1сі(п) 

: ІазТ-сЬіІсІ :пІІі-сЫ1сІ(еѵеп) 

: опІу-сЬі Ісі :пИі-сИі1сі(осіс1) 

:пІІі-сНі1сІ(хп+у) 

Прочие фильтры 

хопіаіпз(іехі) :поІ(зе1есІог) 

:етрІу :рагепІ 

: Иаз( зеіесііог) 
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Базовые свойства и методы объекта ІОиегу 

Ниже перечислены базовые свойства и методы объектов ]0иегу. Они не влияют на вы¬ 
бор или на выбранные элементы, но позволяют обращаться к выбранным элементам 
и выполнять итерации по ним. Дополнительные сведения приводятся в разделе 19.1.2. 

сопіехі: 

Контекст, или корневой элемент, в котором будет производиться выбор. Это вто¬ 
рой аргумент функции $() или объект Ооситепі:. 

еас \)(?(ісІх,е1і:)) 

Вызывает Т как метод для каждого выбранного элемента. Останавливает итера¬ 
ции, как только функция вернет Шзе. Возвращает объект ]0иегу, относительно 
которого был вызван данный метод. 

де!(іс(х):е11 

де1():аггау 

Возвращает выбранный элемент с указанным индексом в объекте ІОиегу. Можно 
также использовать обычный синтаксис индексирования массивов с квадратны¬ 
ми скобками. При вызове без аргументов деі() действует так же, как 1оАггау(). 

іпс!ех():іп1: 

Іпс1ех(5е1):іп1: 

іпс!ех(еіГ):іп1: 

При вызове без аргументов возвращает индекс первого выбранного элемента среди 
смежных с ним элементов. При вызове с селектором возвращает первый элемент 
из множества выбранных элементов, соответствующий селектору зе1 9 или -1, если 
такой элемент отсутствует. При вызове с элементом возвращает индекс элемента 
еіі в множестве выбранных элементов или -1, если указанный элемент не входит 
в множество выбранных элементов. 

із(зеі):Ьоо1еап 

Возвращает Іігие, если селектору зеі соответствует хотя бы один выбранный эле¬ 
мент. 

ІепдТМ 

Количество выбранных элементов. 

тар(/ г (іс(х 1 е1О)-]0иегу 

Вызывает Т как метод для каждого выбранного элемента и возвращает новый объ¬ 
ект ]0иегу, хранящий возвращаемые значения, при этом возвращаемые значения 
пиіі и ипсІе-ГіпесІ не помещаются в массив значений. 

зеіесіог 

Оригинальная строка селектора, переданная функции $(). 

зі 2 е():іп 1 : 

Возвращает значение свойства 1епд1:1і. 

1:оАггау():аггау 

Возвращает истинный массив выбранных элементов. 

Методы выбора ІОиегу 

Методы, описываемые в этом разделе, изменяют множество выбранных элементов, 
выполняя фильтрацию, добавляя новые элементы или используя выбранные элемен¬ 
ты как начальные точки для нового выбора. В ІОиегу версии 1.4 и выше выбранные 
элементы в объекте ]0иегу всегда отсортированы в порядке их следования в докумен- 
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те, а сами множества не содержат дубликатов. Дополнительные сведения приводятся 
в разделе 19.8.2. 

асіс 1(зе1, [ сопТехТ ]) 
асіс \(е1Тз) 
абб (ЬШ) 

Аргументы метода ас1сІ( ) передаются функции $(), а результаты выбора добавляют¬ 
ся в текущее множество выбранных элементов. 

апйбеЩ) 

Добавляет в текущий выбор множество ранее выбранных элементов (со стека). 

сШс1геп([5е1]) 

Выбирает элементы, являющиеся дочерними, по отношению к выбранным эле¬ 
ментам. При вызове без аргументов выбирает все дочерние элементы. При вызове 
с селектором выбирает только соответствующие ему дочерние элементы. 

сіозезі^зеі, [ сопТехТ ]) 

Выбирает ближайшего предка каждого выбранного элемента, соответствующего 
селектору зеі , являющегося потомком по отношению к элементу сопТехТ. Если ар¬ 
гумент сопТехТ опущен, используется свойство сопіехі: объекта ]0иегу. 

сопіепізО 

Выбирает все дочерние элементы во всех выбранных элементах, включая тексто¬ 
вые узлы и комментарии. 

епс!() 

Выталкивает с внутреннего стека и восстанавливает состояние выбора, предшест¬ 
вовавшее последнему вызову метода, изменяющего выбор. 

ецШх) 

Выбирает только выбранный элемент с указанным индексом. В і(}иегу версии 1.4 
отрицательные значения отсчитываются с конца множества. 

Пег (зеі) 

Ш1 :ег(е1Гз) 

? і 11; е г ( Т( і бх) : Ьооіеа п) 

Фильтрует множество выбранных элементов так, что в результат включаются 
только элементы, которые соответствуют селектору зеі, или содержатся в объекте 
еІГз, подобном массиву, или для которых функция-предикат Т вернет Ігие, когда 
она будет вызвана как метод элемента. 

^іпсКзе!) 

Выбирает всех потомков выбранных элементов, которые соответствуют селектору 
зеі. 

Игз1() 

Выбирает только первый выбранный элемент. 

Маз(зеі) 

Ііаз(еІГ) 

Фильтрует выбранные элементы, включая в результат только элементы, которые 
имеют потомков, соответствующих селектору зеі или являющихся предками эле¬ 
мента еІТ. 

ІазШ 

Выбирает только последний выбранный элемент. 
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пехі:( [зеі]) 

Выбирает следующий смежный элемент для каждого выбранного элемента. Если 
указан аргумент зеі , исключает из результата элементы, не соответствующие се¬ 
лектору. 

пех1:А11( [зеі]) 

Выбирает все смежные элементы, следующие за каждым выбранным элементом. 
Если указан аргумент зеі, исключает из результата элементы, не соответствую¬ 
щие селектору. 

пехІІМіКзеі) 

Выбирает смежные элементы, следующие за каждым выбранным элементом, до 
(но не включая его) первого смежного элемента, соответствующего селектору зеі. 

поі:(зеі) 
поЦеІТз) 

по1:(^(ісУх): Ьооіеап) 

Противоположный методу Ш1:ег(). Фильтрует выбранное множество, исключая 
элементы, которые соответствуют селектору зеі, или включены в состав еіігз, или 
для которых Т вернет 1:гие. Аргумент еіГз может быть единственным элементом 
или объектом, подобным массиву, содержащим элементы. Функция Т вызывается 
как метод для каждого выбранного элемента. 

о^зе*Рагеп*() 

Выбирает ближайшего позиционируемого предка для каждого выбранного эле¬ 
мента. 

рагепи( [зеі]) 

Выбирает родителя для каждого выбранного элемента. Если указан аргумент зеі, 
исключает из результата элементы, не соответствующие селектору. 

рагегШзС [зеі]) 

Выбирает предков для каждого выбранного элемента. Если указан аргумент зеі, 
исключает из результата элементы, не соответствующие селектору. 

рагегЦзУп Ш(зеі) 

Выбирает предков для каждого выбранного элемента до (но не включая) первого 
предка, соответствующего селектору. 

ргеѵ([зеі]) 

Выбирает предшествующий смежный элемент для каждого выбранного элемента. 
Если указан аргумент зеі, исключает из результата элементы, не соответствую¬ 
щие селектору. 

ргеѵА11([зеі]) 

Выбирает все смежные элементы, предшествующие каждому выбранному элемен¬ 
ту. Если указан аргумент зеі, исключает из результата элементы, не соответствую¬ 
щие селектору. 

ргеѵІІпШ (зеі) 

Выбирает смежные элементы, предшествующие каждому выбранному элементу, 
до (но не включая его) первого смежного элемента, соответствующего селектору зеі. 

ризІіЗі:аск(еі(:5) 

Помещает текущее состояние выбора на стек, после чего оно может быть восста¬ 
новлено вызовом метода епс!( ), и затем выбирает элементы в массиве (или в объек¬ 
те, подобном массиву) еІТз. 
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зіЬ1іпдз([5еі]) 

Выбирает смежные элементы для каждого выбранного элемента, исключая сам 
элемент. Если указан аргумент зеі, исключает из результата элементы, не соответ¬ 
ствующие селектору зеі. 

зііс е(зТагі:ісІх, [ епсіісіх ]) 

Фильтрует выбор, оставляя только элементы, индексы которых больше или рав¬ 
ны зТагТібх и меньше (но не равны) епсіісіх. Отрицательные индексы отсчитывают¬ 
ся от конца множества выбранных элементов. Если аргумент епсіісіх не указан, ис¬ 
пользуется значение свойства ІепдІІі. 

Методы іОиегу для работы с элементами 

Методы, описываемые здесь, предназначены для чтения и записи значений НТМЬ-ат- 
рибутов и свойств С88-стилей элементов. Функции обратного вызова в аргументе 
сиггепТ передается текущее значение атрибута или свойства, для которого вычисляет¬ 
ся новое значение. Дополнительные сведения приводятся в разделе 19.2. 

асІсІСІазз (патез) 
ас1сЮ1азз(/ : (іс/х,сіУггелО‘патез) 

Добавляет указанное имя или имена С88-классов в атрибут сіазз каждого выбран¬ 
ного элемента. Или вызывает Т как метод для каждого элемента для вычисления 
имени или имен классов, добавляемых в атрибут. 

аі: 1: г (ла/ие): ѵаіие 

аХХг(пате, ѵаіие) 

аХХг(пате, Т(ібх,сиггепТ)\ѵ аіие) 

аХХс(оЬ]) 

При вызове с единственным строковым аргументом возвращает значение указан¬ 
ного атрибута первого выбранного элемента. При вызове с двумя аргументами ус¬ 
танавливает указанный атрибут во всех выбранных элементах в значение ѵаіие 
или вызывает Т как метод для каждого элемента для вычисления значения атри¬ 
бута. При вызове с единственным аргументом-объектом использует имена его 
свойств, как имена атрибутов, а значения свойств - как значения атрибутов или 
как функции вычисления значений атрибутов. 

с$$(ла/ие): ѵаіие 

сзз (пате, ѵаіие) 

сзз (пате, Т(ібх, сиггепТ): ѵаіие) 

сзз (оЬі) 

Действует подобно методу а11:г(), но возвращает или устанавливает не НТМЬ-атри- 
буты, а атрибуты С88-стиля. 

с!аі:а():оЬ] 
баХа(кеу): ѵаіие 
баха(кеу, ѵаіие) 
баТа(оЦ) 

При вызове без аргументов возвращает объект с данными для первого выбранного 
элемента. При вызове с одним строковым аргументом возвращает значение ука¬ 
занного свойства объекта с данными. При вызове с двумя аргументами устанавли¬ 
вает указанное свойство в объекте данных для всех выбранных элементов в значе¬ 
ние ѵаіие. При вызове с одним аргументом-объектом замещает им объекты с дан¬ 
ными во всех выбранных элементах. 
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Ьа$С1азз(/7а/7?е): Ьооіеап 

Возвращает Атие, если какой-либо из выбранных элементов содержит имя класса 
пате в своем атрибуте сіазз. 

ІіеідІі{():іпі: 

ІіеідІі*(/)) 

Іі е і д Ш (/"( і сіх, си ггеп Т) : і п 1:) 

Возвращает высоту (не включая отступы, рамку и поля) первого выбранного элемен¬ 
та, или устанавливает высоту всех выбранных элементов равной А? или значению, 
вычисленному функцией А, которая вызывается как метод для каждого элемента. 

іппегНеідІі{():іп{ 

Возвращает высоту плюс отступы для первого выбранного элемента. 

іппегѴШІ{Іі():іп{ 

Возвращает ширину плюс отступы для первого выбранного элемента. 

о^5е*():соогсІ5 

о^зеі :(соогсіз) 

о^зеі .({(ісіх, сиггепТ): соогсіз) 

Возвращает координаты X и У (относительно начала документа) первого выбран¬ 
ного элемента или перемещает все выбранные элементы в позицию с координата¬ 
ми соогсіз или в позицию, вычисляемую функцией А, которая вызывается как ме¬ 
тод для каждого выбранного элемента. Координаты определяются в виде объекта 
со свойствами {ор и ІеТХ. 

оІ^зеІіРагептО :^0иегу 

Выбирает ближайшего позиционируемого предка для каждого выбранного эле¬ 
мента и возвращает результат в виде нового объекта іСЗиегу. 

оиХегНеід\)Х([тагдіпз=Та1зе]):іг\1 

Возвращает высоту плюс отступы и рамку, а также поля, если аргумент тагдіпз 
имеет значение {гие, первого выбранного элемента. 

ои{ег1л/ісЛ:И( [тагдіпз=Ха!зе] ): іп{ 

Возвращает ширину плюс отступы и рамку, а также поля, если аргумент тагдіпз 
имеет значение {гие, первого выбранного элемента. 

розі1:іоп():соогс1з 

Возвращает позицию первого выбранного элемента относительно ближайшего по¬ 
зиционируемого предка. Возвращает объект со свойствами {ор и 1е{{. 

гетоѵеАІіІ: г (ла/77е) 

Удаляет указанный атрибут из всех выбранных элементов. 

гетоѵеСІазз (патез) 
гетоѵеСІазз (?(ісіх, сиггепі) : патез) 

Удаляет указанное имя или имена классов из атрибута сіазз всех выбранных эле¬ 
ментов. Если в аргументе вместо строки передана функция, она будет вызвана как 
метод для каждого выбранного элемента, чтобы вычислить имя или имена удаляе¬ 
мых классов. 

гетоѵеОаІіа ([кеу]) 

Удаляет указанное свойство из объекта с данными в каждом выбранном элементе. 
Если имя свойства не указано, удаляется весь объект с данными целиком. 
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зсго11І_е^Т():іпт 

зсгоШе^Т(ілі-) 

Возвращает позицию горизонтальной полосы прокрутки для первого выбранного 
элемента или устанавливает ее для всех выбранных элементов. 

зсго11Тор(): іпі: 

ЗСГОІ1Тор(2ЛТ) 

Возвращает позицию вертикальной полосы прокрутки для первого выбранного 
элемента или устанавливает ее для всех выбранных элементов. 

ТоддІеСІазз (патез, [аМ]) 

Ходд1еС1азз(Х(ісІх,сиггепх):пас(\ез % [асісі]) 

Переключает класс с указанным именем или именами в свойстве сіазз каждого 
выбранного элемента. Если указана функция Т> она будет вызвана как метод для 
каждого выбранного элемента для вычисления имени или имен переключаемых 
классов. Если аргумент асісі имеет значение Тгие или ^аізе, добавит или удалит име¬ 
на классов вместо их переключения. 

ѵа1():ѵа1ие 
ѵаі (ѵаіие) 

ѵаі (Т(ісіх, сиггепХ)): ѵаіие 

Возвращает значение или состояние выбора первого выбранного элемента формы 
либо устанавливает значение или состояние выбора всех выбранных элементов 
равным значению аргумента ѵаіие или значению, вычисленному функцией Т, кото¬ 
рая вызывается как метод для каждого элемента. 

ѵасШі():іп1 

\л/ісЛ:Р(іѵ) 

шйѴс\(Т(ібх,сиггепХ)\іс\Х) 

Возвращает ширину (не включая отступы, рамку и поля) первого выбранного эле¬ 
мента либо устанавливает ширину всех выбранных элементов равной ѵ* или значе¬ 
нию, вычисленному функцией Т 9 которая вызывается как метод для каждого эле¬ 
мента. 

Методы іОиегу вставки и удаления 

Методы, описываемые здесь, вставляют, удаляют или замещают содержимое доку¬ 
мента. В сигнатурах методов, приведенных ниже, аргумент сопХепХ может быть объ¬ 
ектом ^Оиегу, строкой с разметкой НТМЬ или отдельным элементом документа, а ар¬ 
гумент ха г дет может быть объектом ]0иегу, отдельным элементом документа или стро¬ 
кой селектора. Дополнительные сведения приводятся в разделах 19.2.5 и 19.3. 

аХХег(сопХепХ) 
аТХег(?(ісІх)\сопХег)Х) 

Вставляет содержимое сопХепХ после каждого выбранного элемента или вызывает Т 
как метод и вставляет возвращаемое значение после каждого выбранного элемента. 

аррепс \(сопХепх) 
а р ре п сі ( X ( і бх , Тт 1 ): с о п1 е п1:) 

Добавляет содержимое сопХепХ в конец каждого выбранного элемента или вызыва¬ 
ет Т как метод и добавляет возвращаемое значение в конец каждого выбранного 
элемента. 

аррепбТо(ТагдеТ):]Оиегу 

Добавляет выбранные элементы в конец каждого элемента, определяемого аргу¬ 
ментом ТагдеХу копируя их, если аргумент Ха где X определяет более одного элемента. 
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ЪеТоге(сопТепТ) 

ЪеТоге(Т(ісІх):сопІеп1) 

Действует подобно методу а^*ег(), но вставляет содержимое сопТепТ перед выбран¬ 
ными элементами, а не после. 

с1опе([с^аГа=1 : аІ5е]):і0иегу 

Создает полную копию каждого выбранного элемента и возвращает новый объект 
ІОиегу, представляющий множество копий элементов. Если аргумент бата имеет 
значение Іігие, также копирует данные (включая обработчики событий), связан¬ 
ные с выбранными элементами. 

сІе1:асГ)([5еі]) 

Действует подобно методу гетоѵе( ), но не удаляет данные, связанные с отсоединен¬ 
ными элементами. 

етрИуО 

Удаляет содержимое выбранных элементов. 

Іі*т1():з*гіпд 

ЬТтЦЬШТехТ) 

іиті (Т(ібх, сиггепТ) іШтІТех*) 

При вызове без аргументов возвращает содержимое первого выбранного элемента 
в виде строки с разметкой НТМЬ. При вызове с одним аргументом устанавливает 
содержимое всех выбранных элементов равным строке ЬТтІТехТ или значению, воз¬ 
вращаемому функцией Ту которая вызывается как метод этих элементов. 

іпзегІіА^ІіегСГагреОоОиегу 

Вставляет выбранные элементы после каждого элемента, определяемого аргумен¬ 
том ТагдеТу копируя их, если аргумент ТагдеТ определяет более одного элемента. 

іг\$егіВеТоге(ТагдеТ) ^Оиегу 

Вставляет выбранные элементы перед каждым элементом, определяемым аргу¬ 
ментом ТагдеТ у копируя их, если аргумент ТагдеТ определяет более одного элемента. 

ргерепс \(сопТепТ) 
ргерепб(Т(ібх,ЬТт1):сопТепТ) 

Действует подобно методу аррепсН), но вставляет содержимое сопТепТ в начало каж¬ 
дого выбранного элемента, а не в конец. 

ргерепРТо(Гагде* 0 ' 30 иегу 

Действует подобно методу аррепс1То(), но вставляет выбранные элементы в начало 
элементов, определяемых аргументом тагдеТу а не в конец. 

гетоѵе([5еі]) 

Удаляет все выбранные элементы или все выбранные элементы, соответствующие 
селектору аеі, из документа, удаляя также все данные, связанные с ними (вклю¬ 
чая обработчики событий). Обратите внимание, что удаленные элементы исклю¬ 
чаются из состава документа, но по-прежнему остаются членами возвращаемого 
объекта ^Оиегу. 

герІасеАП (ТагдеТ) 

Вставляет выбранные элементы в документ так, что они замещают каждый эле¬ 
мент, определяемый аргументом ТагдеТу копируя выбранные элементы, если аргу¬ 
мент ТагдеТ определяет более одного элемента. 
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герІасеШІі(солгелг) 

ге р 1 ас еІ\/і1: И ( і бх, Р Ш ): с о пТе п 1: ) 

Замещает каждый выбранный элемент содержимым сопіепі или вызывает функ¬ 
цию Т как метод для каждого выбранного элемента, передавая ей индекс элемента 
и текущее содержимое в виде разметки НТМЬ, и замещает данный элемент воз¬ 
вращаемым значением. 

1ехі():зігіпд 

ХехХ(рІаіпТехТ) 

ХехЦРЦбх, сиггепХ) : рІаіпТехІ:) 

При вызове без аргументов возвращает содержимое первого выбранного элемента 
в виде строки с простым текстом. При вызове с одним аргументом устанавливает 
содержимое всех выбранных элементов равным строке рІаіпТехХ или значению, 
возвращаемому функцией Р, которая вызывается как метод этих элементов. 

ип\л/гар() 

Удаляет родителя каждого выбранного элемента, замещая его выбранным элемен¬ 
том и смежными с ним элементами. 

ѵѵгар (м гарре г) 
ѵі гар ( Т{ і с/х): \н га рре г) 

Обертывает каждый выбранный элемент, копируя обертку, если выбранных эле¬ 
ментов более одного. Если методу передана функция, она будет вызвана как метод 
для каждого выбранного элемента, чтобы вычислить обертку. Аргумент мгаррег мо¬ 
жет быть элементом, объектом ]0иегу, селектором или строкой с разметкой НТМЬ, 
но он должен определять единственный элемент-обертку. 

мгарАП (мгаррег) 

Обертывает все выбранные элементы как группу, вставляя обертку мгаррег в пози¬ 
цию первого выбранного элемента и затем копируя все выбранные элементы в эле¬ 
мент-обертку м гарре г. 

ѵігарІг\г)ег(мгаррег) 
ѵі гарі п пе г ( Т{ і бх) : \н га р ре г) 

Действует подобно методу ѵѵгар( ), но обертывает элементом мгаррег (или возвращае¬ 
мым значением функции Т) содержимое каждого выбранного элемента, а не сами 
элементы. 

Методы іОиегу для работы с событиями 

Методы в этом разделе используются для регистрации обработчиков событий и для 
возбуждения событий. Дополнительные сведения приводятся в разделе 19.4. 

еѵепТ-Туреі) 

еѵепХ-ХуреіРіеѵепХ)) 

Регистрирует Т как обработчик события типа еѵепХ-Хуре или генерирует событие 
еѵепТ-Туре. Библиотека іСЗиегу определяет следующие методы, которые действуют 
согласно этому шаблону: 


аіахСотр1е1:е( ) 

ЫіігО 

^осизіпС) 

тоіізеРсмпС) 

тоизеир() 

аіахЕггог( ) 

сІіапде() 

^осіізоіЦС ) 

тоіізеепі:ег() 

гезігеС) 

аіахЗепсК ) 

с1іск() 

кеусіоѵѵ/п () 

тоіізе1еаѵе() 

ЗСГ0І1( ) 

а^ах81аг1() 

РЫс1іск() 

кеургезз() 

тоіізетоѵеС) 

зеІесК) 

аіахЗі:ор() 

еггог() 

кеуіірС) 

тоизеоіЦ() 

зиЬтіиО 

аіахЗііссезз() 

І'осіізС) 

1оасІ() 

тоіізеоѵег() 

ііПІоасК) 
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Ыпсі (Туре, [баТа], Т(еѵепт)) 

Ыг\б(еѵепТз) 

Регистрирует Т как обработчик событий типа Туре в каждом выбранном элементе. 
Если указан аргумент баТа, он будет добавлен в объект события перед вызовом Т. 
Аргумент Туре может определять несколько типов событий и может включать про¬ 
странства имен. 

Если методу передан единственный объект, он интерпретирует его как отображе¬ 
ние типов событий в функции-обработчики и регистрирует обработчики для всех 
указанных типов событий в каждом выбранном элементе. 

сІеІедаііеСзеі, Туре , [ баТа ]. Т(еѵепТ)) 

Регистрирует Т как динамический обработчик события. Функция Т будет вызы¬ 
ваться для обработки событий типа Туре , возникающих в элементах, которые оп¬ 
ределяются селектором зеі и всплывших до любого из выбранных элементов. Ес¬ 
ли указан аргумент баТа , он будет добавлен в объект события перед вызовом Т. 

біе(Туре, [Т(еѵепТ)]) 

Отключает динамические обработчики, зарегистрированные методом 1іѵе(), со¬ 
бытий типа Туре из элементов, соответствующих селектору, использовавшемуся 
для создания текущего множества выбранных элементов. Если указана конкрет¬ 
ная функция-обработчик Т, отключает только ее. 

Иоѵег (Т(еѵепТ)) 

Иоѵег (епТег(еѵепТ), Іеаѵе(еѵепТ)) 

Регистрирует обработчики событий «тоивеепіег» и «тоивеіеаѵе» во всех выбран¬ 
ных элементах. Если указана только одна функция, она будет использована как 
обработчик обоих событий. 

1і ѵе(Туре, [ баТа ], Т(еѵепТ)) 

Регистрирует Т как динамический обработчик события типа Туре. Если указан ар¬ 
гумент баТа , он будет добавлен в объект события перед вызовом Т. Этот метод не 
используется для установки обработчиков в выбранные элементы, но он использу¬ 
ет строку селектора и контекст данного объекта ]0иегу. Функция Сбудет вызывать¬ 
ся, когда события типа Туре будут всплывать до объекта контекста (обычно объект 
йоситепі:), если целевые элементы события будут соответствовать селектору. См. 
также с!е1еда1:е(). 

опе(Туре, [баТа], Т(еѵепт)) 
опе(еѵепТз) 

Действует подобно методу Ыпс1( ), но зарегистрированные обработчики событий ав¬ 
томатически отключаются после однократного вызова. 

геас!у(^()) 

Регистрирует функцию Т, которая должна быть вызвана, когда документ будет го¬ 
тов к выполнению операций над ним, или вызывает ее немедленно, если документ 
уже готов. Этот метод не использует выбранные элементы и является синонимом 
для $(0. 

Тодд1е(Т1(еѵепТ), Т2(еѵепТ),...) 

Регистрирует обработчик события «сііск» во всех выбранных элементах, который 
циклически переключается между указанными функциями-обработчиками. 
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Тгіддег (Туре, [рагатз ]) 

Тгідде г (еѵепТ) 

Генерирует событие Туре во всех выбранных элементах, передавая рагатз обработ¬ 
чикам событий в виде дополнительных параметров. Аргумент рагатз можно опус¬ 
тить или передать в нем единственное значение или массив значений. Если пере¬ 
дать методу объект события еѵепТ , его свойство Туре будет определять тип события, 
а все остальные свойства будут скопированы в объект события, который будет пе¬ 
редан обработчикам. 

ТгіддегНапсІІегСТуре, [рагатз]) 

Действует подобно методу Тгіддег(), но не позволяет всплывать сгенерированному 
событию или вызывать действия, предусмотренные броузером по умолчанию. 

ипЫпс! {[Турё],[Т(еѵепТ)]) 

При вызове без аргументов отключает все обработчики событий, зарегистрирован¬ 
ные средствами библиотеки і(}иегу во всех выбранных элементах. При вызове 
с одним аргументом отключает все обработчики событий типа Туре во всех выбран¬ 
ных элементах. При вызове с двумя аргументами отключает функцию Т, зарегист¬ 
рированную как обработчик событий Туре во всех выбранных элементах. Аргу¬ 
мент Туре может представлять несколько типов событий и может включать про¬ 
странства имен. 

ипс1е1еда1:е() 

ипс1е1еда1:е(5еі, Туре, [Т(еѵепТ)]) 

При вызове без аргументов отключает все динамические обработчики событий во 
всех выбранных элементах. При вызове с двумя аргументами отключает динами¬ 
ческие обработчики событий типа Туре в элементах, соответствующих селектору 
зеі , которые возникают в выбранных элементах. При вызове с тремя аргументами 
отключает только обработчик Т. 

Методы іОиегу воспроизведения визуальных 
и анимационных эффектов 

Методы, описываемые ниже, воспроизводят визуальные и нестандартные анимаци¬ 
онные эффекты. Большинство из них возвращают тот же объект ]0иегу, относительно 
которого они вызывались. Дополнительные сведения приводятся в разделе 19.5. 

Параметры анимационных эффектов 

сотріеіе сіи гаіііоп еазіпд дііеііе зресіаІЕазіпд зііер 
^Оиегу.^х.оЕі 1 

Установите это свойство в значение Ігие, чтобы запретить все визуальные и анима¬ 
ционные эффекты. 

апітаі: е(ргорз, орТз) 

Воспроизводит эффект, манипулируя С88-свойствами, определяемыми объектом 
ргорз 9 в каждом выбранном элементе, используя параметры, определяемые объек¬ 
том орТз. Дополнительные сведения об обоих объектах приводятся в разделе 19.5.2. 

апіта1:е(ргор5, [ РьігаТіоп ], [еазіпд], [/()]) 

Воспроизводит эффект, манипулируя С88-свойствами, определяемыми объектом 
ргорз 9 в каждом выбранном элементе, используя указанную продолжительность 
РигаТіоп и функцию перехода еазіпд. По завершении вызывает Т как метод для ка¬ 
ждого выбранного элемента. 
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с1еаг0иеие( [(7/іа/77е="1 : х" ]) 

Очищает очередь эффектов по умолчанию или указанную очередь для каждого 
выбранного элемента. 

сіеіау (сІигаТіоп, [рпате-'Тх"]) 

Добавляет задержку с указанной продолжительностью СІигаТіоп в очередь эффек¬ 
тов по умолчанию или в указанную очередь. 

сі е ч и е ие ( [цпате -" і х" ]) 

Удаляет и вызывает следующую функцию из очереди эффектов по умолчанию или 
из указанной очереди. Обычно нет необходимости вручную удалять функции из 
очереди эффектов. 

^ас1еІп([сУигаГіол=400], [^()]) 

Та6е0иТ([сІигаТіоп=А00],[Т()]) 

Воспроизводит в течение СІигаТіоп миллисекунд эффект проявления или растворе¬ 
ния элемента, манипулируя его прозрачностью. По завершении вызывает функ¬ 
цию Ту если указана, как метод для каждого выбранного элемента. 

Тад еТо (0і/ га Ті оп, орасіТу , [/()]) 

Изменяет С88-свойство орасіііу в выбранных элементах до значения орасіТу в тече¬ 
ние указанной продолжительности сІигаТіоп . По завершении вызывает функцию Т> 
если указана, как метод для каждого выбранного элемента. 

Иіс1е() 

Ыбе(сІигаТіоп, [/()]) 

При вызове без аргументов немедленно скрывает выбранные элементы. Иначе вос¬ 
производит эффект, уменьшая размеры и непрозрачность всех выбранных элемен¬ 
тов так, что они полностью исчезают через сІигаТіоп миллисекунд. По завершении 
вызывает функцию Т 9 если указана, как метод для каждого выбранного элемента. 

вІібедот([сІигаТіоп=АОО],[Т()]) 
з 1 ід еіі р ( [би га Ті о п=А 00] ,[Т()]) 

$1ідеТодд1е([сІигаТіоп=А00],[Т()]) 

Отображает, скрывает или переключает состояние видимости каждого выбранно¬ 
го элемента, изменяя высоту в течение указанной продолжительности СІигаТіоп. По 
завершении вызывает функцию Т , если указана, как метод для каждого выбран¬ 
ного элемента. 

5І1СМ() 

зПо \н(сіигаТіоп, [/"()]) 

При вызове без аргументов немедленно отображает выбранные элементы. Иначе 
воспроизводит эффект, увеличивая размеры и непрозрачность всех выбранных 
элементов так, что они становятся полностью видимыми через СІигаТіоп миллисе¬ 
кунд. По завершении вызывает функцию Т , если указана, как метод для каждого 
выбранного элемента. 

з1:ор( [сі еаг= {а Ізе], Цитр-Т аізе]) 

Останавливает воспроизведение текущего анимационного эффекта (если таковой 
имеется) во всех выбранных элементах. Если аргумент сіеаг имеет значение {гие, 
также очищает очередь эффектов для каждого элемента. Если аргумент ^^тр имеет 
значение {гие, перед остановкой присваивает элементам конечные значения, кото¬ 
рые должны быть достигнуты в ходе воспроизведения эффекта. 
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*одд1е([$/юиД) 

Тодді е{дигаііоп, [/()]) 

Если аргумент зЬом имеет значение 1: г и е, вызывает метод $ііо\л/() для немедленнога 
отображения выбранных элементов. Если аргумент зЬом имеет значение ^аізе, вы¬ 
зывает метод Иіс1е()для немедленного скрытия выбранных элементов. Если аргу¬ 
мент зіюм опущен, переключает состояние видимости элементов. 

Если указан аргумент сІигаТіоп , переключает состояние видимости выбранных эле¬ 
ментов, манипулируя размером и прозрачностью в течение сіигатіоп миллисекунд. 
По завершении вызывает функцию Т , если указана, как метод для каждого вы¬ 
бранного элемента. 

диеие([рла/^е="1 : х"]):аггау 
диеие([дла/ие="1 : х"], Т(пех1:)) 
диеие([дла/7?е="1 : х"] 1 пемц) 

При вызове без аргументов или только с именем очереди возвращает указанную 
очередь для первого выбранного элемента. При вызове с аргументом-функцией до¬ 
бавляет Т в указанную очередь для всех выбранных элементов. При вызове с аргу¬ 
ментом-массивом замещает указанную очередь для всех выбранных элементов 
массивом функций пещ. 

Функции іОиегу поддержки архитектуры Аіах 

Большая часть функциональности библиотеки іС^иегу, имеющей отношение к под¬ 
держке архитектуры А^ах, реализована в виде вспомогательных функций, а не мето¬ 
дов. Они являются одними из наиболее сложных функций в библиотеке і()иегу. До¬ 
полнительные сведения приводятся в разделе 19.6. 

Коды состояния Ащх 

зііссезз еггог поІтодШед Тішеоиі; рагзегеггог 
Типы данных Аіах 

Іехі: Мііті хті зсгірі: ізоп ізопр 

События Аіах 

аіахбТагІ; аіахбепсі аіахЗиссезз аіахЕггог а]ахСотр1е1:е аз ахЗіор 


Параметры Аіах 




азупс 

сопіехі: 

дІоЬаІ 

ргосеззОаІа 

Нуре 

Ье^огеЗепсІ 

йаііа 

ШойШед 

зсгіріСНагзе* 

игі 

сасМе 

йаІаРіІІег 

ззопр 

зііссезз 

изегпате 

сотріеііе 

сІаіаТуре 

]зопрСа11Ьаск 

ІітеоіЦ 

хЬг 

сопііепІіТуре 

еггог 

раззѵюгй 

Ігасііііопаі 



]0иегу.а}ах(орГіол5):ХМІ_Н1:1:рРедие5І: 

Сложная, но самая универсальная функция поддержки архитектуры Д]ах, на кото¬ 
рой основаны все А^ах-утилиты в библиотеке ІОиегу. Она принимает единственный 
объект в виде аргумента, свойства которого определяют все тонкости, касающиеся 
отправки запроса и обработки ответа сервера. Наиболее типичные параметры опи¬ 
сываются в разделе 19.6.3.1, а параметры функций обратного вызова - в 19.6.3.2. 

]0иегу.а]ахЗе1:ир (орТіопз) 

Устанавливает указанные параметры как значения по умолчанию. Принимает 
тот же объект орТіопз , какой передается функции ^Оиегу.а]ах(). Указанные вами 
значения будут использоваться всеми последующими запросами, при оформле- 
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нии которых не будут явно указаны другие значения параметров. Эта функция не 
имеет возвращаемого значения. 

ІОиегу.деІ^ЗОМСіУГІ, [дата], [Т(оЬіесТ,8ТаТи8)])\ХНІН1:1:рПецие$1: 

Отправляет асинхронный запрос по адресу игі, добавляя любые данные дата. Вы¬ 
полняет синтаксический анализ полученного ответа как строки в формате ^СЖ 
и передает получившийся объект функции обратного вызова Т. Возвращает объект 
ХМ1_Н1:1:рРедиез1:, если таковой имеется, использовавшийся для выполнения запроса. 

ЗОиегу.деІіЗсгір Т(иг1, [/'(Гех^зГаГіУзШіХМІНПрРедиезі: 

Отправляет асинхронный запрос по адресу игі. При получении ответа выполняет 
его как сценарий, а затем передает текст ответа функции Т . Возвращает объект 
ХМ1_Н1:1:рРедиез1:, если таковой имеется, использовавшийся для выполнения запро¬ 
са. Позволяет выполнять междоменные запросы, но в этом случае не передает 
текст сценария функции Т и не возвращает объект ХМЫН1:1:рРедиез1:. 

ІОиегу.деЦсігІ, [дата], [Т(даТа,8ТаТі/8,хРг)], [Туре] ):ХМ1_Н1:1:рРедиез1: 

Отправляет асинхронный НТТР ОЕТ-запрос по адресу игі, добавляя данные дата, ес¬ 
ли указаны, в строку параметров запроса данного ІЖЬ-адреса. При получении отве¬ 
та интерпретирует его как данные типа Туре или в соответствии со значением заго¬ 
ловка СопТепТ-Туре ответа и выполняет его или выполняет синтаксический анализ, 
если это необходимо. В заключение передает (возможно, в разобранном виде) данные 
ответа функции обратного вызова Т вместе с кодом состояния и объектом ХМЬНПр- 
Редиезі:, использовавшимся для выполнения запроса. Этот объект ХМ1_Н1:1:рРедиез1:, 
если имеется, также является возвращаемым значением функции ]0иегу.де1:(). 

І0иегу.ро$1(ііг1, [дата], [Т(даТа,8ТаТіі8,хдг)], [Туре]) :ХМЫН1:1:рРедиезі: 

Действует подобно функции зОиегу. де*(), но выполняет не ОЕТ-запрос, а НТТР Р08Т- 
запрос. 

]Оиегу.рагат(о, [о№Шзе]):зі:гіпд 

Сериализует имена и значения свойств объекта о в формат «лѵлѵлѵ-іогт-игіепсобесі», 
пригодный для добавления в ШІЬ-адрес или для передачи в теле НТТР Р08Т-за- 
проса. Большинство функций поддержки Діах в библиотеке і(}иегу делают это ав¬ 
томатически, если получают объект в параметре дата. Если требуется выполнить 
поверхностную сериализацию объекта в стиле версии з(}иегу 1.3, во втором аргу¬ 
менте следует передать значение Тгие. 

зОиегу. рагзе^0М(Гех*-):оЬзес1: 

Выполняет синтаксический разбор текста в формате ^СЖ и возвращает получен¬ 
ный объект. Функции поддержки архитектуры Діах в библиотеке і(}иегу исполь¬ 
зуют эту функцию при запросе данных в формате ДООИ. 

Іоасі (игі, [дата], [Т(ТехТ,8ТаТи8,хРг)]) 

Отправляет асинхронный запрос по адресу игі , добавляя любые данные дата. При 
получении ответа интерпретирует его как строку с разметкой НТМЬ и вставляет 
ее в каждый выбранный элемент, замещая любое имеющееся содержимое. В за¬ 
ключение вызывает Т как метод для каждого выбранного элемента, передавая 
функции Т текст ответа, код состояния и объект ХМ1_Н1:1:рРедиез1:, использовавшийся 
для выполнения запроса. 

Если значение игі включает пробел, любой текст после пробела используется как 
селектор и в выбранные элементы вставляется только часть документа в ответе, 
которая соответствует селектору. 

В отличие от большинства функций поддержки архитектуры Азах в библиотеке 
ІСІиегу, Іоасі () является методом, а не функцией. Подобно большинству методов 
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объекта ]0иегу, возвращает объект ]0иегу, относительно которого этот метод был 
вызван. 

зегіаІігеОізТгіпд 

Сериализует имена и значения выбранных форм или элементов форм и возвраща» 
ет строку в формате «лѵлѵлѵ-іогш-игіепсобеб». 

Вспомогательные функции в библиотеке іОиегу 

Ниже перечислены различные функции и свойства (не методы), имеющиеся в библио¬ 
теке і(іиегу. Дополнительные сведения приводятся в разделе 19.7. 

]0иегу.ЬохМосІе1 

Устаревший синоним для зОиегу.зиррогТ.ЬохМосІеІ. 

]Оиегу.Ьго\л/зег 

Это свойство ссылается на объект, идентифицирующий производителя и версию 
броузера. Объект имеет свойство тэіе в броузере Іпіегпеі Ехріогег, тог і 11а - в Гіге- 
Гох, ѵ/еОкіТ - в 8аГагі и СЬготе, и орега - в Орега. Свойство ѵегэіоп содержит номер 
версии броузера. 

]0иегу.сопіаіп5(а 1 /э):Ьоо1еап 

Возвращает Ігие, если элемент а содержит элемент Ь. 

^Оиегу. с!аі:а(еіг) :с!аі:а 
]0иегу.с1а1:а(еІГ, кеу):ѵ аіие 
зОиегу.сІаіа (еіт, дата) 

ЗОиегу. с!а1:а(е2Т. кеу , ѵаіие) 

Низкоуровневая версия метода сІаіаО. При вызове с единственным элементом еіт 
возвращает объект с данными для этого элемента. При вызове с элементом еіт 
и строкой кеу возвращает значение с указанным именем из объекта с данными для 
этого элемента. При вызове с элементом еіт и объектом дата устанавливает указан¬ 
ный объект как объект с данными для элемента еіт. При вызове с элементом еіт, 
строкой кеу и значением ѵаіие устанавливает значение с указанным именем в объ¬ 
екте с данными для указанного элемента. 

ІОиегу.дециеие(еІТ, [рла/т?е="1 : х"]) 

Удаляет и вызывает первую функцию из указанной очереди. То же, что и $(е11). 
сіедиеие(дпате). 

]Оиегу.еасМ(о, Т (пате, ѵаіие)) \о 
]Оиегу.еасМ(а, Т(іпдех,ѵаіие)) \а 

Вызывает функцию Т для каждого свойства объекта о, передавая ей имя пате и зна¬ 
чение ѵаіие свойства, при этом функция Т вызывается как метод значения ѵаіие. 
Если первый аргумент является массивом или объектом, подобным массиву, вы¬ 
зывает Т как метод для каждого элемента массива, передавая ей в виде аргументов 
индекс іпдех в массиве и значение ѵаіие элемента. Итерации останавливаются, как 
только Т вернет Шэе. Эта функция возвращает первый аргумент. 

]0иегу.еггог(/т?5р) 

Возбуждает исключение с сообщением тзд. Эту функцию можно вызывать из рас¬ 
ширений или переопределить ее для нужд отладки (например, ]Оиегу.еггог = аіегі). 

]Оиегу.ехТепд(оЬд):оЪ]есТ 

20иегу.ехТеп6([деер=Та1ве], ТагдеТ, оЦ...):оЪ]есТ 

При вызове с одним аргументом копирует свойства объекта о/у в глобальное про¬ 
странство имен библиотеки і(}иегу. При вызове с двумя и более аргументами копи- 
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рует свойства второго и всех последующих объектов, в указанном порядке, в объ¬ 
ект ТагдеТ. Если необязательный аргумент сіеер имеет значение Ігие, выполняется 
глубокое копирование и свойства копируются рекурсивно. Возвращает объект, 
который был дополнен новыми свойствами. 

І0иегу.д1оЬа1Еѵа1(сос(е):ѵоісі 

Выполняет программный код соде на языке ^ѵаЗсгірі, как сценарий верхнего 
уровня в теге <зсгірі>. Ничего не возвращает. 

]Оиегу.дгер(а, Г(е11:,ідх):ЪооІеап, [іпѵегТ= 1а1зе]):аггау 

Возвращает новый массив, содержащий только элементы, для которых Т вернет 
Ігие. Или, если аргумент іпѵегТ имеет значение ігие, возвращает только элементы, 
для которых Т вернет Іаізе. 

]Оиегу.іпАггау(ѵ, а): іпііедег 

Выполняет поиск элемента \/ в массиве а или в объекте, подобном массиву, и воз¬ 
вращает индекс найденного элемента или -1. 

]0иегу. ізАггау(х) : Ьооіеап 

Возвращает Ігие, только если х является истинным массивом. 

]0иегуЛзЕтр1у0Ь]ес1(х):Ьоо1еап 

Возвращает Ігие, только если х не содержит перечислимых свойств. 
І0иегу.ізРипс1іоп(х):Ьоо1еап 

Возвращает Ігие, только если х является функцией. 

]0иегуЛзР1аіп0Ьіес1(х):Ьоо1еап 

Возвращает Ігие, только если х является простым объектом, например, создан¬ 
ным с помощью литерала объекта. 

]0иегу.ізХМЮос(х):1гие 

Возвращает Ігие, только если х является ХМЬ-документом или элементом ХМЬ- 
доку мента. 

]Оиегу.такеАггау(а):аггау 

Возвращает новый массив, содержащий те же элементы, что и объект а, подобный 
массиву. 

]Оиегу.тар(а, Т(е1Т, ідх))\ аггау 

Возвращает новый массив, содержащий значения, возвращаемые функцией /"для 
каждого элемента в массиве а (или в объекте, подобном массиву). Значения пиіі, 
возвращаемые функцией Т, игнорируются и не включаются в результирующий 
массив. 

]Оиегу.шегде(а,Ь):аггау 

Добавляет элементы массива Ь в конец массива а и возвращает а. Аргументы могут 
быть объектами, подобными массивам, или истинными массивами. 

]0иегу.поСоп11іс1([гас/іса1=1а1зе]) 

Восстанавливает значение символа $ в значение, которое он имел перед загрузкой 
библиотеки і(іиегу, и возвращает ]0иегу. Если аргумент гадісаі имеет значение 
Ігие, также восстанавливает значение символа ]0иегу. 

]Оиегу.ргоху(^, о):1ипс!іоп 
]Оиегу.ргоху(о, ла/т?е):1ипс!іоп 

Возвращает функцию, которая вызывает Т как метод объекта о, или функцию, ко¬ 
торая вызывает о[пате ] как метод объекта о. 
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]Оиегу.диеие(еіТ, [дла/ие-'Рх"], [Р]) 

Возвращает или создает очередь с указанным именем в элементе еІТ или добавляет 
новую функцию Т в эту очередь. То же, что и .циеие^пате, Т). 

]0иегу.гетоѵе0а1:а(еіГ І [ла/т?е]):ѵоіс! 

Удаляет указанное свойство из объекта с данными в элементе еіі или удаляет сам 
объект с данными. 

]0иегу.зиррог1: 

Объект, содержащий множество свойств, описывающих особенности и ошибки, 
имеющиеся в текущем броузере. В основном представляет интерес для создателей 
расширений. В броузерах ІЕ свойство іОиегу.зиррогі.ЬохМосІеІ имеет значение Раізе 
при выполнении сценария в режиме совместимости. 

]0иегу.1:гіт(5):з1:гіпд 

Возвращает копию строки з, из которой удалены начальные и завершающие про¬ 
бельные символы. 

КеуЕѵепі 

см. Еѵепі 

І_аЬеІ 

тег <1аЬе1> для элементов форм Мойе, Еіетепі 

Объект І_аЬе1 представляет тег <1аЬе1> в НТМЬ-форме. 

Свойства 

геасіопіу ЕІетепР сопігоі 

Объект РогтСопРгоІ, с которым связан данный объект І_аЬе1. Если определено свой¬ 
ство ІгітІРог, данное свойство будет ссылаться на элемент формы, определяемый 
свойством ІгітІРог. Иначе это свойство будет ссылаться на первый дочерний эле¬ 
мент РогтСопРгоІ данного элемента <1аЬе1>. 

геасіопіу Рогт Рогт 

Ссылается на элемент Рогт, содержащий эту метку. Или, если установлен НТМЬ- 
атрибут Рогт, на элемент Рогт, атрибут ісі которого имеет указанное в этом свойстве 
значение. 

зігіпд йітІРог 

Это свойство соответствует НТМЬ-атрибуту Рог. Поскольку Рог в языке ^ѵаЗсгірі 
является зарезервированным словом, к имени этого свойства добавлен префикс 
«Мті», чтобы получился допустимый идентификатор. Если установлено, это свой¬ 
ство должно определять значение атрибута ісі элемента РогтСопРгоІ, с которым свя¬ 
зана данная метка. (Однако обычно проще вложить элемент РогтСопРгоІ в элемент 
І_аЬе1.) 

Ыпк 

гиперссылка в НТМ(.-документе Мойе, Еіетепі 

Ссылки в НТМЬ-документе создаются элементами <а>, <агеа> и <1іпк>. Теги <а> исполь¬ 
зуются в теле документа для создания гиперссылок. Теги <агеа> - это редко исполь¬ 
зуемая возможность, позволяющая создавать «карты изображений». Теги <1іпк> ис¬ 
пользуются в разделе <Меас1> документа для указания адреса внешних ресурсов, таких 
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как таблицы стилей и ярлыки. Элементы <а> и <агеа> в сценариях на языке ^ѵаВсгірі 
имеют одинаковое представление. Элементы <1іпк> имеют несколько иное представле¬ 
ние, но для удобства эти два типа ссылок описываются в одной справочной статье. * 

Когда объект І_іпк, представляющий элемент <а>, используется в строковом контексте, 
он возвращает значение своего свойства Мгеі". 

Свойства 

В дополнение к свойствам, перечисленным ниже, объект Ипк также имеет свойства, 
соответствующие НТМЬ-атрибутам: ІігеТІапд, тесііа, ріпд, геі, зігез, Тагдеі: и Туре. Обра¬ 
тите внимание, что свойства, соответствующие отдельным компонентам ТШЬ-адреса 
(такие как Розі: и раііітате) и возвращающие фрагменты значения свойства Гігеі" ссыл¬ 
ки, определены только для элементов <а> и <агеа> и отсутствуют в элементах <1іпк>, 
и что свойства зРееІ:, сІізаЫесІ и геНізІі определены только в элементах <1іпк>, ссылаю¬ 
щихся на таблицы стилей. 

Рооіеап РізаЫесІ 

Для элементов <1іпк>, ссылающихся на таблицы стилей, определяет, должна ли 
данная таблица стилей применяться к документу. 

зіігіпд ЬазЬ 

Определяет идентификатор фрагмента документа в значении свойства Ргеі 1 , вклю¬ 
чая начальный символ решетки (#), например: «#гези1І8». 

зіігіпд Иоз* 

Определяет имя хоста и порт в значении свойства И геі 1 , например: *НЫр://и)и)іѵ.огеіІ- 
Іу.сот:1234 ». 

зіігіпд Иоз^паше 

Определяет имя хоста в значении свойства ЪгеТ, например: *Мір://иш)и).огеіІІу.сотп*. 
зіігіпд Иге? 

Определяет значение атрибута Ііге^ ссылки. Когда элемент <а> или <агеа> использу¬ 
ется в строковом контексте, возвращается значение этого свойства. 

зіігіпд распалю 

Определяет путь к документу в значении свойства Іігеі 1 , например: «/ саіаіоё/зеагск . 
кіті ». 

зіігіпд рог* 

Определяет порт в значении свойства Иге*, например: «1234». 
зіігіпд рго*осо1 

Определяет имя протокола в значении свойства Мгеі, включая завершающее двое¬ 
точие, например: «Мір:». 

геасіопіу 00МТокепІ_і5Іі геШзі 

Подобно свойству с1аззІ_із1і объекта Еіетепі это свойство упрощает извлечение, до¬ 
бавление и удаление лексем в НТМЬ-атрибуте геі элементов <1іпк>. 

зіігіпд зеагсй 

Определяет строку с параметрами запроса в значении свойства Мге*, включая на¬ 
чальный знак вопроса, например: «?ц=^ѵа8сгірі&т=10». 

геасіопіу СЗЗЗііуІеЗМееІі з&ее* 

Для элементов <1іпк>, ссылающихся на таблицы стилей, это свойство представля¬ 
ет связанную таблицу стилей. 
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зігіпд Тех* 

Простое текстовое содержимое элемента <а> или <агеа>. Синоним для свойства 

МосІе.ТехТСопТепІ:. 

зігіпд Шіе 

Все НТМЬ-элементы имеют атрибут ТіТІе, который обычно определяет текст всплы¬ 
вающей подсказки для элемента. С помощью этого атрибута или свойства элемен¬ 
та <1іпк>, в котором атрибут геі имеет значение «аііегпаіе віуІевЬееі», можно ука¬ 
зать имя таблицы стилей, применение которой пользователь может разрешить 
или запретить, и если броузер поддерживает альтернативные таблицы стилей, 
значение свойства Шіе может отображаться в интерфейсе броузера в некоторым 
оформлении. 

І-осаІіоп 

представляет адрес в броузере и управляет им 

Свойство Іосаііоп объектов Иіпсісм и йоситепі: ссылается на объект І_оса1:іоп, который 
представляет веб-адрес («местоположение») текущего документа. Свойство Пге* содер¬ 
жит полный ШІЬ-адрес этого документа, а каждое из оставшихся свойств объекта 
І_оса1:іоп описывает фрагмент этого ШІЬ-адреса. Эти свойства очень похожи на свойст¬ 
ва ХЖЬ-адреса объекта 1_іпк. Когда объект 1_оса1:іоп используется в строковом контек¬ 
сте, возвращается значение его свойства иге?. Это означает, что вместо выражения 
Іосаііоп.Пгеі можно использовать просто Іосаііоп. 

Кроме того что объект І_оса*іоп представляет текущий ШІЬ-адрес, он еще и управляет 
этим адресом. Если строку, содержащую ШІЬ-адрес, присвоить объекту І_оса1:іоп или 
его свойству Нгеі, то веб-броузер загрузит документ с указанным ШІЬ-адресом и ото¬ 
бразит его. Заставить броузер загрузить новый документ можно также путем измене¬ 
ния части текущего ШІЬ-адреса. Например, если установить свойство зеагсН, броузер 
перезагрузит текущий ШІЬ-адрес с новой строкой запроса. Если установить свойство 
ПазП, броузер не загрузит новый документ, но создаст новую запись в истории посеще¬ 
ний. А если свойство НазН идентифицирует некоторый фрагмент документа, броузер 
прокрутит документ так, что указанный элемент окажется в видимой области. 

Свойства 

Свойства объекта 1_оса1:іоп ссылаются на различные фрагменты ШІЬ-адреса текущего 
документа. Для каждого из следующих свойств дается пример фрагмента следующе¬ 
го (фиктивного) ШІЬ-адреса: 

Пир \//ш\н. огеіііу. сот: 1234/са1:а1од/5еагсН. Ніт1?д^аѵаЗсгірі&т=10#гези11:5 
зиіпд ПазП 

Содержит якорную часть ШІЬ-адреса, включая начальный символ решетки (#), 
в нашем случае - «#ге8и1І8». Эта часть ШІЬ-адреса документа определяет имя 
якорного элемента внутри документа. 

зиіпд Поз* 

Часть ШІЬ-адреса, содержащая имя хоста и порт, например: *Мір://и)іѵи).огеіІІу. 
сот:1234*. 

зігіпд Ноз*пате 

Часть ШІЬ-адреса, содержащая имя хоста, например: «Ьир://\ѵлѵлѵ.огеі11у.сот». 
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зТгіпд Иге* 

Полный текст ІШЬ-адреса документа, в отличие от других свойств объекта 1_оса- 
ііоп, которые определяют только части ШІЬ-адреса. Присваивание этому свойст¬ 
ву нового ШІЬ-адреса приводит к тому, что броузер читает и отображает содержи¬ 
мое нового ШІЬ-адреса. Непосредственное присваивание объекту І_осаі:іоп уста¬ 
навливает это свойство, и при использовании объекта І-осаііоп в строковом контек¬ 
сте возвращается значение этого свойства. 

зігіпд ра*Ипате 

Путь в ШІЬ-адресе, например: «/саіаІоЕ/зеагсЬ.ЬітІ». 
зТгіпд рог* 

Порт в ІІКЬ-адресе, например: «1234». Обратите внимание, что значением этого 
свойства является строка, а не число. 

зігіпд ргоіосоі 

Протокол в ІІКЬ-адресе, включая завершающее двоеточие, например: «Мір:». 
зігіпд зеагсіі 

Часть ШІЬ-адреса, которая содержит строку запроса, включая начальный вопро¬ 
сительный знак, например: «?д=^аѵаВсгірі&т=10». 

Методы 

ѵоісі аззідпСзігіпд игі) 

Загружает и отображает содержимое адреса игі, как если бы значение игі было 
присвоено свойству Іігеі. 

ѵоісі геІоасК) 

Повторно загружает текущий документ, 
ѵоісі герІасеСзігіпд игі ) 

Загружает и отображает содержимое адреса игі, замещая текущий документ в ис¬ 
тории посещений, вследствие чего щелчок на кнопке Васк броузера не вернет его 
к предыдущему документу. 

МесІіаЕІетепі 

элемент проигрывателя Мойе, Еіетепі 

МесІіаЕІетепі: является общим суперклассом для элементов <аис!іо> и <ѵіс!ео>. Эти два 
элемента определяют практически идентичные прикладные интерфейсы, описывае¬ 
мые здесь, тем не менее просмотрите справочные статьи Аисііо и Ѵісіео, где приводится 
описание дополнительных особенностей аудио- и видеопроигрывателей. Л также об¬ 
ратитесь к разделу 21.2, где дается введение в эти мультимедийные элементы. 

Константы 

Константы МЕТІлЮНК определяют возможные значения свойства пеіѵюгкЗіаіе, а констан¬ 
ты НАѴЕ - возможные значения свойства геасІуЗіаіе. 

ипзідпесі зИог* МЕТМОНК_ЕМРТѴ = О 

Элемент еще не приступил к использованию сети. Это состояние предшествует ус¬ 
тановке атрибута зге. 

ипзідпесі зМогТ НЕТМ0НК_10ЬЕ = 1 

В настоящий момент элемент не производит загрузку данных из сети. Возможно, 
он уже загрузил ресурс полностью или загрузил необходимый объем данных в бу- 





988 


Справочник по клиентскому ІаѵаБсгірІ: 


фер. Или, возможно, свойство ргеіоасі установлено в значение «попе», и пока не бы¬ 
ла запрошена загрузка или проигрывание данных. 

ипзідпесі зіюгі: МЕТМОНК.ЮАОІНа = 2 

В настоящее время элемент загружает данные из сети, 
ипзідпесі зіюгі: МЕТѴЮНК_НО_$ОиНСЕ = 3 

Элемент не использует сеть, потому что не способен отыскать источник с данными 
для проигрывания. 

ипзідпесі зМогі: НАѴЕ_МОТНІМС = О 

Мультимедийные данные или метаданные еще не были загружены, 
ипзідпесі зМогі: НАѴЕ_НЕТАОАТА = 1 

Метаданные были загружены, но данные для текущей позиции проигрывания 
еще не были загружены. Это означает, что можно узнать продолжительность или 
размеры кадра видеозаписи, а также перейти к другой позиции проигрывания, 
изменив значение свойства сиггепіТіте, но броузер в настоящее время не проигры¬ 
вает данные в позиции сиггепіТіше. 

ипзідпесі зіюгі: НАѴЕ_СиНРЕМТ_ОАТА = 2 

Данные для текущей позиции проигрывания сиггепіТіше были загружены, но дан¬ 
ных пока недостаточно, чтобы можно было начать проигрывание. Для видеозапи¬ 
сей это обычно означает, что текущий кадр уже загружен, а следующий - еще нет. 
Это состояние возникает в конце аудио- или видеозаписи. 

ипзідпесі зіюгі: НАѴЕ_РІГГиНЕ_ОАТА = 3 

Загружен объем данных, достаточный, чтобы начать проигрывание, но, скорее 
всего, недостаточный, чтобы проиграть запись до конца без приостановки для за¬ 
грузки дополнительных данных. 

ипзідпесі зіюгі: НАѴЕ_ЕМОиСН_ОАТА = 4 

Загружен объем данных, достаточный, чтобы броузер смог проиграть запись до 
конца без приостановки. 

Свойства 

Ьооіеап аЩорІау 

Если имеет значение ігие, проигрыватель автоматически начнет проигрывание, 
когда будет загружен достаточный объем данных. Соответствует НТМЬ-атрибуту 

аиіоріау. 

геасіопіу ТітеРапдез Ьи^егесі 

Фрагменты уже загруженных в буфер данных. 

Ьооіеап соп^гоіз 

Если имеет значение ігие, проигрыватель должен отобразить элементы управле¬ 
ния проигрыванием. Соответствует НТМЬ-атрибуту сопігоіз. 

геасіопіу зігіпд сиггеп*$гс 

ІШЬ-адрес мультимедийных данных, полученный из атрибута зге или из одного 
из дочерних элементов <зоигсе>, или пустая строка, если данные для проигрыва¬ 
ния не указаны. 

сІоиЬІе сиггеп^Тіте 

Текущая позиция проигрывания в секундах. Установка этого свойства позволяет 
перейти к другой позиции проигрывания. 
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сІоиЫе йе?аи11Р1ауЬаскЯаІе 

Скорость проигрывания, используемая при проигрывании в нормальном режиме. 
Значение по умолчанию 1.0. 

геасіопіу ЬоиЫе (Іигаіііоп 

Продолжительность записи в секундах. Если продолжительность неизвестна (на¬ 
пример, когда метаданные еще не были загружены), это свойство имеет значение 
Если проигрываются потоковые данные с неопределенной продолжительно¬ 
стью, это свойство имеет значение ІітГіпіііу. 

геасіопіу Ьооіеап епсіесі 

Имеет значение Тгие, если достигнут конец записи, 
геасіопіу МесІіаЕггог еггог 

Это свойство устанавливается, когда возникает ошибка, в противном случае имеет 
значение пиіі. Ссылается на объект, свойство сосіе которого описывает тип ошибки. 

геасіопіу ЬоиЫе іпі*іа1Тіте 

Начальная позиция проигрывания в секундах. Обычно имеет значение 0, но в не¬ 
которых случаях (например, когда проигрываются потоковые данные) может 
иметь различные значения. 

Ьооіеап Іоор 

Если имеет значение Тгие, проигрыватель должен автоматически перезапускать 
воспроизведение записи по достижении конца. Это свойство соответствует НТМЬ- 
атрибуту Іоор. 

Ьооіеап ти*е<1 

Определяет, должна ли воспроизводиться запись без звука. Это свойство можно 
использовать, чтобы отключать и включать звук. Для элементов <ѵіс!ео> можно ис¬ 
пользовать атрибут аисІіо-’тиІесГ, чтобы отключить звук по умолчанию. 

геасіопіу ипзідпесі зЬогІ: пе*иогк$*а*е 

Определяет, загружаются данные в настоящий момент или нет. Допустимые зна¬ 
чения перечислены в разделе «Константы» выше. 

геасіопіу Ьооіеап раизей 

Имеет значение {гие, если в настоящий момент проигрывание приостановлено. 
СІоиЫе рІауЬаскЯаіе 

Текущая скорость проигрывания. 1.0 - нормальная скорость проигрывания. Зна¬ 
чения больше 1.0 соответствуют ускоренной скорости проигрывания вперед. Зна¬ 
чения от 0 до 1.0 соответствуют замедленной скорости проигрывания вперед. Зна¬ 
чения меньше 0 соответствуют проигрыванию в обратном направлении. (Звук все¬ 
гда отключается при проигрывании в обратном направлении, а также при слиш¬ 
ком быстром или слишком медленном проигрывании вперед.) 

геасіопіу ТітеРапдез ріауей 

Фрагменты, которые уже были проиграны, 
зіігіпд ргеІоаЬ 

Это свойство соответствует НТМЬ-атрибуту с тем же именем, и его можно использо¬ 
вать, чтобы указать, какой объем данных должен загрузить броузер, прежде чем 
пользователь сможет запустить проигрывание. Значение «попе» означает, что пред¬ 
варительная загрузка данных не должна выполняться. Значение «теіасіаіа» озна¬ 
чает, что броузер должен предварительно загрузить метаданные (такие как продол¬ 
жительность), но не фактические данные. Значение «аиіо» (или просто пустая стро- 
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ка, если атрибут ргеіоасі указан без значения) означает, что броузер может загру¬ 
зить весь ресурс целиком на тот случай, если пользователь решит проиграть его. 

геасіопіу ипзідпесі зіюгі: геайуЗТаіе 

Определяет готовность данных к проигрыванию, исходя из объема данных, загру¬ 
женных в буфер. Допустимые значения определяются константами НАѴЕ_, описан¬ 
ными выше. 

геасіопіу ТітеРапдез зеекаЫе 

Фрагмент или фрагменты, значения времени для которых могут быть присвоены 
свойству сиггепШте. При проигрывании простых файлов обычно можно устано¬ 
вить любое значение от 0 до значения свойства сіи га! іо п. Но для потоковых данных 
позиция в прошлом может отсутствовать в буфере, а позиция в будущем может 
быть еще недоступна. 

геасіопіу Ьооіеап зеекіпд 

Имеет значение Ігие, пока элемент проигрывателя выполняет переход к новой по¬ 
зиции проигрывания сиггепШте. Если данные для новой позиции проигрывания 
уже загружены в буфер, это свойство будет иметь значение Ігие очень короткий 
промежуток времени. Но если для перехода проигрывателю необходимо загрузить 
новые данные, свойство зеекіпд будет оставаться в значении ігие довольно продол¬ 
жительное время. 

зігіпд зге 

Соответствует НТМЬ-атрибуту зге элемента проигрывателя. Присваивание нового 
значения этому свойству заставит проигрыватель загрузить новые данные для 
проигрывания. Не путайте это свойство со свойством сиггепіЗгс. 

геасіопіу йаіе зіагіО^зеіТіте 

Действительные дата и время позиции проигрывания 0, если метаданные содер¬ 
жат такую информацию. (Видеофайл может содержать время съемки, например.) 

сІоиЫе ѵоіите 

Определяет уровень громкости воспроизводимой аудиозаписи. Значение должно 
быть в диапазоне от 0 до 1. См. также описание свойства гтшіесі. 

Обработчики событий 

Теги <аис!іо> и <ѵіс!ео> определяют следующие обработчики событий, которые можно 
устанавливать как НТМЬ-атрибуты или как ЛѵаЗсгірі-свойства. На момент написа¬ 
ния этих строк некоторые броузеры не поддерживали эти свойства и требовали, что¬ 
бы обработчики событий регистрировались с помощью метода асІсІЕѵепіІлзіепегО 
(ЕѵепіТагдеІ:). События элементов проигрывателей не всплывают, и для них не преду¬ 
смотрено действий по умолчанию, которые можно было бы отменить. Связанные с ни¬ 
ми объекты событий являются обычными объектами Еѵепі. 


Обработчик 

событий 

опаЬоП 


Вызывается, когда... 


Элемент прекратил загрузку данных, вероятно, по запросу пользовате¬ 
ля. Свойство еггог.сосіе имеет значение еггог.МЕОІА ЕРР АВОРТЕЭ. 


опсапріау Загружено достаточно данных, чтобы начать проигрывание, но навер¬ 

няка потребуется загрузка дополнительных данных. 

опсапрІауіПгоидІі Загружено достаточно данных, чтобы проигрывание не приостанавли¬ 
валось на загрузку дополнительных данных. 


опсіигаііопсііапде 


Изменилось значение свойства сіигаііоп. 
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Обработчик 

событий 

опетріііесі 


Вызывается, когда... 


Свойство пе*ѵюгк$*а*е получило значение МЕТІлЮРК_ЕМРТѴ вследствие 
ошибки или остановки проигрывателя. 


опепсіесі 


Проигрывание остановлено по достижении конца записи. 


опеггог 


Сетевая или какая-то другая ошибка препятствует загрузке данных. 
Свойство еггог.сосіе имеет значение, отличное от МЕ01А_ЕРР_АВ0РТЕ0 (Месііа- 
Еггог). 


опІоасЗесІсІаІіа 


Данные для текущей позиции проигрывания загружены в первый раз. 


опіоасіесітеііасіаііа 

опІоасІБІіагі: 

опраіізе 

опріау 


Были загружены метаданные, и стали доступны продолжительность 
и размеры кадра. 

Элемент послал запрос на загрузку данных. 

Был вызван метод раіізе( ), и проигрывание было приостановлено. 

Был вызван метод р1ау(), или атрибут аіііоріау вызвал запуск проигры¬ 
вания. 


опріауіпд 

опргодгезз 


опгаІесИапде 

опзеекесі 

опзеекіпд 


опзііаііесі 

опзіізрепсі 

опііітеирсіаііе 

опѵоІіітесПапде 


Данные проигрываются. 

Загрузка данных из сети продолжается. Обычно генерируется от 2 до 8 
раз в секунду. Обратите внимание, что объект, связанный с этим собы¬ 
тием, является обычным объектом Еѵепі:, а не РгодгеззЕѵепі:, используе¬ 
мым другими прикладными интерфейсами, которые возбуждают собы¬ 
тия с именем «рго&гевв». 

Изменилось значение свойства рІауЬаскРаіе или сіеі'аііІІіРІауЬаскРаІіе. 
Свойство зеекіпд опять получило значение Шзе. 

Сценарий или пользователь потребовал выполнить переход к позиции 
проигрывания, для которой данные еще не были загружены, вследствие 
чего проигрывание было приостановлено до загрузки данных. Свойство 
зеекіпд имеет значение Тгие. 

Элемент пытается загрузить данные, но данные не поступают. 

Элемент загрузил в буфер достаточно большой объем данных и времен¬ 
но приостановил загрузку. 

Изменилось значение свойства сііггепШте. При обычном проигрывании 
это событие возбуждается от 4 до 60 раз в секунду. 

Изменилось значение свойства ѵоіііте или тіііесі. 


опмаШпд 


Проигрывание не может быть начато, или проигрывание было приоста¬ 
новлено из-за недостаточного объема буферизованных данных. Когда бу¬ 
дет загружен достаточный объем данных, последует событие «р1ауіп&». 


Методы 

зігіпд сапР1ауТуре(зі:гіпд Туре) 

Этот метод запрашивает у элемента проигрывателя, способен ли он проигрывать 
данные МІМБ-типа Туре. Если проигрыватель точно определит, что не может про¬ 
игрывать данные указанного типа, он вернет пустую строку. Если проигрыватель 
полагает (но не уверен), что может проигрывать данные указанного типа, он вер¬ 
нет строку «ргоЪаЫу* («возможно»). В общем случае элементы проигрывателя ни¬ 
когда не вернут строку «ргоЪаЫу», если Туре не включает параметр сос!есз= со спи- 
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ском мультимедийных кодеков. Если проигрыватель не уверен, что может проиг¬ 
рывать данные указанного типа, этот метод вернет строку «тауЪе». 

ѵоісі 1оас1() 

Этот метод сбрасывает элемент проигрывателя в исходное состояние и заставляет 
его выбрать источник данных и начать загрузку. Это происходит автоматически, 
когда элемент впервые вставляется в документ, и всякий раз, когда изменяется 
значение атрибута 8гс. Однако при добавлении, удалении или изменении вложен¬ 
ных элементов <8оигсе> метод 1оас1() необходимо вызывать явно. 

ѵоісі раизе() 

Приостанавливает проигрывание, 
ѵоісі р1ау() 

Начинает проигрывание записи. 

МесііаЕггог 

представляет ошибку в элементе <аиі!іо> или <ѵі<Іео> 

Когда в элементе <аис!іо> или <ѵіс!ео> возникает ошибка, генерируется событие «еггог» 
и в свойстве еггог объекта события обработчику передается объект МесііаЕггог. Свойст¬ 
во сосіе этого объекта определяет тип возникшей ошибки. Возможные значения этого 
свойства определяют приведенные ниже константы. 

Константы 

ипзідпесі зМогі МЕ01А_ЕВВ_АВ0ВТЕ0 = 1 

Пользователь остановил загрузку данных, 
ипзідпесі зііогі МЕОІА.ЕВВ^ЕТМОВК = 2 

Мультимедийные данные имеют корректный тип, но сетевая ошибка препятству¬ 
ет их загрузке. 

ипзідпесі зИогТ МЕ01А_ЕВВ_0ЕС00Е = 3 

Мультимедийные данные имеют корректный тип, но ошибка кодирования пре¬ 
пятствует их декодированию и проигрыванию. 

ипзідпесі зііогі МЕ01А_ЕВВ_$ВС_М0Т.$11РР0ВТЕ0 = 4 

Тип мультимедийных данных, на которые ссылается атрибут зге, не поддержива¬ 
ются броузером. 

Свойства 

геасіопіу ипзідпесі зИогТ сосіе 

Это свойство описывает тип возникшей ошибки. Его значением может быть одна 
из констант, перечисленных выше. 

МеззадеСНаппеІ 

пара соединенных объектов Ме$$адеРогі$ 

Объект МеззадеСМаппеІ представляет пару соединенных друг с другом объектов Мезза- 
деРогі. Вызов метода розіМеззадеО в любом из них сгенерирует событие «тезза&е* 
в другом. Если в программе потребуется создать частный канал связи с окном Міпсіом 
или фоновым потоком выполнения Могкег, можно создать объект МеззадеСМаппеІ и за¬ 
тем передать один объект МеззадеРогі из этой пары окну или потоку выполнения (ис¬ 
пользуя аргумент роПз метода розіМеззадеО). 
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Типы МеззадеСМаппеІ и МеззадеРогІ: являются нововведением, появившимся в специфи¬ 
кации НТМЬб, и на момент написания этих строк некоторые броузеры поддерживали 
меж доменный обмен сообщениями (раздел 22.3) и фоновые потоки выполнения (раз¬ 
дел 22.4) без применения частных каналов связи на основе объектов МеззадеРогІ:. 

Конструктор 

пем МеззадеСЬаппеІО 

Этот конструктор, не имеющий аргументов, возвращает новый объект Меззаде- 
СМаппеІ. 

Свойства 

геасіопіу МеззадеРогІ: рогМ 
геасіопіу МеззадеРогІ: рог*2 

Два соединенных друг с другом порта, образующих канал обмена данными. Оба 
порта являются совершенно равноценными: достаточно просто один сохранить 
в своем программном коде, а другой передать окну ілііпсіом или фоновому потоку вы¬ 
полнения Могкег, с которым требуется организовать обмен данными. 

МеззадеЕѵепІ 

сообщение из другого контекста выполнения Еѵепі 

Различные прикладные интерфейсы используют события «тезза^е» для организации 
асинхронных взаимодействий между независимыми контекстами выполнения. Все 
объекты - ілііпсіоѵі/, Могкег, МеЬЗоскеІ:, ЕѵепіЗоигсе и МеззадеРогІ: - определяют свойство 
оптеззаде для регистрации обработчика события «тезза^е». Сообщение, связанное 
с событием «тезза&е», может быть любым значением, допустимым в языке ^ѵаВсгірІ, 
которое можно скопировать, как описывается во врезке «Структурированные копии» 
в главе 22. Сообщение заключается в объект МеззадеЕѵепІ: и доступно в виде свойства 
сіаіа. Различные прикладные интерфейсы, опирающиеся на событие «тезза&е», могут 
определять дополнительные свойства в объекте МеззадеЕѵепІ:. События «тезза&е» не 
всплывают, и для них не предусмотрено действий по умолчанию, которые можно было 
бы отменить. 

Свойства 

геасіопіу апу Раіа 

Это свойство хранит доставленное сообщение. Свойство сІаТа может иметь значение 
любого типа, которое можно скопировать с применением алгоритма структуриро¬ 
ванного копирования (врезка «Структурированные копии» в главе 22). К ним от¬ 
носятся значения базового ^ѵаЗсгірі, включая объекты и массивы, но не функ¬ 
ции. Некоторые значения клиентского Лѵабсгірі, такие как узлы Ооситепі: 
и Еіетепі:, не могут передаваться, но могут передаваться объекты ВІоЬ и АггауВиІ^ег. 

геасіопіу зігіпд ІазіЕѵепІІР 

Для событий «тезза^е» в интерфейсе ЕѵепіЗоигсе (раздел 18.3) это поле содержит 
строку ІазіЕѵепІІсІ, если имеется, отправленную сервером. 

геасіопіу зігіпд огідіп 

Для событий «тезза&е» в интерфейсах ЕѵепіЗоигсе (раздел 18.3) или іл/іпсіом (раз¬ 
дел 22.3) это свойство содержит ІІКЬ-адрес отправителя сообщения. 




994 


Справочник по клиентскому ІаѵаБсгірІ: 


геасіопіу МеззадеРогіП рогіз 

Для событий «теввазе» в интерфейсах Міпсіоѵ»/ (раздел 22.3), Могкег (раздел 22.4) 
и МеззадеРогІ это свойство содержит массив объектов МеззадеРогІ, если он был пере; 
дан соответствующему вызову розіМеззадеО. 

геасіопіу Міпсіоѵі/ зоигсе 

Для событий «тевва&е» в интерфейсе Ѵ\/іпсЗоѵѵ (раздел 22.3) это свойство ссылается 
на объект Міпсіом, отправивший сообщение. 

МеззадеРогІ 

передает асинхронные сообщения ЕѵепіГагдеі 

Объект МеззадеРогІ: используется для передачи асинхронных сообщений в виде собы¬ 
тий, обычно между различными контекстами выполнения, такими как окна или фо¬ 
новые потоки выполнения. Объекты МеззадеРогІ: должны использоваться в виде свя¬ 
занных пар: см. МеззадеСйаппеІ. Вызов метода розіМеззадеО объекта МеззадеРогІ: генери¬ 
рует событие «тевва&е» в связанном с ним объекте МеззадеРогІ:. Прикладной интерфейс 
обмена меж доменными сообщениями (раздел 22.3) и фоновые потоки выполнения 
(раздел 22.4) также взаимодействуют с использованием объектов розіМеззадеО и собы¬ 
тий теззаде. Эти прикладные интерфейсы фактически неявно используют объект 
МеззадеРогІ:. Явное использование объектов МеззадеСПаппеІ и МеззадеРогІ: позволяет соз¬ 
давать дополнительные, частные каналы обмена данными и может применяться, на¬ 
пример, для организации непосредственных взаимодействий двух соседних фоновых 
потоков выполнения. 

Типы МеззадеСНаппеІ и МеззадеРогІ: являются нововведением, появившимся в специфи¬ 
кации НТМЬ5, и на момент написания этих строк некоторые броузеры поддерживали 
меж доменный обмен сообщениями (раздел 22.3) и фоновые потоки выполнения (раз¬ 
дел 22.4) без применения частных каналов связи на основе объектов МеззадеРогІ:. 

Методы 

ѵоісі с1озе() 

Отключает данный объект МеззадеРогІ: от порта, к которому он был подключен (ес¬ 
ли таковой имеется). Последующие вызовы метода розіМеззадеО не будут иметь 
никакого эффекта, и в будущем сообщения «тевва&е» приходить не будут. 

ѵоісі ро5іМеззаде(апу теззаде, [МеззадеРогі[] рогТз ]) 

Отправляет копию сообщения теззаде через порт и передает его в форме события 
«тезза&е» порту, с которым соединен данный порт. Если указан аргумент рогТз , его 
значение также будет доставлено вместе с событием «тезза&е». Аргумент теззаде 
может иметь любое значение, совместимое с алгоритмом структурированного ко¬ 
пирования (врезка «Структурированные копии» в главе 22). 

ѵоісі зіагі() 

Запускает механизм возбуждения событий «тевза&е» в объекте МеззадеРогІ. До 
вызова этого метода все данные, отправляемые через порт, будут сохраняться в бу¬ 
фере. Подобная задержка событий позволяет сценариям зарегистрировать все об¬ 
работчики событий до того, как будет отправлено хоть одно сообщение. Имейте, 
однако, в виду, что вызывать этот метод необходимо только при использовании ме¬ 
тода асІсІЕѵепНізіепегО интерфейса ЕѵепіТагдеі. Если сценарий регистрирует обра¬ 
ботчик посредством свойства оптеззаде, метод зіагі() будет вызван неявно. 
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Обработчики событий 

оптеззаде 

Это свойство определяет обработчик событий «те88а&е». События «тезва&е» гене¬ 
рируются в объекте МеззадеРогІ;. Они не всплывают, и для них не предусматривает¬ 
ся действий по умолчанию. Обратите внимание, что при установке этого свойства 
вызывается метод зіагіО, который запускает механизм возбуждения событий 
«те88а&е». 

Меіег 

графический индикатор, или шкала Чосіе, Еіетепі 

Объект МеТег представляет НТМЬ-элемент <те1:ег>, отображающий графическое пред¬ 
ставление значения внутри диапазона возможных значений, где диапазон возмож¬ 
ных значений может быть произвольно разбит на области низких, средних и высоких 
значений. 

Большинство свойств этого объекта просто являются отражением НТМЬ-атрибутов 
с теми же именами. Однако свойства объекта являются числовыми, тогда как НТМЬ- 
атрибуты - строками. 

Элемент <те1:ег> был введен спецификацией НТМЬ5, поэтому на момент написания 
этих строк он поддерживался не всеми броузерами. 

Свойства 

геасіопіу Рогт ^огт 

Элемент Рогт, если имеется, являющийся предком для данного элемента или опре¬ 
деляемый НТМЬ-атрибутом Ічэгт. 

йоиЫе Мд& 

Если определено, значения в диапазоне между ЫдП и тах будут графически отнесе¬ 
ны к «высоким». 

геасіопіу МосІеНзТ ІаЬеІз 

Объект, подобный массиву, содержащий элементы 1_аЬе1, связанные с этим элемен¬ 
том. 

сІоиЫе Іои 

Если определено, значения в диапазоне между Іом и тах будут графически отнесе¬ 
ны к «низким». 

сІоиЫе тах 

Максимальное значение, которое может отображать элемент <те1:ег>. По умолча¬ 
нию имеет значение 1. 

СІоиЫе тіп 

Минимальное значение, которое может отображать элемент <те1:ег>. По умолча¬ 
нию имеет значение 0. 

сІоиЫе оріітит 

Определяет значение, которое следует считать оптимальным. 
сІоиЫе ѵаіие 

Значение, которое представляет данный элемент <те1:ег>. 
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МоизеЕѵепі 

см. Еѵепі 

№ѵідаіог 

информация о веб-броузере 

Объект МаѵідаТог содержит свойства, описывающие используемый веб-броузер. По¬ 
средством этих свойств можно выполнить специфическую для платформы настройку 
сценария. Имя этого объекта, очевидно, ссылается на броузер Кеівсаре Каѵі&аіог, тем 
не менее все броузеры поддерживают этот объект. Имеется только один экземпляр 
объекта МаѵідаТог, к которому можно обращаться через свойство паѵідаТог любого объ¬ 
екта Міпсіоіѵ. 

Исторически объект Маѵідаіог использовался для «опознавания клиента», позволяя 
выбирать, какой фрагмент программного кода выполнять в зависимости от типа бро¬ 
узера. В примере 14.3 демонстрируется простейший прием, а в сопутствующем ему 
описании в разделе 14.4 упоминается масса ловушек, которые имеются в объекте 
№ѵіда1:ог. Наилучший способ проверки совместимости, не зависящий от типа броузе¬ 
ра, описывается в разделе 13.4.3. 

Свойства 

геасіопіу зігіпд аррИаше 

Имя броузера. Для броузеров, созданных на основе Ивівсаре, значение этого свой¬ 
ства равно «Ивівсаре». В Іпіегпеі Ехріогег оно равно «МісговоН Іпіегпеі Ехріогег». 
Для совместимости с существующим программным кодом многие броузеры воз¬ 
вращают старую, не соответствующую действительности, информацию. 

геасіопіу зігіпд аррѴѳгзіоп 

Информация о версии и платформе броузера. Для совместимости с существую¬ 
щим программным кодом в большинстве броузеров это свойство возвращает уста¬ 
ревшую информацию. 

геасіопіу беоіосаііоп дѳоіосаііоп 

Ссылка на объект Сеоіосаііоп для данного броузера. Методы этого объекта позво¬ 
ляют сценариям запрашивать текущее географическое местонахождение пользо¬ 
вателя. 

геасіопіу Ьооіеап опИпе 

Имеет значение Шзе, если броузер не будет предпринимать попыток загрузить что- 
либо из сети. Это может быть обусловлено тем, что броузер выполняется на компь¬ 
ютере, не подключенном к сети, или тем, что пользователь настроил броузер на ав¬ 
тономную работу. Если броузер будет предпринимать пытаться загрузить что-либо 
(потому что компьютер подключен к сети), это свойство будет иметь значение Ігие. 
Когда значение этого свойства изменяется, броузер возбуждает события «опііпе» 
и «оШіпе» в объекте ілііпсіоѵі/. 

геасіопіу зИгіпд ріаі^огт 

Название операционной системы и/или аппаратной платформы, на которой вы¬ 
полняется броузер. Стандартный набор значений для этого свойства не определен, 
но вот некоторые типичные значения: «АѴІП32», «МасРРС» и «Ьіпих І586». 

геасіопіу $1:гіпд изегАдепг 

Значение, которое броузер подставляет в заголовок ивег-а&епі в НТТР-запросах. 
Например: 
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Мо2і11а/5.0 (XII; Іі; І_іпцх І686; еп-СЗ) 

АррІеѴу/еЬКіИ/534.16 (КНТМІ_, Ике Оеско) 

СИготе/10.0.648.45 
3а^агі/534.16 

Методы 

ѵоісі гедіз*егСоп*еп*Нап<11ег(5І:гіпд тітеТуре , зТгіпд і/гі, зТгіпд ТіТІе ) 

Этот метод выполняет запрос на регистрацию іігі как обработчика, используемого 
для отображения содержимого типа тітеТуре. Аргумент ТіТІе - заголовок сайта, ко¬ 
торый может отображаться перед пользователем. Аргумент і/гі должен содержать 
строку «%в». Когда этот обработчик содержимого должен будет использоваться 
для обработки веб-страницы указанного типа тітеТуре , ІІКЬ-адрес этой веб-стра¬ 
ницы будет закодирован и вставлен в і/гі на место «%&». Затем броузер перейдет по 
получившемуся ШІЬ-адресу. Это новый метод, введенный спецификацией НТМЬб, 
и он может быть реализован не во всех броузерах. 

ѵоісі гедіз*ѳгРго*осо1Нап(11ѳг(5І:гіпд зсЬете, зігіпд і/гі, зігіпд ТіТІе ) 

Действует подобно методу гедізіегСопіепіНапсІІегО, но регистрирует веб-сайт для 
использования в качестве обработчика схемы протокола зсЬете, указанного в ШІЬ- 
адресе. Аргумент зсЬете должен быть строкой, такой как «таШю» или «втз» без 
двоеточия. Это новый метод, введенный спецификацией НТМЬб, и он может быть 
реализован не во всех броузерах. 

ѵоісі уіе1(1Рог$*огадеир(1а*е5() 

Сценарии, использующие объекты Ооситепіі.соокіе, Іл/іпсІом.ІосаІЗіогаде и Ілііпсіоѵі/.зез- 
зіопЗіогаде (см. Зіогаде и главу 20), не имеют возможности определять, производятся 
ли изменения в хранилище параллельно выполняющимися в разных окнах сцена¬ 
риями (с тем же происхождением). Броузеры могут (хотя на момент написания этих 
строк такую возможность поддерживали не все броузеры) предотвратить парал¬ 
лельные изменения с помощью механизма блокировок, подобного тому, что исполь¬ 
зуется в базах данных. В броузерах, поддерживающих такую возможность, этот ме¬ 
тод неявно освобождает блокировку, предоставляя возможность сценариям в дру¬ 
гих окнах сохранить свои изменения. Значения, извлекаемые из хранилища после 
вызова этого метода, могут отличаться от тех, что извлекались перед его вызовом. 

ІЧосіе 

Все объекты в дереве документа (включая сам объект Ооситепі:) реализуют интерфейс 
Иосіе, который предоставляет фундаментальные свойства и узлы для выполнения ма¬ 
нипуляций с деревом. Свойство рагепіМосІе и массив сШсШосІезП позволяют передви¬ 
гаться вверх и вниз по дереву документа. Можно перечислить дочерние узлы данного 
узла, выполнив цикл по элементам сОіІсШосІезП или используя свойства ^ігзШііісі 
и пехіЗіЫіпд (или свойства ІазіСШсІ и ргеѵіоизЗіЫіпд для обхода в обратном порядке). 
Методы аррепсІСШсІО, іпзегіВеІ'огеО, гетоѵеСШсІО и герІасеСОШО позволяют модифи¬ 
цировать дерево документа, изменяя дочерние узлы данного узла. 

Каждый объект в дереве документа реализует как интерфейс N 0 ( 16 , так и более специа¬ 
лизированный интерфейс, например, Еіетепі или Техі. Свойство посІеТуре указывает, 
какой подынтерфейс реализует узел. Это свойство позволяет проверить тип узла пе¬ 
ред тем, как использовать свойства и методы более специализированного интерфей¬ 
са. Например: 

ѵаг п; // Содержит узел, с которым выполняются операции 

іТ (п.поРеТуре == 1) { // Или использовать константу Мойе. ЕІ_ЕМЕМТ_М(ЮЕ 
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ѵаг іадпате = п.іадМате; // Если узел является узлом Еіетепі, это имя тега 

} 

Константы 

ипзідпесі зМогТ Е1_ЕМЕМТ_М00Е = 1 

ипзідпесі зПогТ ТЕХТ_И00Е = 3 

ипзідпесі зііогТ РВ0СЕЗЗІН6_ІН$ТКиСТІ0О00Е = 7 

ипзідпесі зИогТ С0ММЕМТ_М00Е = 8 

ипзідпесі зіюгі 00С11МЕМТ_М00Е = 9 

ипзідпесі зііогТ ООШЕНТТѴРЕ.НООЕ = 10 

ипзідпесі зМогИ 00СиИЕНТ_РРА0МЕНТ_Н00Е = 11 

Эти константы определяют возможные значения свойства посІеТуре. Обратите вни¬ 
мание, что они являются статическими свойствами функции-конструктора МосІе() - 
они не являются свойствами отдельных объектов N 0 ( 16 . Отметьте также, что они не 
определены в ІБ версии 8 и ниже. Для совместимости в сценариях можно использо¬ 
вать числовые значения констант или определить собственные константы. 

ипзідпесі зііогі 00СиМЕНТ_Р05ІТІ0Н_0І5С(ШЕСТЕ0 = 0x01 
ипзідпесі зііогі 00СиНЕРТ_Р03ІТІ0Н_РВЕСЕ0ІН0 = 0x02 
ипзідпесі зііогі 00СиНЕРТ_Р03ІТІ0Р_Р0И0МІН0 = 0x04 
ипзідпесі зНог* 00СиНЕРТ_Р03ІТШ_С0НТАІН8 = 0x08 
ипзідпесі зііогі 00СиМЕНТ_Р03ІТІ0Н_С0РТАІНЕ0_ВѴ = 0x10 

Эти константы определяют биты, которые могут быть установлены или сброшены 
в значении, возвращаемом методом сотрагеОоситепіРозіііопО. 

Свойства 

геасіопіу зігіпд ЬазеІШІ 

Определяет базовый ІШЬ-адрес для данного объекта N 0 ( 16 , который будет исполь¬ 
зоваться при разрешении относительных ІШЬ-адресов. Для всех узлов в НТМЬ- 
документах этот ІІКЬ-адрес определяется элементом <Ьазе> или свойством Ооси- 
тепі.ІІРІ., из значения которого исключается идентификатор фрагмента. 

геасіопіу N0(161.151: сМІсШоЛез 

Это свойство является объектом, подобным массиву, содержащим дочерние узлы те¬ 
кущего узла. Это свойство никогда не должно иметь значение пиіі: для узлов, не 
имеющих дочерних узлов, сШсШосІез - это массив со свойством Іепдііі, равным нулю. 
Обратите внимание: объект N0(161.151: «живой», т. е. любое изменение в списке дочерних 
узлов элемента немедленно становится видимым через объект МосІеЬізІ:. 

геасіопіу N 0(16 ^ігзКМІй 

Первый дочерний узел этого узла или пиіі, если узел не имеет дочерних узлов, 
геасіопіу N 0(16 ІазШііІй 

Последний дочерний узел этого узла или пиіі, если узел не имеет дочерних узлов, 
геасіопіу N0(16 пехіЗіЬІіпд 

Смежный узел, непосредственно следующий за данным узлом в массиве сИіісі- 
Nо(Iе5[] узла рагепі^осіе, или пиіі, если такого узла нет. 

геасіопіу зігіпд пойеИате 

Имя узла. Для узлов Еіетепі определяет имя тега элемента, которое может быть 
также получено с помощью свойства ^N311)6 интерфейса Еіетепі. Для большинства 
других типов узлов значение является строковой константой, зависящей от типа 
узла. 
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геасіопіу ипзідпесі зііогі пойеТуре 

Тип узла, т. е. информация о том, какой подынтерфейс реализует узел. Допусти¬ 
мые значения определяются перечисленными выше константами. Однако т. к. эти 
константы не поддерживаются в Іпіегпеі Ехріогег, вместо них могут использовать¬ 
ся числовые значения. В НТМЬ-документах распространенные значения для этого 
свойства таковы: 1 - для узлов Еіетепі, 3 - для узлов Техі, 8- для узлов Соттепі 
и 9 - для единственного узла Оосішепі: верхнего уровня. 

зігіпд пойеѴаІие 

Значение узла. Для узлов Техі содержит текстовое содержимое, 
геасіопіу Ооситепі сжпегОоситеп* 

Объект Ооситепі:, частью которого является данный узел. Для узлов Ооситепі: это 
свойство равно пиіі. Обратите внимание, что узлы всегда имеют владельца, даже 
если они не были добавлены в документ. 

геасіопіу N 0(16 рагепІИснІе 

Родительский узел (или узел-контейнер) этого узла или пиіі, если родительского 
узла не существует. Обратите внимание: узлы Ооситепі: и ОоситепІРгадтепІ никогда 
не имеют родительских узлов. Кроме того, в узлах, удаленных из документа, а так¬ 
же в только что созданных, но еще не вставленных в дерево документа узлах свой¬ 
ство рагеп^осіе равно пиіі. 

геасіопіу N0(16 ргеѵіоизЗіЬІіпд 

Смежный узел, непосредственно предшествующий данному узлу в массиве сШР- 
Nо(1ез[] родительского узла рагеп^осіе, или пиіі, если такого узла нет. 

зігіпд ІѳхіСопІепІ 

Для узлов Техі: и Соттепі: это свойство является синонимом свойства сіаіа. Для узлов 
Еіетепі: и ОоситепІРгадтепІ это свойство возвращает объединенное содержимое всех 
вложенных узлов Техі. Операция присваивания этому свойству узлов Еіетепі или 
ОоситепІРгадтепІ замещает все вложенные узлы этого элемента или фрагмента но¬ 
вым единственным узлом Техі с присвоенным свойству значением. 

Методы 

N0(16 аррегиІС&іІй^осІе пемСЫІсІ ) 

Этот метод добавляет узел пепСЫІсІ в документ, вставляя его в качестве последнего 
дочернего узла. Если узел пепСЫІсІ уже присутствует в дереве документа, он удаля¬ 
ется из дерева и вставляется в новое место. Если узел пемСЫІд является узлом 
ОоситепІРгадтепІ, сам узел не вставляется, а вместо этого в конец массива сШсШо- 
с!ез[] данного узла вставляются по порядку все дочерние узлы объекта ОоситепІ¬ 
Ргадтепі. Обратите внимание, что узел из другого документа (или созданный дру¬ 
гим документом) не может быть вставлен в текущий документ. То есть свойство 
омпегОоситепІ узла пемСЫІсІ должно совпадать со свойством омпегОоситепІ данного 
узла. (См. Ооситепі.асІор^осІеО). Возвращает переданный ему узел. 

N 0(16 с1опеИо(1е(1эоо1еап сіеер ) 

Создает и возвращает копию узла, для которого он вызван. Если в аргументе ему 
передается значение I гие, он также рекурсивно копирует всех потомков узла. В про¬ 
тивном случае он копирует только данный узел, но не его дочерние узлы. Возвра¬ 
щаемый узел не является частью дерева документа, а его свойство рагеп^осіе имеет 
значение пиіі. Когда копируется узел Еіетепі, то копируются и все его атрибуты. 
Однако следует отметить, что функции-обработчики событий, зарегистрирован¬ 
ные для узла, не копируются. 
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ипзідпесі зИогТ: сотрагеОоситѳпІРозШоп^осіе оТРег ) 

Сравнивает позицию данного узла в документе с позицией узла оТРег и возвращает 
число, биты которого описывают отношения между узлами. Если сравниваемые' 
узлы являются одним и тем же узлом, все биты в результате будут сброшены, т.е. 
метод вернет 0. Иначе в возвращаемом значении будет установлен один или более 
битов. Константы 00СІІМЕМТ_Р05ІТІ0М_, перечисленные выше, являются символиче¬ 
скими именами каждого из битов и имеют следующее значение: 


БОС11МЕІЧТ_Р08ІТІ<Ж_ 

Значение 

Описание 

ОІЗССШЕСТЕО 

0x01 

Два узла принадлежат разным документом, поэто¬ 
му их позиции не могут сравниваться. 

РПЕСЕОІЫС 

0x02 

Узел оТРег располагается перед данным узлом. 

роиоіше 

0x04 

Узел оТ Ре г располагается после данного узла. 

СОМА^З 

0x08 

Узел оТ Ре г содержит данный узел. Когда установ¬ 
лен этот бит, всегда будет установлен бит РПЕСЕОІМО. 

сомтаімео.вѵ 

0x10 

Узел оТРег содержится внутри данного узла. Когда 
установлен этот бит, всегда будет установлен бит 

РОЦ-ОШб. 


Ьооіеап ЬазСЬіІсМойезО 

Возвращает Тше, если данный узел имеет один или более дочерних узлов, или 
^аізе - в противном случае. 

N0(16 іпзеПВе?оге(№сІе пемСРИсі, Мойе геТСРИсі) 

Вставляет узел пемСРИсІ в дерево документа как дочерний узел данного узла и воз¬ 
вращает вставленный узел. Новый узел позиционируется в массиве сЬі1сМосІез[] 
данного узла так, что он располагается непосредственно перед узлом геТСРПб. Ес¬ 
ли аргумент геТСРИсі имеет значение піііі, узел пепСРИсІ вставляется в конец масси¬ 
ва сМі1сІМосІез[ ], как это делает метод аррепсіСЬі1сі( ). Обратите внимание, что являет¬ 
ся ошибкой передавать в аргументе геТСРИсі узел, не являющийся дочерним по от¬ 
ношению к данному узлу. 

Если узел пепСРИс! уже включен в дерево документа, он удаляется из дерева и за¬ 
тем вставляется в новую позицию. Если пепСРИсі является узлом фрагмента Ооси- 
тепІіРгадтепІ:, то в указанную позицию вставляется не сам узел, а все его дочерние 
узлы, в исходном порядке следования. 

Ьооіеап із0е^аи11Натезрасе(зі:гіпд патезрасе ) 

Возвращает Ігие, если ІШЬ-адрес пространства имен патезрасе совпадает с ІШЬ- 
адресом пространства имен по умолчанию, который возвращает вызов 1оокир№те- 
зрасеУРЦпиП), и ^аізе - в противном случае. 

Ьооіеап ізЕдиа1Мо(1ѳ(№сІе оТРег) 

Возвращает Ігие, если данный узел и узел оТРег являются идентичными, т.е. име¬ 
ют один и тот же тип, имя тега, атрибуты и (рекурсивно) дочерние узлы. Возвра¬ 
щает І'аізе, если два узла не являются эквивалентными. 

Ьооіеап ізЗатеМойѳ^осіе оТРег) 

Возвращает Ігие, если данный узел и узел оТРег являются одним и тем же узлом, 
и Шзе - в противном случае. Вместо этого метода можно также просто использо¬ 
вать оператор ==. 
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зігіпд 1оокирМатезрасеІШ(з1:гіпд ргеТіх) 

Возвращает ІЖЬ-адрес пространства имен, связанного с указанным префиксом 
пространства имен ргеТіх, или пиіі, если такой префикс не определен. Если аргу¬ 
мент ргеТіх имеет значение пиіі, возвращает ІШЬ-адрес пространства имен по 
умолчанию. 

зігіпд 1оокирРге^іх(зі:гіпд патезрасе) 

Возвращает префикс пространства имен, связанного с указанным ІІКЬ-адресом 
пространства имен, или пиіі, если такое пространство имен не определено. 

ѵоісі погшаІігеО 

Нормализует все узлы, являющиеся потомками данного, объединяя смежные уз¬ 
лы и удаляя пустые. Обычно документы не имеют пустых или смежных тексто¬ 
вых узлов, но они могут появиться в результате добавления и удаления узлов сце¬ 
нарием. 

Мойе гетоѵеСМЩМойе оісіСГііісі ) 

Этот метод удаляет дочерний узел оісіСЫІсі из массива сШйМойез[] данного узла. 
Вызов этого метода с узлом, не являющимся дочерним, будет ошибкой. Метод 
гетоѵеСШсК) возвращает оісіСГііісі после его удаления. Старый дочерний узел оіб- 
СЬіІсІ продолжает быть действительным узлом и может быть позднее вставлен в до¬ 
кумент. 

Мойе гер1асеСМ1й(Мойе пеМіІсІ, Мойе оісЮЫІсі) 

Замещает узел оісіСГііісі в дереве документа другим узлом пемСЫІб. Узел оісіСіііісі 
должен быть дочерним для данного узла. Если пемСЫ 16 уже является частью доку¬ 
мента, то он сначала удаляется из документа перед повторной вставкой в новую 
позицию. Если пемСЫІсІ является узлом фрагмента ОоситепіРгадтепІ:, то вместо узла 
пеМИсі в позицию, ранее занятую узлом оісіСЫІсі , по порядку вставляются все его 
дочерние узлы. 

ЫосіеЫ$1 

доступный только для чтения объект, подобный массиву, содержащий узлы 

Мойе И зі - это доступный только для чтения объект, подобный массиву, содержащий 
объекты Мойе (обычно элементы). Свойство ІепдІН указывает, сколько узлов находится 
в списке; эти узлы можно извлекать, используя индексы от 0 до ІепдІМ-І. Вместо непо¬ 
средственного индексирования объекта Мойе Из! можно также использовать метод 
І1ет(). Элементы МойеИз! всегда являются корректными объектами Мойе: объект Мойе- 
Из! никогда не содержит пустых (пиіі) элементов. 

Объектами МойеНзІ, например, являются свойство сМИйМойез и возвращаемые значе¬ 
ния методов ОоситепІ.деіЕІетепІзВуТадМатеО, Е1етеп1.де1Е1етеп1зВуТадМате() и НТМЮоси- 
тепІ.деіЕІетепІзВуМатеО. Поскольку объект МойеНз! является объектом, подобным 
массиву, в книге эти значения часто неформально называются массивами, например 
«массив сМі1йМойез[]». 

Обратите внимание: объекты МойеИз! обычно являются «живыми»: они динамически 
отражают изменения в дереве документа. Например, если МойеНз! представляет до¬ 
черние узлы для указанного узла и вы удалите один из этих дочерних узлов, он будет 
удален и из вашего объекта Мойе Из!. Будьте аккуратны при выполнении цикла по 
элементам МойеИзІ, если тело цикла вносит изменения в дерево документа (например, 
удаляет узлы), которые могут влиять на содержимое Мойе Из!! 
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Свойства 

геасіопіу ипзідпесі Іопд ІепдіЬ 

Количество узлов в объекте МойеЬізІ:. 

Методы 

Мойе ііет(ипзідпей Іопд іпбех ) 

Возвращает узел в позиции іпбех или пиіі, если индекс іпбех выходит за границы. 

Орііоп 

элемент <орііоп> в элементе Зеіесі Мойе, Еіетепі 

Объект Орііоп описывает вариант выбора внутри объекта Зеіесі:. Свойства этого объек¬ 
та определяют, выбран ли вариант по умолчанию или вариант, который выбран в дан¬ 
ный момент, а также задают позицию, которую он занимает в массиве орііопз[ ] содер¬ 
жащего его объекта Зеіесі:, отображаемый им текст и значение, которое он передает 
на сервер при передаче данных родительской формы. 

По историческим причинам элемент Орііоп определяет конструктор, который можно 
использовать для создания и инициализации новых элементов Орііоп. (Разумеется, 
можно также использовать обычный метод Ооситепі.сгеаіеЕІетепіО.) После создания 
нового объекта Орііоп его можно добавить в коллекцию орііопз в объект Зеіесі:. Допол¬ 
нительные сведения приводятся в справочной статье НТМЮрііопзСоІІесііоп. 

Конструктор 

пеѵу/ 0рііоп([зі:гіпд іехі, зігіпд ѵаіие , Ьооіеап сІеГаііІТЗеІесТесІ , Ьооіеап зеІесТеб ]) 

Конструктор ОрііопО создает новый элемент <орііоп>. Четыре необязательных ар¬ 
гумента определяют значение свойства іехіСопіепі (см. Мойе) элемента и начальные 
значения свойств ѵаіие, йеіаиІіЗеІесіей и зеіесіей. 

Свойства 

Ьооіеап йеіаиІіЗеІесіей 

Соответствует НТМЬ-атрибуту зеіесіей. Определяет начальное значение состоя¬ 
ния выбора данного варианта, а также значение, которое будет использоваться 
при сбросе формы в исходное состояние. 

Ьооіеап йізаЬІей 

Значение ігие означает, что данный элемент <орііоп> недоступен. Варианты выбо¬ 
ра становятся недоступными, если они или вмещающие их элементы <орідгоир> 
имеют НТМЬ-атрибут йізаЫей. 

геайопіу Рогт іогт 

Элемент <іогт>, если имеется, содержащий данный элемент Орііоп. 
геайопіу Іопд іпйех 

Индекс данного элемента Орііоп в содержащем его элементе Зеіесі. (См. также 

НТМЮрііопзСоІІесііоп.) 

зігіпд ІаЬеІ 

Значение НТМЬ-атрибута ІаЬеІ, если определен, иначе - значение свойства іехі- 
Сопіепі (см. Мойе) данного элемента Орііоп. 

Ьооіеап зеіесіей 

Имеет значение ігие, если данный вариант выбора выбран в настоящее время, или 
іаізе - в противном случае. 
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зРгіпд РехР 

Значение свойства РехРСопРепр (см. Мойе) данного элемента ОрРіоп, из которого уда¬ 
лены начальные и завершающие пробельные символы, а каждые два или более 
смежных пробелов заменены одним символом пробела. 

зРгіпд ѵаіие 

Значение НТМЬ-атрибута ѵаіие, если определен, иначе - значение свойства РехР- 
СопРепР. 

ОиІриР 

элемент <оиРриР> НТМЬ-форм Мойе, ЕІетепР, РогтСопРгоІ 

Объект ОиРриР представляет элемент <оиРриР> НТМЬ-форм. В броузерах, поддержи¬ 
вающих их, объекты ОиРриР реализуют большинство свойств интерфейса РогтСопРгоІ. 

Свойства 

зРгіпд йеРаиІРѴаІііе 

Это свойство хранит начальное значение свойства РехРСопРепр (см. Мойе) элемента 
СЮРриР. Когда выполняется сброс формы, свойство ѵаіие элемента устанавливается 
в это значение. Если это свойство установлено и элемент ОиРриР отображает преды¬ 
дущее значение свойства йеРаиІРѴаІие, на экран будет выведено новое значение 
ЙеРаиІРѴаІие. Иначе текущее отображаемое значение не изменится. 

геайопіу 00М8еРРаЫеТокепІ_ізР йРтІРог 

НТМЬ-атрибут Рог элемента <оиРриР> - это список атрибутов ій элементов, разделен¬ 
ных пробелами, значения которых участвуют в вычислении содержимого, отобра¬ 
жаемого элементом <оиРриР>. Рог является в языке ^ѵаЗсгірі зарезервированным 
словом, поэтому соответствующее свойство называется ИРтІРог. Это свойство можно 
использовать, как если бы оно содержало обычную строку, или применять методы 
интерфейса 00МТокепІ_ізР для чтения и изменения отдельных элементов списка. 

РадеТгапБІііопЕѵепІ 

объект события для событий «радезНоѵѵ» и «радеНійе» Еѵепі 

Когда документ загружается впервые, вслед за событием «Іоасі» броузеры возбуждают 
событие «ра&езЬолѵ» и затем возбуждают событие «разезЬолѵ» всякий раз, когда стра¬ 
ница восстанавливается из кэша в памяти. Обработчикам события «ра&езікпѵ» пере¬ 
дается объект РадеТгапзіРіопЕѵепР, свойство регзізРей которого имеет значение Ргие, ес¬ 
ли страница была восстановлена из кэша, а не загружена из сети. 

Объект РадеТгапзіРіопЕѵепР также передается обработчикам события «ра&еЬЫе», но 
для событий «ра&еЬЫе» свойство регзізРей объекта события всегда имеет значение 

Ргие. 

События «ра&езЬолѵ» и «ра&еЬісІе» генерируются в объекте Ѵ\/іпйо\л/. Они не всплывают 
и не предусматривают действий по умолчанию, которые можно было бы отменить. 

Свойства 

геайопіу Ьооіеап регзізРей 

Для события «ра&езЬолѵ» это свойство имеет значение Раізе, если страница была 
загружена (или перезагружена) из сети или из дискового кэша. Оно имеет значе¬ 
ние Ргие, если страница была восстановлена из кэша в памяти. 

Для события «ра&еЬШе» это свойство всегда имеет значение Ргие. 
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Рор$іаіеЕѵепІ 

событие перемещения по истории посещений Еѵепі 

Веб-приложения, управляющие собственной историей посещений (раздел 22.2), ис¬ 
пользуют метод ризМЗТаТеО объекта НізТогу для создания новых записей в истории 
и связывают с ними некоторое значение или объект, описывающие состояние прило¬ 
жения. Когда пользователь щелкает на кнопках броузера Васк и РогѵѵагсІ, выполняя пе¬ 
реход между сохраненными состояниями, броузер генерирует события «рорзіаіе» 
в объекте Міпсісм и передает обработчику копию сохраненного состояния приложения 
в объекте события РорЗТаТеЕѵепІ:. 

Свойства 

геасіопіу апу зТаТе 

Это свойство хранит копию значения или объекта, описывающего состояние при¬ 
ложения, переданного методу Ніз1:огу.ризМЗі:а1:е() или Нізіогу. гер1асе31:а1:е(). Со¬ 
стояние может быть любым значением, которое можно скопировать с использова¬ 
нием алгоритма структурированного копирования («Структурированные копии» 
в главе 22). 

РгосеБзіпдІпзІгисііоп 

инструкция обработки в ХМ (.-документе Мосіе 

Этот редко используемый интерфейс представляет инструкцию обработки в ХМЬ-до- 
кументе. Программисты, работающие с НТМЬ-документами, никогда не столкнутся 
с узлом Ргосеззіпдіпзігисііоп. 

Свойства 

зігіпд <1а*а 

Содержимое инструкции обработки (т. е. от первого непробельного символа после 
цели до закрывающих символов ?>, но не включая их). 

геасіопіу зігіпд гагдеі 

Цель инструкции обработки. Это первый идентификатор инструкции обработки, 
следующий за открывающими символами <?; он определяет «обработчик», для ко¬ 
торого предназначена инструкция обработки. 

Ргодгезз 

индикатор хода выполнения операции Мосіе, Еіетепі 

Объект Ргодгезз представляет НТМЬ-элемент <ргодгезз> и отображается как графиче¬ 
ский индикатор хода выполнения некоторой операции. 

Когда заранее общий объем работы или времени на ее выполнение неизвестен, гово¬ 
рят, что элемент Ргодгезз находится в неопределенном состоянии. В таком состоянии 
он просто отображает некоторую «рабочую» анимацию, чтобы показать, что опера¬ 
ция выполняется. Когда общий объем работы (в единицах времени или в байтах) из¬ 
вестен заранее, элемент Ргодгезз находится в определенном состоянии и может отобра¬ 
жать ход выполнения операции в процентах в виде некоторого графического пред¬ 
ставления. 

Элемент <ргодгезз> введен спецификацией НТМЬб, поэтому на момент написания 
этих строк он был реализован не во всех броузерах. 


РгодгеззЕѵепІ 
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Свойства 

геасіопіу Рогт ?огт 

Элемент Рогт, если имеется, являющийся предком для данного элемента или опре¬ 
деляемый НТМЬ-атрибутом Рогт. 

геасіопіу І№сІеІ_і5І: ІаЬеІз 

Объект, подобный массиву, содержащий элементы І_аЬе1, связанные с этим элемен¬ 
том. 

СІоиЫе шах 

Общий объем работы, который требуется выполнить. Например, при использова¬ 
нии элемента Ргодгезз для отображения хода операции выгрузки или загрузки, 
выполняемой объектом ХМЬНРРрРедиезР, в это свойство можно записать общее коли¬ 
чество байтов, которые требуется передать. Данное свойство соответствует НТМЬ- 
атрибуту тах. По умолчанию имеет значение 1.0. 

геасіопіу сІоиЫе розШоп 

Если элемент Ргодгезз находится в определенном состоянии, данное свойство со¬ 
держит значение выражения ѵаіие/тах. Иначе оно будет иметь значение -1. 

СІоиЫе ѵаіие 

Значение между 0 и тах, определяющее уже выполненный объем работы. Это свой¬ 
ство соответствует НТМЬ-атрибуту ѵаіие. Если этот атрибут определен, элемент 
Ргодгезз находится в определенном состоянии. Если он отсутствует, элемент Ргод¬ 
гезз находится в неопределенном состоянии. Чтобы переключиться из определен¬ 
ного в неопределенное состояние (например, потому что проигрыватель МесІіаЕІе- 
тепі: получил событие «зіаііесі»)* можно воспользоваться методом гетоѵеАПгіЬиіеО 
интерфейса Еіетепі. 

РгодгеззЕѵепІ 

событие продолжения загрузки, выгрузки или чтения файла Еѵепі 

Все объекты - АррІісаііопСасМе, РіІеРеасІег и ХМІНіірРедиезІ: (версия 2) - возбуждают со¬ 
бытия, чтобы известить приложение о ходе выполнения операций передачи данных, 
таких как загрузка/выгрузка по сети или чтение файла. События этого рода известны 
как события хода выполнения операции , но только одно из них носит имя «рго&гезз». 
Другие события из этой категории, возбуждаемые объектами РіІеРеасІег и ХМ1_Н11:р- 
Редиезі:, - это события «Іоасізіагі», «ІоасЬ, «ІоасІепсЬ, «еггог» и «аЪогі». 

Объект ХМІНіірРедиезІ: также возбуждает событие «іітеоиі». Объект АррІісаііопСасІіе 
возбуждает несколько разных событий, имеющих отношение к ходу выполнения опе¬ 
рации и описываемых здесь, но только одно из них носит имя «рго&гезз». Эти события 
возбуждаются в последовательности, которая начинается с события «Іоасізіагі;» и все¬ 
гда заканчивается событием «Іоасіепсі». Непосредственно событию «ІоасІетЬ предше¬ 
ствует событие «Іоасі», «еггог» или «аЪогі», в зависимости от успеха выполнения опе¬ 
рации. Между начальным «Іоасізіагі» и двумя заключительными событиями возбу¬ 
ждается ноль или более событий (с названием «рго&гезз»). (Объект АррІісаііопСасМе 
генерирует иную последовательность событий, но и он возбуждает событие «рго&гезз» 
в ходе обновления кэша, которое также относится к категории событий хода выпол¬ 
нения операции.) 

Обработчики событий хода выполнения операции получают объект РгодгеззЕѵепІ:, кото¬ 
рый определяет количество переданных байтов данных. Объект РгодгеззЕѵепІ: никак не 
связан с НТМЬ-элементом <ргодгезз>, описанным в справочной статье Ргодгезз, но объ- 




1006 


Справочник по клиентскому ІаѵаБсгірІ: 


ект РгодгеззЕѵепі:, передаваемый (например) обработчику опргодгезз объекта ХМІ_Н«р- 
ЯедиезТ, можно было бы использовать для обновления состояния элемента <ргодгезз>, 
обеспечивающего визуальное представление хода выполнения операции загрузки. 

Свойства 

геасіопіу Ьооіеап ІепдТЬСошриТаЫе 

Имеет значение ігие, если известно общее количество байтов, предназначенных для 
передачи, и іаізе - в противном случае. Если это свойство имеет значение Тгие, про¬ 
цент выполнения операции для объекта е типа РгодгеззЕѵепі: можно вычислить как: 

ѵаг регсепіСотрІеіе = Маій.і1оог(100*е.Іоасіесі/е.іоіаі); 

геасіопіу ипзідпесі Іопд Іоайей 

Количество уже переданных байтов, 
геасіопіу ипзідпесі Іопд Іоіаі 

Общее количество байтов, предназначенных для передачи, если известно, и 0 - 
в противном случае. Эту информацию можно получить, например, из свойства 
зі 2 е объекта ВІоЬ или из заголовка Сопі:епі:-І_епді:1і, возвращаемого веб-сервером. 

Зсгееп 

предоставляет информацию о дисплее 

Свойство зсгееп любого объекта Міпсісм ссылается на объект 8сгееп. Свойства этого гло¬ 
бального объекта содержат информацию об экране, на котором отображается бро¬ 
узер. ^ѵа8сгір!-программы могут руководствоваться этой информацией для оптими¬ 
зации вывода в соответствии с возможностями дисплея пользователя. Например, 
программа может выбирать между большими и маленькими изображениями в зави¬ 
симости от размера экрана. 

Свойства 

геасіопіу ипзідпесі Іопд аѵаіІНеідМ: 

Определяет доступную высоту экрана (в пикселах), на котором отображается веб¬ 
броузер. Эта доступная высота не включает пространство, занятое постоянно ото¬ 
бражаемыми элементами рабочего стола, такими как панель задач в нижней час¬ 
ти экрана. 

геасіопіу ипзідпесі Іопд аѵаіІМісІ'Мі 

Определяет доступную ширину экрана в пикселах, на котором отображается веб¬ 
броузер. Эта доступная ширина не включает пространство, занимаемое постоянно 
отображаемыми элементами рабочего стола. 

геасіопіу ипзідпесі Іопд со1ог0ер*И 

геасіопіу ипзідпесі Іопд ріхеЮерІЬ 

Эти свойства, являющиеся синонимами, определяют глубину цвета в битах на 
пиксел. 

геасіопіу ипзідпесі Іопд Ьеід№ 

Определяет общую высоту экрана в пикселах, на котором отображается веб-бро¬ 
узер. См. также аѵаіІНеідМі. 

геасіопіу ипзідпесі Іопд 

Определяет общую ширину экрана в пикселах, на котором отображается веб-бро¬ 
узер. См. также аѵаіІМісІіМ. 
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Бсгірі 

НТМ (.-элемент <$сгір(> Мосіе, Еіетепі 

Объект Зсгірі: представляет НТМЬ-элемент <зсгір1:>. Большинство его свойств просто 
соответствуют НТМЬ-атрибутам с теми же именами, только при этом свойство Іехі: 
действует подобно свойству ІехіСопІепІ:, унаследованному от интерфейса N0(16. 

Обратите внимание, что элемент <зсгір1:> выполняется только один раз. Изменение 
свойства зге или Іехі существующего элемента <зсгір1:> не приводит к запуску нового 
сценария. Однако эти свойства можно установить во вновь созданном элементе <зсгір1:>, 
чтобы выполнить новый сценарий. Но имейте в виду, чтобы выполнить сценарий, тег 
<зсгір1;> необходимо вставить в объект Ооситепі:. Сценарий будет выполнен, когда бу¬ 
дет установлено свойство зге или Іуре или когда он будет вставлен в документ, при 
выполнении обоих условий. 

Свойства 

Ьооіеап азупс 

Имеет значение 1:гие, если элемент <зсгір1:> имеет атрибут азупс, и Шзе - в против¬ 
ном случае. Дополнительные сведения приводятся в разделе 13.3.1. 

зігіпд сЬагзеІ: 

Кодировка символов в сценарии, на который ссылается свойство зге. Обычно это 
свойство не определяется, и по умолчанию считается, что сценарий имеет ту же 
кодировку, что и вмещающий его документ. 

Ьооіеап йе^ег 

Имеет значение Ігие, если элемент <зсгір1:> имеет атрибут сіе^ег, и ^аізе - в против¬ 
ном случае. Дополнительные сведения приводятся в разделе 13.3.1. 

зігіпд зге 

ІШЬ-адрес сценария, который требуется загрузить, 
зігіпд іехі 

Текст между тегами <зсгір1:> и </зсгір1:>. 
зігіпд Іуре 

МІМЕ-тип с определением языка сценариев. По умолчанию устанавливается зна¬ 
чение «ѣехѴІ&ѵазсгірѣ», благодаря чему для обычных сценариев на языке ^ѵа- 
Всгірі не требуется устанавливать это свойство (или НТМЬ-атрибут). При присваи¬ 
вании этому свойству собственного МІМЕ-типа можно встраивать произвольные 
текстовые данные в элемент <зсгір1:> для использования другими сценариями. 

Зеіесі 

графический список для выбора Мосіе, Еіетепі, РогтСопІгоІ 

Элемент Зеіесі: представляет НТМЬ-тег <зе1ес1:>, который отображается как графиче¬ 
ский список выбора. Если в определении НТМЬ-элемента присутствует атрибут тиі- 
Ііріе, пользователь может одновременно выбрать в списке любое число вариантов. Ес¬ 
ли этот атрибут отсутствует, пользователь сможет выбрать только один вариант, и ва¬ 
рианты ведут себя как радиокнопки - выбор одного из них приводит к отмене преды¬ 
дущего выбора. 

Варианты в элементе Зеіесі: могут отображаться двумя различными способами. Во- 
первых, если атрибут зііе имеет значение больше 1 или если присутствует атрибут 
тиШрІе, варианты отображаются в окне броузера в виде списка высотой зііе строк. 
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Если значение зіге меньше, чем число вариантов, в списке появится полоса прокрут¬ 
ки, чтобы обеспечить доступность всех вариантов. Во-вторых, если значение атрибута 
зіге равно 1 и атрибут тиіііріе не указан, текущий выбранный вариант отображается 
в единственной строке, а список всех остальных вариантов доступен через раскры- 
вающееся меню. Первый стиль представления позволяет видеть все доступные вари¬ 
анты, но занимает больше пространства в окне броузера. Второй стиль требует мини¬ 
мум пространства, но не дает возможности увидеть альтернативные варианты все 
сразу. По умолчанию свойство зіге получает значение 4 при наличии атрибута тиіііріе 
и 1 - в противном случае. 

Самый большой интерес представляет свойство орііопз[] элемента Зеіесі. Это объект, 
подобный массиву, содержащий элементы <орііоп> (см. Орііоп), которые описывают 
варианты выбора, представленные в элементе Зеіесі:. По историческим причинам 
этот объект, подобный массиву, имеет необычные особенности, касающиеся выполне¬ 
ния операций добавления и удаления элементов <орііоп>. Дополнительные сведения 
приводятся в статье НТМЮрІіопзСоІІесІіоп. 

Если в элементе Зеіесі отсутствует атрибут тиіііріе, определить, какой вариант вы¬ 
бран, можно с помощью свойства зеіесіесііпсіех. Однако если допускается возмож¬ 
ность одновременного выбора нескольких вариантов, это свойство содержит индекс 
первого выбранного варианта. Чтобы определить все множество выбранных вариан¬ 
тов, необходимо обойти в цикле массив орііопз[ ] и проверить свойство зеіесіесі каждо¬ 
го объекта Орііоп. 

Свойства 

В дополнение к свойствам, перечисленным ниже, элементы Зеіесі также поддержива¬ 
ют свойства интерфейса Еіетепі и РогтСопігоІ и имеют свойства тиіііріе, гедиігесі 
и зіге, соответствующие НТМЬ-атрибутам. 

ипзідпесі Іопд ІепдіП 

Количество элементов в коллекции орііопз. Объекты Зеіесі сами являются объек¬ 
тами, подобными массивам, поэтому для объекта з типа Зеіесі и числа п выраже¬ 
ние з[п] возвращает то же значение, что и з.ор!іопз[п]. 

геасіопіу НТМЮрІіопзСоІІесІіоп орііопз 

Объект, подобный массиву, с элементами Орііоп, содержащимися в данном элемен¬ 
те Зеіесі. Описание исторически сложившегося поведения этой коллекции приво¬ 
дится в справочной статье НТМЮрІіопзСоІІесІіоп. 

Іопд зеіѳсіегііпгіех 

Индекс выбранного варианта в массиве орііопз. Если ни один из вариантов не вы¬ 
бран, значение этого свойства равно -1. Если выбрано более одного варианта, свой¬ 
ство зеіесіесііпсіех определяет индекс только первого из них. 

Установка значения этого свойства приводит к выбору указанного варианта и от¬ 
меняет выбор всех остальных, даже если в объекте Зеіесі указан атрибут тиіііріе. 
Если выбор реализован в виде списка (когда значение свойства зіге > 1), то выбор 
всех вариантов можно отменить, установив свойство зеіесіесііпсіех равным -1. Об¬ 
ратите внимание: этот способ изменения выбора не приводит к вызову обработчи¬ 
ка события опсМапде(). 

геасіопіу НТМЮоІІесііоп зеІесіѳгіОрііопз 

Доступный только для чтения объект, подобный массиву, содержащий выбран¬ 
ные элементы Орііоп. Это новое свойство, определяемое спецификацией НТМЬб, 
которое на момент написания этих строк было реализовано не во всех броузерах. 
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Методы 

Все методы, перечисленные ниже, делегируют выполнение операций одноименным 
методам свойства орііопз; дополнительные сведения приводятся в справочной статье 
НТМЮрііопзСоІІесііоп. В дополнение к этим методам элементы Зеіесі реализуют мета- 
ды интерфейсов Еіетепі и РогтСопігоІ. 

ѵоісі аО(І(Е1егтіепі: еіетепі:, [апу ЬеТоге ]) 

Действует подобно методу орТіопв. ас!с1(), добавляя новый элемент Орііоп. 
апу ііет(ипзідпесІ Іопд іпсіех ) 

Действует подобно методу орііопз . ііет( ) и возвращает элемент Орііоп. Он также не¬ 
явно вызывается, когда пользователь обращается к элементу Зеіесі: как к массиву. 

апу пате<Ліеіп(зігіпд пате ) 

Действует подобно методу орііопз. патесІІіетО. См. НТМЮрііопзСоІІесііоп. 
ѵоісі гешоѵе(1опд іпсіех ) 

Действует подобно методу орііопз. гетоѵе(), удаляя элемент Орііоп. См. НТМЮрііопз¬ 
СоІІесііоп. 

Зіогаде 

хранилище пар имя/значение на стороне клиента 

Свойства ІосаІЗіогаде и зеззіопЗіогаде объекта МіпРоѵѵ являются объектами Зіогаде, ко¬ 
торые представляют хранимые на стороне клиента ассоциативные массивы, отобра¬ 
жающие строковые ключи в значения. Теоретически объект Зіогаде может хранить 
любые значения, которые можно копировать с применением алгоритма структуриро¬ 
ванного копирования (врезка «Структурированные копии» в главе 22). Однако на мо¬ 
мент написания данных строк броузеры позволяли сохранять только строковые зна¬ 
чения. 

Методы объекта Зіогаде позволяют добавлять новые пары ключ/значение, удалять их 
и получать значение, связанное с определенным ключом. Однако нет необходимости 
явно вызывать эти методы: вместо них можно использовать операцию индексирова¬ 
ния и оператор сіеіеіе и обрабатывать свойства ІосаІЗіогаде и зеззіопЗіогаде, как если 
бы они были обычными объектами. 

При изменении содержимого объекта Зіогаде любые другие объекты Міпсіом, имеющие 
доступ к той же области хранилища (т. е. отображающие документы с тем же проис¬ 
хождением), будут извещены об изменениях с помощью объекта события ЗіогадеЕѵепі. 

Свойства 

геасіопіу ипзідпесі Іопд ІепдіЬ 

Количество хранящихся пар ключ/значение. 

Методы 

ѵоіР с1еаг() 

Удаляет все хранящиеся пары ключ/значение, 
апу деіІіеш(зігіпд кеу ) 

Возвращает значение, связанное с ключом кеу . (В текущих, на момент написания 
этих строк, реализациях всегда возвращалась строка.) Этот метод вызывается не¬ 
явно при индексировании объекта Зіогаде, с целью получить значение свойства 
с именем в аргументе кеу . 
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зТгіпд кеу(ипзідпес1 Іопд п ) 

Возвращает ключ с индексом л, хранящийся в данном объекте Зіогаде, или пиіі, 
если п больше или равно ІепдТН. Обратите внимание, что порядок следования клю? 
чей может изменяться при добавлении и удалении пар ключ/значение. 

ѵоісі гетоѵеИеігКзігіпд кеу) 

Удаляет из объекта Зіогаде ключ кеу и связанное с ним значение. Этот метод вызы¬ 
вается неявно при использовании оператора сіеіеіе, с целью удалить свойство 
с именем в аргументе кеу. 

ѵоісі зеТІТет(з1:гіпд кеу , апу ѵаісіе) 

Добавляет ключ кеу и значение ѵаіие в данный объект Зіогаде, замещая значение, 
прежде связанное с этим ключом кеу. Этот метод вызывается неявно при присваи¬ 
вании значения свойству объекта Зіогаде с именем в аргументе кеу. То есть вместо 
явного вызова метода зеіІіетО можно использовать обычную операцию присваи¬ 
вания значения свойству. 

ЗіогадеЕѵепі 

Еѵепі 

Свойства ІосаІЗіогаде и зеззіопЗіогаде объекта Міпсіом ссылаются на объекты Зіогаде, 
представляющие хранилища на стороне клиента (раздел 20.1). Если имеется несколь¬ 
ко окон, вкладок или фреймов, отображающих документы с общим происхождением, 
все они будут иметь доступ к одному и тому же хранилищу. Если сценарий в одном 
окне изменит содержимое хранилища, во всех других объектах \Уіпс1о\ѵ, имеющих 
доступ к этому хранилищу, будет сгенерировано событие «зіога&е». (Обратите внима¬ 
ние, что это событие не генерируется в окне, в котором были выполнены изменения.) 
События «зѣога&е» генерируются в объекте Міпсіом и не всплывают. Для них не преду¬ 
сматривается действий по умолчанию, которые можно было бы отменить. Обработчи¬ 
кам события «зіога&е» передается объект события ЗіогадеЕѵепІ:, свойства которого 
описывают изменения, внесенные в хранилище. 

Свойства 

геасіопіу зігіпд кеу 

Это свойство хранит ключ, который был установлен или удален. Если все храни¬ 
лище было очищено вызовом метода Зіогаде. с1еаг(), это свойство (а также свойства 
пеѵѵѴаІие и оЮѴаІие) будет иметь значение пиіі. 

геасіопіу апу пеѵѵѴаІие 

Новое значение ключа кеу. Будет иметь значение пиіі при удалении ключа. На мо¬ 
мент написания этих строк броузеры позволяли сохранять только строковые зна¬ 
чения. 

геасіопіу апу оІйѴаІие 

Старое значение изменившегося ключа кеу. Будет иметь значение пиіі при добав¬ 
лении нового ключа. На момент написания этих строк броузеры позволяли сохра¬ 
нять только строковые значения. 

геасіопіу Зіогаде зіогадеАгеа 

Это свойство будет содержать то же значение, что и свойство ІосаІЗіогаде или зез- 
зіопЗіогаде объекта Міпсіом, принявшего это событие, и указывает, содержимое ка¬ 
кого хранилища изменилось. 
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геасіопіу зігіпд игі 

ШІЬ-адрес документа, сценарий которого внес изменения в хранилище. 

5іуІе 

НТМЬэлемент <$1у1е> Ыосіе, Еіетепі 

Объект Зіуіе представляет НТМЬ-тег <5І:у1е>. 

Свойства 

Ьооіеап йізаЬІей 

Установка этого свойства в значение {гие отключит таблицу стилей, связанную 
с данным элементом <з1у1е>, а установка в значение Шзе снова включит ее. 

зігіпд теЬіа 

Это свойство соответствует НТМЬ-атрибуту тесііа и определяет устройства, при 
отображении в которых должна применяться указанная таблица стилей. 

Ьооіеап зсоресі 

Имеет значение Ігие, если в элементе <з1:у1е> присутствует НТМЬ-атрибут зсоресі, 
и Шзе - в противном случае. На момент написания этих строк броузеры не под¬ 
держивали контекстные (зсоресі) таблицы стилей. 

геасіопіу СЗЗЗіуІеЗЬееІ: зЬее* 

Объект СЗЗЗЬуІеЗЬееІ:, определяемый данным элементом <з1:у1е>. 
зігіпд Шіе 

Все НТМЬ-элементы имеют атрибут Шіе. С помощью этого атрибута или свойства 
элемента <з1у1е> можно дать пользователю возможность выбрать альтернативную 
таблицу стилей по названию, и указанное значение свойства іШе может отобра¬ 
жаться в интерфейсе броузера в некотором оформлении. 

зігіпд *уре 

Соответствует НТМЬ-атрибуту {уре. По умолчанию имеет значение «іехі/сзз», 
и обычно нет необходимости указывать другое значение этого атрибута. 

ТаЫе 

НТМЬэлемент <іаЫе> Ыосіе, Еіетепі 

Объект ТаЫе представляет НТМЬ-элемент <1аЫе> и определяет несколько удобных 
свойств и методов для получения и модификации различных частей таблицы. Эти ме¬ 
тоды и свойства облегчают работу с таблицами, но они также могут быть продублиро¬ 
ваны с помощью базовых БОМ-методов. 

НТМЬ-таблицы конструируются из разделов, строк и ячеек. См. также ТаЫеСеІІ, 
ТаЫеВом и ТаЫеЗесІіоп. 

Свойства 

В дополнение к свойствам, перечисленным ниже, элементы ТаЫе имеют также свойст¬ 
во зіштагу, соответствующее НТМЬ-атрибуту с тем же именем. 

Еіетепі: сарііоп 

Ссылка на элемент <сар1:іоп> в таблице или пиіі, если он отсутствует. 
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геасіопіу НТМІ_Со11ес1:іоп гоиз 

Объект, подобный массиву, содержащий объекты ТаЫеНоѵѵ, который представляет 
все строки в таблице. Включает все строки, определяемые внутри тегов <іІіеас1>, 
<Т1 : оо1:> и <1:ЬосІу>. 

геасіопіу НТМЮоПесИоп ІВойіез 

Объект, подобный массиву, содержащий объекты ТаЫеЗесііоп, который представ¬ 
ляет все разделы <іЬосІу> в таблице. 

ТаЫеЗесііоп ТРооТ 

Элемент <*Роо*> таблицы или пиіі, если он отсутствует. 

ТаЫеЗесііоп ТНеагі 

Элемент <іІіеасІ> таблицы или пиіі, если он отсутствует. 

Методы 

Еіетепі сгеа*еСар*іоп() 

Возвращает объект Еіетепі:, представляющий элемент <сарііоп> таблицы. Если 
в таблице уже имеется элемент <сарііоп>, метод просто вернет его. Если в таблице 
отсутствует элемент <сарііоп>, этот метод создаст новый (пустой) элемент, вставит 
его в таблицу и вернет вызывающей программе. 

ТаЫеЗесііоп сгеаіеТВойуО 

Создаст новый элемент <іЬосІу>, вставит в таблицу и вернет его. Новый элемент 
вставляется после последнего элемента <іЬосІу> в таблице или в конец таблицы. 

ТаЫеЗесііоп сгеа*еТРооі() 

Возвращает объект ТаЫеЗесііоп, представляющий первый элемент <ііоо1:> в табли¬ 
це. Если в таблице уже есть нижний колонтитул, метод просто вернет его. Если 
таблица не имеет нижнего колонтитула, этот метод создаст новый (пустой) эле¬ 
мент <ііоо1:>, вставит его в таблицу и вернет вызывающей программе. 

ТаЫеЗесііоп сгеа*еТНеа<1() 

Возвращает объект ТаЫеЗесііоп, представляющий первый элемент <іІіеасІ> в табли¬ 
це. Если в таблице уже имеется заголовок, метод просто вернет его. Если таблица 
не имеет заголовка, этот метод создаст новый (пустой) элемент <іІіеасІ>, вставит его 
в таблицу и вернет вызывающей программе. 

ѵоісі <1е1е*еСар*іоп() 

Удаляет из таблицы первый элемент <сарііоп>, если он существует, 
ѵоісі <1е1еіеВоѵѵ(1опд іпбех) 

Удаляет из таблицы строку с индексом іпбех . Строки нумеруются в порядке, в ка¬ 
ком они следуют в исходном документе. Строки в разделах <іІіеасІ> и <ііоо1:> нуме¬ 
руются вместе со всеми остальными строками в таблице. 

ѵоісі <1е1еіеТРооі( ) 

Удаляет из таблицы первый элемент <ііоо1:>, если он существует, 
ѵоісі йеІеіеТНеайО 

Удаляет из таблицы первый элемент <іМеасІ>, если он существует. 

ТаЫеВом іпзегіВом([1опд іпбех]) 

Создает новый элемент <іг>, вставляет в таблицу в позицию, определяемую аргу¬ 
ментом іпбех , и возвращает его. 

Новая строка вставляется в том же разделе таблицы и непосредственно перед суще¬ 
ствующей строкой, в позиции, заданной аргументом іпбех . Если значение аргумента 
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іпбех равно количеству строк в таблице (или -1), новая строка добавляется в конец 
последнего раздела таблицы. Если таблица изначально пуста, новая строка встав¬ 
ляется в новый раздел <1Ьос!у>, который в свою очередь вставляется в таблицу. 

Для добавления содержимого в только что созданную строку можно использовать 
вспомогательный метод ТаЫеВсж.іпзегіСеІІО. См. также описание метода іпзег*- 
Нои() объекта ТаЫеЗесііоп. 

ТаЫеСеІІ 

ячейка в НТМЬтаблице Ыосіе, Еіетепі 

Объект ТаЫеСеІІ представляет элементы <{сІ> и <1:Іі>. 

Свойства 

геасіопіу Іопд сеПІпйех 

Позиция данной ячейки внутри строки. 

ипзідпесі Іопд со1$рап 

Значение НТМЬ-атрибута соізрап в виде числа. 

ипзідпесі Іопд гоѵѵЗрап 

Значение НТМЬ-атрибута гоизрап в виде числа. 

ТаЫеКоѵѵ 

элемент <4г» в НТМЬтаблице Ыобе, Еіетепі 

Объект ТаЫеВом представляет строку (элемент <іг>) в НТМЬ-таблице, а также опреде¬ 
ляет свойства и методы для работы с элементами ТаЫеСеІІ, содержащимися в строке. 

Свойства 

геасіопіу НТМЮоПесЫоп сеііз 

Объект, подобный массиву, содержащий объекты ТаЫеСеІІ, представляющие эле¬ 
менты <ісІ> и <іИ> в данной строке. 

геасіопіу Іопд гоміпйех 

Индекс этой строки в таблице, 
геасіопіу Іопд зесііопВоиІпсІех 

Позиция этой строки в данном разделе (т.е. внутри данного элемента <1Иеас1>, 
<іЬосІу> или <ТТооТ>). 

Методы 

ѵоісі (1е1еТеСе11(1опд іпбех) 

Удаляет ячейку в позиции іпбех в строке таблицы. 

Еіетепі іпзег*Се11([1опд іпбех]) 

Создает новый элемент <ТсІ>, вставляет в строку в указанную позицию и возвраща¬ 
ет его. Новая ячейка вставляется непосредственно перед ячейкой, находящейся 
в данный момент в позиции, определяемой аргументом іпбех . Если аргумент іпбех 
отсутствует, равен количеству ячеек в строке или -1, новая ячейка добавляется 
в конец строки. 

Обратите внимание: этот вспомогательный метод позволяет вставлять только 
ячейки данных <ісІ>. Чтобы вставить ячейку в строку верхнего колонтитула, необ- 
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ходимо создать и вставить элемент <1:М> методами ОоситепТ.сгеаТеЕІетепТО и №сІе. 
іпзегІВе^огеО или другими родственными им методами. 

ТаЫеБесІіоп 

раздел верхнего или нижнего колонтитула либо тела таблицы Мойе, Еіетепі 

Интерфейс ТаЫеЗесТіоп представляет раздел <ТЬосІу>, <ТИеасІ> или <т^ооТ> НТМЬ-табли- 
цы. Свойства ТНеасІ и ТРооТ объектов ТаЫе являются объектами ТаЫеЗесІіоп, а свойство 
ТВосІіез - коллекцией НТМІ_Со11ес1:іоп объектов ТаЫеЗесТіоп. 

Объект ТаЫеЗесТіоп содержит объекты ТаЫеВоѵѵ и сам содержится в объекте ТаЫе. 

Свойства 

геасіопіу НТМЮоПесЫоп гоиз 

Объект, подобный массиву, содержащий объекты ТаЫеВоѵѵ, представляющие стро¬ 
ки в этом разделе таблицы. 

Методы 

ѵоісі <1е1еіеНои(1опд іпсіех) 

Удаляет строку в указанной позиции в данном разделе. 

ТаЫеЯом іпзегТНои([1опд іпсіех ]) 

Создает новый элемент <{г>, вставляет в данный раздел таблицы в указанную по¬ 
зицию и возвращает его. Если аргумент іпсіех опущен, равен количеству строк 
в разделе или -1, новая строка добавляется в конец раздела. В противном случае 
новая строка вставляется непосредственно перед строкой, находящейся в данный 
момент в позиции, заданной аргументом іпсіех . Обратите внимание: для этого ме¬ 
тода аргумент іпсіех определяет позицию строки внутри одного раздела, а не в таб¬ 
лице в целом. 

Тех* 

текстовая последовательность в документе Иосіе 

Узел Тех* представляет обычный текст в документе и обычно располагается в дереве 
документа в виде дочернего узла по отношению к узлу Еіетепі:. Текстовое содержимое 
узла Тех! доступно через свойство сіаіа или через свойства посІеѴаІие и {ехіСопІепІ:, унас¬ 
ледованные от Мойе. Создать новый узел Техі: можно с помощью Оосішепі.сгеаІеТехІ:- 
Мос1е( ). Текстовые узлы никогда не имеют дочерних узлов. 

Свойства 

зТгіпд (Іаіа 

Текст, содержащийся в данном узле, 
геасіопіу ипзідпесі Іопд ІепдТИ 
Длина текста в символах, 
геасіопіу зігіпд мГюІеТехІ 

Текстовое содержимое данного узла и любых смежных с ним текстовых узлов, пред¬ 
шествующих ему и следующих за ним. После вызова метода погтаІігеО родитель¬ 
ского элемента Мойе это свойство будет иметь то же значение, что и свойство сіаіа. 
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Методы 

Эти методы вам не придется использовать на практике, если только вы не соберетесь 
написать текстовый редактор с веб-интерфейсом. 

ѵоісі арреп<ГОа*а(зі:гіпд ТехТ) 

Добавляет текст Тех? в конец данного текстового узла, 
ѵоісі <1е1е*е0аіа(ипзідпесІ Іопд оТТзе? , ипзідпесі Іопд соипТ) 

Удаляет соип? символов из данного текстового узла, начиная с символа в позиции 
оТТзеТ. Если сумма значений оТТзе? и соипТ превысит количество символов в тексто¬ 
вом узле, будут удалены все символы до конца строки, начиная с символа в пози¬ 
ции оТТзеТ. 

ѵоісі іпзегШгСа(ип5ідпесІ Іопд оТТзе? , зігіпд Тех?) 

Вставляет текст ТехТ в текстовый узел в позицию оТТзеТ. 
ѵоісі гер1асе0а*а(ипзідпесІ Іопд оТТзеТ, ипзідпесі Іопд соипТ, зігіпд ТехТ) 

Замещает соипТ символов, начиная с позиции оТТзеТ , содержимым строки ТехТ . Ес¬ 
ли сумма значений оТТзеТ и соипТ превысит значение свойства Іепдііі текстового уз¬ 
ла, будут замещены все символы, начиная с позиции оТТзеТ. 

Тех! гер1асеѴИю1еТехі(зі:гіпд ТехТ) 

Создает новый узел Техі, содержащий текст ТехТ, а затем замещает данный и смеж¬ 
ные с ним текстовые узлы новым узлом и возвращает новый узел. См. также опи¬ 
сание свойства ѵЛюІеТехі: выше и метода погтаІігеО интерфейса Мойе. 

Тех* зрШТех*(ипзідпесІ Іопд оТТзеТ) 

Разбивает узел Техі на два по смещению оТТзеТ. Исходный узел Техі модифицирует¬ 
ся так, чтобы он содержал весь текст до символа в позиции оТТзеТ , но не включая 
его. Создается новый узел, который содержит все символы от позиции оТТзеТ 
(включая ее) до конца строки. Этот новый узел Техі является возвращаемым значе¬ 
нием метода. Кроме того, если исходный узел Техі имеет родительский узел, то но¬ 
вый узел вставляется в родительский узел непосредственно после исходного узла. 

зігіпд зиЬз , СгіпдОа , Са(ипзідпесІ Іопд оТТзеТ, ипзідпесі Іопд соипТ ) 

Извлекает и возвращает подстроку длиной соипТ символов, начинающуюся с сим¬ 
вола в позиции оТТзеТ в тексте узла Техі. Если узел Тех! содержит слишком боль¬ 
шой объем текста, этот метод может оказаться более эффективным, чем метод 

Зігіпд.зиЬзігіпдО. 

ТехІАгеа 

многострочная область ввода текста Мосіе, Еіетепі, РогтСопІгоІ 

Объект ТехіАгеа представляет НТМЬ-элемент <іехіагеа> - многострочное текстовое по¬ 
ле ввода, часто используемое в НТМЬ- формах. Начальное содержимое текстовой об¬ 
ласти вставляется между тегами <іех1:агеа> и <Дех1:агеа>. Получить и изменить текст 
можно с помощью свойства ѵаіие. 

Объект ТехіАгеа - это элемент ввода формы, подобный элементам Іприі и Зеіесі. Ана¬ 
логично этим объектам он определяет свойства Рогт, пате, Руре и ѵаіие, а также другие 
свойства и методы, описанные в справочной статье РогтСопРгоІ. 

Свойства 

В дополнение к свойствам, перечисленным ниже, элементы ТехІАгеа определяют свой¬ 
ства интерфейсов ЕІетепР и РогтСопРгоІ, а также следующие свойства, соответствую¬ 
щие НТМЬ-атрибу там: соіз, тахІ_епд1:М, гоѵѵз, ріасеііоісіег, геасІОпІу, гедиігесі имгар. 
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зігіпд (Іе^аиІТѴаІие 

Начальное текстовое содержимое элемента <іех1:агеа>. Когда выполняется сброс 
формы, содержимое текстовой области восстанавливается в это значение. Это свой¬ 
ство имеет то же значение, что и свойство ІехіСопіепІ:, унаследованное от Иосіе. 

ипзідпесі Іопд зеІесііопЕпй 

Возвращает или устанавливает индекс первого введенного символа, следующего 
за выделенным текстом. См. также зеіЗеІесііопРапдеО. 

ипзідпесі Іопд 8е1есІіоп$ІаП 

Возвращает или устанавливает индекс первого выделенного символа в элементе 

<іех1:агеа>. См. также зеіЗеІесііопРапдеО. 

геасіопіу ипзідпесі Іопд ІехНепдІГі 

Длина свойства ѵаіие в символах (см. РогтСопігоІ). 

Методы 

В дополнение к методам, перечисленным ниже, элементы ТехіАгеа реализуют методы 
интерфейсов Еіетепі: и РогтСопігоІ. 

ѵоісі зеІесіО 

Выделяет весь текст в элементе <іех1:агеа>. Во многих броузерах это означает, что 
текст будет выделен цветом и при вводе очередного символа выделенный текст бу¬ 
дет удален и замещен введенным символом. 

ѵоісі зеі8е1ес1іопРапде(ипзідпесІ Іопд зГагГ, ипзідпесі Іопд епб) 

Выделяет текст в элементе <іех1:агеа>, начиная с символа в позиции зіагі и закан¬ 
чивая (но не включая его) символом в позиции епсі. 

ТехІМеігісз 

определяет размеры текстовой строки 

Объект ТехіМеігісз возвращается методом теазигеТехіО объекта СапѵазРепсІегіпдСоп- 
Іех*20. Его свойство \л/ісІ1:іі хранит ширину текста в С88-пикселах. В будущем могут 
быть добавлены дополнительные размеры. 

Свойства 

геасіопіу РоиЫе нісШі 

Ширина текста в С88-пикселах. 

ТітеКапдез 

множество фрагментов мультимедийных данных 

Свойства Ьи^егесІ, ріауесі и зеекаЫе элемента МесІіаЕІетепІ: представляют блоки муль¬ 
тимедийных данных, загруженных в буфер, которые были проиграны и которые 
можно начать проигрывать. Каждый из этих блоков может включать множество раз¬ 
розненных фрагментов (это характерно для свойства ріауесі, когда, например, пользо¬ 
ватель перепрыгивает к середине видеозаписи). Объект ТітеЯапдез представляет ноль 
или более разрозненных фрагментов. Свойство Іепдііі определяет количество фраг¬ 
ментов, а методы зіагіО и епсІ() возвращают границы каждого фрагмента. 

Объекты ТітеЯапдез, возвращаемые объектами МесІіаЕІетепІ:, всегда нормализованы , 
т. е. в них отсутствуют пустые и смежные или перекрывающиеся фрагменты. 
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Свойства 

геасіопіу ипзідпесі Іопд ІепдіИ 

Количество фрагментов, представленных данным объектом ТітеПапдез. 

Методы 

йоиЫе еги1(ипзідпес1 Іопд п ) 

Возвращает конец фрагмента п (в секундах) или возбуждает исключение, если зна¬ 
чение п меньше нуля или больше или равно значению свойства ІепдІМ. 

сІоиЫе з*аг*(ипзідпесІ Іопд п ) 

Возвращает начало фрагмента п (в секундах) или возбуждает исключение, если 
значение п меньше нуля или больше или равно значению свойства ІепдТМ. 

ТуресІАггау 1 

массивы с двоичными элементами фиксированного размера АггауВиНегѴіеж 

Типизированные массивы являются подтипами АггауВиІ'І'егѴіем, который интерпре¬ 
тирует байты в объекте АггауВиІ'І'ег, на котором он основан, как массив чисел и позво¬ 
ляет читать и изменять элементы этого массива. Данная справочная статья описыва¬ 
ет не какой-то конкретный тип типизированных массивов, а охватывает восемь раз¬ 
ных видов типизированных массивов . Все эти восемь типов являются подтипами 
АггауВиІ'І'егѴіем и отличаются друг от друга только количеством байтов, выделенных 
для одного элемента массива и способом интерпретации этих элементов. В число этих 
восьми типов входят: 

Іп1:8Аггау 

Массив однобайтных элементов, которые интерпретируются как целые со знаком. 

ІпІІбАггау 

Массив двухбайтных элементов, которые интерпретируются как целые со знаком, 
с использованием порядка следования байтов, определяемого платформой. 

Іп1:32Аггау 

Массив четырехбайтных элементов, которые интерпретируются как целые со зна¬ 
ком, с использованием порядка следования байтов, определяемого платформой. 

ІЯпі:8Аггау 

Массив однобайтных элементов, которые интерпретируются как целые без знака. 

1Яп1:16Аггау 

Массив двухбайтных элементов, которые интерпретируются как целые без знака, 
с использованием порядка следования байтов, определяемого платформой. 

1Яп1:32Аггау 

Массив четырехбайтных элементов, которые интерпретируются как целые без 
знака, с использованием порядка следования байтов, определяемого платформой. 

Р1оа1:32Аггау 

Массив четырехбайтных элементов, которые интерпретируются как вещественные 
числа, с использованием порядка следования байтов, определяемого платформой. 


1 В клиентском ^ѵа8сгірі нет типа ТуресІАггау. Автор использовал это символическое 
имя для более краткого обозначения типизированных массивов. - Прим.ред. 
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Р1оа1:64Аггау 

Массив восьмибайтных элементов, которые интерпретируются как вещественные 
числа, с использованием порядка следования байтов, определяемого платформой.* 

Как следует из названий, эти типы являются объектами, подобными массивам, кото¬ 
рые обеспечивают доступ к значениям элементов с использованием привычной фор¬ 
мы обращения к массивам с квадратными скобками. Отметьте однако, что объекты 
этих типов всегда имеют фиксированную длину. 

Как отмечалось в описании выше, классы ТуресіАггау по умолчанию используют поря¬ 
док следования байтов, определяемый платформой. См. описание типа ОаіаѴіем, пред¬ 
назначенного для представления АггауВиІ^ег, который позволяет явно определять по¬ 
рядок следования байтов. 

Конструктор 

пеѵѵ 7уресИггау(ипзідпесІ Іопд ІепдіИ) 
пен 7уресМггау(Турес1Аггау аггау) 
п еѵі ТуресІАггау(1:уре[] аггау) 

п еѵі ТуресіАггау(АггауЪиі^ег ЬиТТег, [ипзідпесі Іопд ЬуІеОТТзеІ], [ипзідпесі Іопд ІепдТІі]) 

Для каждой из восьми разновидностей типизированных массивов имеется конст¬ 
руктор, который можно вызвать одним из приведенных выше четырех способов. 
Конструкторы действуют следующим образом: 

• Если конструктор вызывается с единственным числовым аргументом, он созда¬ 
ет новый типизированный массив с указанным количеством элементов и ини¬ 
циализирует каждый элемент нулем. 

• Если конструктору передается единственный объект типизированного масси¬ 
ва, он создает новый типизированный массив с тем же количеством элементов, 
что и в массиве в аргументе, и копирует элементы из массива в аргументе во 
вновь созданный массив. Тип массива в аргументе не обязательно должен сов¬ 
падать с типом создаваемого массива. 

• Если конструктору передается единственный массив (истинный массив), он 
создает новый типизированный массив с тем же количеством элементов, что 
и в массиве в аргументе, и копирует элементы из массива в аргументе во вновь 
созданный массив. 

• Наконец, если конструктору передается объект АггауВиііегс необязательными 
аргументами, определяющими смещение и длину, он создает новый типизиро¬ 
ванный массив, который является представлением указанной области объекта 
Аг гауВиІ'іег. Длина нового типизированного массива зависит от размера области 
в АггауВи^ег и размера элементов в типизированном массиве. 

Константы 

Іопд ВѴТЕ$_РЕВ_ЕІ_ЕМЕМТ 

Количество байтов, занимаемых каждым элементом данного массива в лежащем 
в основе объекте АггауВиІ'І'ег. Эта константа будет иметь значение 1, 2, 4 или 8, в за¬ 
висимости от вида типизированного массива. 

Свойства 

геасіопіу ипзідпесі Іопд Іепдій 

Количество элементов в массиве. Типизированные массивы имеют фиксирован¬ 
ный размер, поэтому значение этого свойства никогда не изменяется. Не путайте 
это свойство со свойством ЬуіеІепдіИ, унаследованным от АггауВиііегѴіеѵѵ. 
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Методы 

ѵоісі $еХ(ТуресІАггау аггау , [ипзідпесі Іопд оГГзеТ]) 

Копирует элементы массива аггау в данный типизированный массив, начиная 
с индекса оТТзе !. 

ѵоісі зе*(питЬег[] аггау, [ипзідпесі Іопд оТТзеХ "]) 

Эта версия метода зеі() подобна предыдущей, но принимает не типизированный, 
а истинный массив. 

ТуресІАггау зиЬаггау(1опд зТагТ, Іопд епб) 

Возвращает новый типизированный массив, опирающийся на тот же объект Аггау- 
Виііег, что и данный массив. Первым элементом возвращаемого массива является 
элемент данного массива с индексом зТагТ. А последним - элемент данного массива 
с индексом епд- 1. Отрицательные значения в аргументах зіагі: и епсі интерпретиру¬ 
ются как смещения относительно конца данного массива. 

ІІКІ. 

методы для работы с ІЖ-адресами, ссылающимися на объекты ВІоЬ 

Свойство IIВ І_ объекта Іл/іпсіом ссылается на этот объект ІІНІ_. В будущем этот объект мо¬ 
жет превратиться в конструктор класса, реализующего средства синтаксического 
анализа и выполнения операций с ШІЬ-адресами. Однако на момент написания этих 
строк оно служило пространством имен для описываемых ниже двух функций, пред¬ 
назначенных для работы с ІШЬ-адресами, ссылающимися на объекты. Дополнитель¬ 
ные сведения об объектах ВІоЬ и об ІШЬ-адресах, ссылающихся на них, приводятся 
в разделах 22.6 и 22.6.4. 

Объект IIВ І_ был новинкой на момент написания этих строк, и его прикладной интер¬ 
фейс еще не был стабилизирован. Вам может потребоваться использовать префикс 
производителя броузера при работе с ним, например ѵѵеЬкііІЖ. 

Функция 

зігіпд сгеа1еОУес*1ШЦВ1оЬ ЫоЬ) 

Возвращает ІІКЬ-адрес, ссылающийся на двоичный объект ЫоЬ. НТТР СЕТ-запро- 
сы по этому ІІКЬ-адресу будут возвращать содержимое ЫоЬ. 

ѵоісі геѵокеОЬіесШЦзігіпд игі ) 

Отзывает (делает недействительным) адрес игі так, что он больше не будет связан 
с каким-либо объектом ВІоЬ и не сможет использоваться для загрузки данных. 

Ѵісіео 

НТМЬ-элемент <ѵісІео> Иосіе, Еіетепі, МесІіаЕІетепІ 

Объект Ѵісіео представляет НТМЬ-элемент <ѵійео>. Элементы <ѵіс!ео> и <аисЗіо> очень по¬ 
хожи друг на друга, и их общие свойства и методы были описаны в справочной статье 
МесІіаЕІетепІ:. Эта справочная статья описывает несколько дополнительных свойств, 
которыми обладают только объекты Ѵісіео. 

Свойства 

00МЗеііаЬ1еТокепІ_із1: аийіо 

Это свойство определяет аудиопараметры видеозаписи. Параметры указываются 
в НТМЬ-атрибуте аисііо в виде списка названий параметров, разделенных пробела¬ 
ми, и в программном коде на языке ^ѵаЭсгірІ; отражаются в множество ООМЗеТ- 
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ТаЫеТокепИзТ. Однако на момент написания этих строк стандарт НТМЬб опреде¬ 
лял только один параметр («тігіесі»), поэтому данное свойство можно интерпрети¬ 
ровать как строку. 

ипзідпесі Іопд ЬеідГѵС 

Высота элемента <ѵіс!ео> на экране в С88-пикселах. Соответствует НТМЬ-атрибуту 

МеідМІ:. 

зТгіпд розТѳг 

ШІЬ-адрес изображения, отображаемого в качестве «афиши» до того, как будет 
запущено проигрывание видеозаписи. Соответствует НТМЬ-атрибуту розіег. 

геасіопіу ипзідпесі Іопд ѵійеоНеідЫ 
геасіопіу ипзідпесі Іопд ѵійеоМісШі 

Эти свойства возвращают истинную высоту и ширину кадра видеозаписи в С88- 
пикселах. Эти свойства будут иметь нулевые значения, пока элемент <ѵіс!ео> не за¬ 
грузит метаданные (пока свойство геасІуЗіаіе имеет значение НАѴЕ_№ТНІМС, и не бы¬ 
ло сгенерировано событие «Іоасіесітеіасіаіа»). 

ипзідпесі Іопд иісіій 

Желаемая ширина элемента <ѵіс!ео> на экране в С88-пикселах. Соответствует 
НТМЬ-атрибуту \л/ісИ:И. 

ѴѴеЬ5оскеі 

двунаправленное сетевое соединение, подобное сокету ЕѵепіТагдеІ 

Объект МеЬЗоскеі представляет долгоживущее, двунаправленное сетевое соединение 
с сервером, поддерживающим протокол веб-сокетов. Данная модель сетевых взаимо¬ 
действий существенно отличается от модели запрос/ответ, которую реализует прото¬ 
кол НТТР. Создать новое сетевое соединение можно вызовом конструктора МеЬЗоске1:(). 
Отправлять текстовые данные на сервер можно с помощью метода зепс!( ), а принимать 
сообщения от сервера - с помощью обработчика событий «тезза&е». Дополнительные 
сведения приводятся в разделе 22.9. 

Веб-сокеты - это новый прикладной интерфейс для веб-приложений; на момент на¬ 
писания этих строк поддерживался не всеми броузерами. 

Конструктор 

пем Ѵ/еЬ8оске*(з1:гіпд игі, [зігіпдП ргоіосоіз ]) 

Конструктор Іл/еЬЗоскеіО создает новый объект Іл/еЬЗоскеІ: и запускает (асинхрон¬ 
ный) процесс установления соединения с сервером, поддерживающим протокол 
веб-сокетов. Аргумент игі определяет сервер, с которым требуется установить со¬ 
единение, и должен быть абсолютным ШІЬ-адресом с ШІЬ-схемой \л/з:// или мзз://. 
Аргумент ргоТосоІз - это массив названий подпротоколов. С помощью этого аргу¬ 
мента клиент может сообщить серверу, какие версии протоколов он поддержива¬ 
ет. Сервер должен выбрать один из них и информировать клиента о своем выборе 
в процессе установления соединения. В аргументе ргоТосоІз можно также передать 
строку, а не массив: в этом случае значение аргумента будет интерпретироваться 
как массив с единственным элементом. 

Константы 

Следующие константы определяют допустимые значения свойства геасІуЗіаіе. 
ипзідпесі зіюгі: ССШЕСТІМб = О 

Продолжается выполнение процедуры установления соединения. 
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ипзідпесі зМогі: ОРЕИ = 1 

Объект МеЬЗоскеІ: соединен с сервером; можно отправлять и принимать сообщения, 
ипзідпесі зіюгі: СЮЗІИО = 2 
Соединение закрывается, 
ипзідпесі зіюгі: СЮЗЕЭ = 3 
Соединение закрыто. 

Свойства 

геасіопіу ипзідпесі Іопд Ьіі^егейАтоипІ 

Количество символов сообщения, переданного методу зепс!( ), которые еще не были 
отправлены фактически. Это свойство можно использовать при передаче больших 
объемов данных, чтобы гарантировать, что программа не будет отправлять сооб¬ 
щения быстрее, чем они могут быть переданы по сети. 

геасіопіу зігіпд ргоіосоі 

Если конструктору МеЬЗоскеіО был передан массив подпротоколов, это свойство 
будет хранить один из них, выбранный сервером. Обратите внимание, что в пер¬ 
вый момент после создания объекта МеЬЗоскеІ: соединение еще не установлено и вы¬ 
бор сервера неизвестен, поэтому первоначально это свойство содержит пустую 
строку. Если конструктору был передан список протоколов, значение этого свойст¬ 
ва изменится в соответствии с выбором сервера, когда будет сгенерировано собы¬ 
тие «ореп». 

геасіопіу ипзідпесі зіюгі: геайуЗгаІе 

Текущее состояние соединения. Значением этого свойства может быть одна из 
констант, перечисленных выше. 

геасіопіу зігіпд игі 

Это свойство хранит ІШЬ-адрес, который был передан конструктору МеЬЗоскеіО- 

Методы 

ѴОІСІ СІ03Ѳ() 

Если соединение еще не закрыто или для него еще не была запущена процедура 
закрытия, этот метод инициирует процесс его закрытия и присваивает свойству 
геасІуЗіаіе значение СЮЗІМС. События «тезза&е» могут продолжать возбуждаться 
даже после вызова метода с1озе(), пока свойство геасІуЗіаіе не получит значение 
СЮЗЕй и не будет возбуждено событие «сіозе». 

ѵоісІ зѳгкКзігіпд сіаТа) 

Отправляет данные дата на сервер, подключенный к другому концу соединения. 
Этот метод возбуждает исключение, когда вызывается до того, как будет сгенери¬ 
ровано событие «ореп», т.е. пока свойство геас!уЗі:а1:е имеет значение ССШЕСТІМО. 
Протокол веб-сокетов поддерживает обмен двоичными данными, но на момент на¬ 
писания этих строк текущая версия прикладного интерфейса веб-сокетов поддер¬ 
живала только текстовые сообщения. 

Обработчики событий 

Сетевые взаимодействия по своей природе являются асинхронными, и, подобно объ¬ 
екту ХМЕНіірРедиезІ:, объект Іл/еЬЗоскеІ: также опирается на использование событий. Он 
определяет четыре свойства регистрации обработчиков событий, а также реализует 
интерфейс ЕѵепіТагдеІ:, благодаря чему обработчики событий можно также регистри¬ 
ровать с помощью методов интерфейса ЕѵепіТагдеІ:. Все события, описываемые ниже. 




1022 


Справочник по клиентскому іаѵаБсгір* 


возбуждаются в объекте МеЬЗоскеІ:. Ни одно из них не всплывает, и ни для одного из 
них не предусмотрено действий по умолчанию, которые можно было бы отменить. От¬ 
метьте, однако, что им передаются различные объекты событий. 

опсіозе 

Событие «сіозе» генерируется после закрытия соединения (и свойство геайуЗТаТе 
получит значение СЮЗЕй). Обработчику события передается объект СІозеЕѵепІ:, ко¬ 
торый определяет, было соединение закрыто без ошибок или нет. 

опеггог 

Событие «еггог» генерируется, когда возникает сетевая ошибка или ошибка про¬ 
токола веб-сокетов. Обработчику события передается обычный объект Еѵепі:. 

оптеззаде 

Когда сервер отправляет данные через веб-сокет, объект Іл/еЬЗоскеІ: возбуждает со¬ 
бытие «тезза^е» и передает обработчику объект МеззадеЕѵепі:, свойство сіаііа кото¬ 
рого ссылается на принятое сообщение. 

опореп 

Конструктор Іл/еРЗоске1:( ) возвращает управление еще до того, как будет установле¬ 
но соединение с адресом игі. Когда процедура установления соединения завершит¬ 
ся и объект МеРЗоскеІ: будет готов к отправке и приему данных, будет возбуждено 
событие «ореп». Обработчику события передается обычный объект Еѵепі:. 

ѴѴіпсІоѵѵ 

окно, вкладка или фрейм веб-броузера ЕѵепІГагдеі 

Объект Міпсіом представляет окно, вкладку или фрейм в броузере. Он подробно описан 
в главе 14. В клиентском Лѵа8сгірІ-коде объект МіпРоѵѵ выступает в качестве «гло¬ 
бального» объекта, и все выражения вычисляются в контексте текущего объекта 
Міпсісм. Это значит, что для обращения к текущему окну не требуется использовать 
специальный синтаксис и свойства этого объекта можно использовать, как если бы 
они были глобальными переменными. Например, вместо піпсі ом. боситпі можно пи¬ 
сать сіосішепі:. Аналогично можно вызывать методы текущего объекта окна, как если 
бы они были функциями, например а1ег1:() вместо міпс!ом.а1ег1(). 

Некоторые свойства и методы этого объекта фактически позволяют определять и из¬ 
менять некоторые параметры окна броузера. Другие включены в этот объект просто 
потому, что он является глобальным объектом. Помимо перечисленных здесь свойств 
и методов объект Міпсіом реализует все глобальные функции, определяемые базовым 
языком ^ѵаЗсгірІ. Подробности см. в справочной статье ОІоЬаІ в третьей части книги. 

Веб-броузеры возбуждают в окнах множество различных событий. Это означает, что 
объект Міпсісм определяет массу обработчиков событий и что объекты Міпсісм реализу¬ 
ют методы интерфейса ЕѵепІіТагдеІ:. 

В объекте Міпйом имеются свойства міпйом и зеП, которые ссылаются на само окно. Они 
позволяют явно задать ссылку на окно. 

Объект Міпсісм может содержать другие объекты Міпсіом, обычно в виде тегов <і1тате>. 
Каждый объект Міпсіом является объектом, подобным массиву, содержащим вложен¬ 
ные объекты Міпсісм. Однако вместо непосредственного индексирования объекта Міпсіом 
на практике обычно используется свойство Ітатез, ссылающееся на сам объект, как 
если бы это был объект, подобный массиву. Свойства рагепі: и Іор объекта Міпсіом ссыла¬ 
ются непосредственно на родительское окно и на окно верхнего уровня. 

Новые окна верхнего уровня создаются вызовом метода Міпсіом.ореп(). При вызове это¬ 
го метода можно сохранить возвращаемое им значение в переменной и затем исполь- 
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зовать эту переменную для ссылки на новое окно. Свойство орепег нового окна будет 
ссылаться на окно, открывшее его. 

Свойства 

В дополнение к свойствам, перечисленным ниже, содержимое документа, отображае¬ 
мого в окне, создает новые свойства. Как описывается в разделе 14.7, на элемент доку¬ 
мента можно сослаться, использовав значение его атрибута ісі в качестве имени свой¬ 
ства окна (а поскольку его окно является глобальным объектом, его свойства являют¬ 
ся глобальными переменными). 

геасіопіу АррІісаІіопСасИе аррІісаІіопСасЬѳ 

Ссылка на объект Аррі ісаТіопСасИе. Кэшируемые и автономные веб-приложения 
могут использовать это свойство для управления обновлением своего кэша. 

геасіопіу апу (ЛаІодАгдшпепіз 

В объектах Міпсіом, созданных методом зМо\л/Мос!а10іа1од( ), это свойство хранит зна¬ 
чение аргумента агдитепХз , переданного методу зМоѵѵМосІаІ0іа1од( ). В обычных объ¬ 
ектах Міпсіоѵ/ это свойство отсутствует. Подробнее см. в разделе 14.5. 

геасіопіу Ооситепі: йоситепі 

Ссылка на объект Ооситепі:, который описывает документ, содержащийся в этом 
окне (подробности см. в справочной статье Ооситепі:). 

геасіопіу Еѵепі: еѵепі [только в ІЕ] 

В Іпіегпеі Ехріогег это свойство ссылается на объект Еѵепі:, содержащий сведения 
о самом последнем произошедшем в окне событии. В ІЕ версии 8 и ниже объект со¬ 
бытия не всегда передается обработчикам событий, и поэтому иногда его приходит¬ 
ся извлекать из этого свойства. Дополнительные сведения приводятся в главе 17. 

геасіопіу Еіетепі: ІгатеЕІетепІ 

Если данный объект Міпсіом находится внутри элемента <і1тате>, это свойство будет 
ссылаться на представляющий его объект ІГгате. В окнах верхнего уровня это 
свойство имеет значение пиіі. 

геасіопіу Міпсіом Ітатез 

Подобно свойствам зеП и міпсіом, это свойство ссылается на сам объект Міпсіом. Все 
объекты Міпсіом являются объектами, подобными массивам, содержащими фрей¬ 
мы, имеющиеся в данном окне. Вместо ссылки м[0] на первый фрейм в окне м это 
свойство позволяет использовать более очевидную форму записи м.1тате5[0]. 

геасіопіу Нізіогу Ніеіогу 

Ссылка на объект Нізіогу данного окна. См. Нізіогу. 
геасіопіу Іопд іппегНеід&І 
геасіопіу Іопд іппегМісІІН 

Высота и ширина в пикселах экранной области вывода окна. Эти свойства не под¬ 
держиваются в ІЕ версии 8 и ниже. Порядок использования этих свойств демонст¬ 
рируется в примере 15.9. 

геасіопіу ипзідпесі Іопд ІепдІЬ 

Количество фреймов, содержащихся в данном окне. См. описание свойства Ітатез. 
геасіопіу Зіогаде ІосаІЗІогадѳ 

Это свойство ссылается на объект Зіогаде, предоставляющий доступ к хранилищу 
пар имя/значение на стороне клиента. Данные, сохраненные с помощью свойства 
ІосаІЗіогаде, доступны любым документам с тем же происхождением и хранятся, 
пока не будут удалены пользователем или сценарием. См. также зеззіопЗіогаде 
и раздел 20.1. 
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геасіопіу І_осаі:іоп ІосаТіоп 

Объект 1_оса1:іоп для данного окна. Этот объект определяет ІШЬ-адрес текущего 
загруженного документа. Запись нового ІШЬ-адреса в это свойство приводит к за¬ 
грузке и выводу содержимого этого ІШЬ-адреса в броузере. См. 1_оса1:іоп. 

зТгіпд паше 

Имя окна. Имя может быть задано при создании окна методом ореп() или в виде 
значения атрибута пате в теге <1тате>. Имя окна может использоваться в качестве 
значения атрибута ТагдеТ в теге <а> или <іогт>. При таком применении атрибут 
іа где* указывает, что документ, загружаемый по гиперссылке, или результаты от¬ 
правки данных формы должны отображаться в указанном окне. 

геасіопіу Маѵідаііог паѵідаіог 

Ссылка на объект Маѵідаііог, позволяющий получить информацию о версии и кон¬ 
фигурации веб-броузера. См. Маѵідаііог. 

геасіопіу Іл/іпс1о\л/ орепег 

Доступная для чтения и записи ссылка на объект Міпйом, в котором содержится 
сценарий, вызвавший метод ореп() для открытия в броузере окна верхнего уровня, 
или пиіі в окнах, созданных иным способом. Это свойство действительно только 
для объектов Міпсіом, представляющих окна верхнего уровня, но не для объектов, 
представляющих фреймы. Свойство орепег может использоваться во вновь создан¬ 
ном окне для доступа к свойствам и методам создавшего его окна. 

геасіопіу Іопд оиіегНеідЫ 

геасіопіу Іопд оиіегШсЛЬ 

Эти свойства определяют общую высоту и ширину окна броузера в пикселах. Эти 
размеры включают высоту и ширину строки меню, панелей инструментов, полос 
прокрутки, рамок окна и тому подобное. Эти свойства не поддерживаются в ІЕ вер¬ 
сии 8 и ниже. 

геасіопіу Іопд радеХОіізеі 

геасіопіу Іопд радеѴОіізеі: 

Число пикселов, на которые текущий документ был прокручен вправо (радеХОіізеі) 
и вниз (радеѴОіізеі). Эти свойства не поддерживаются в ІЕ версии 8 и ниже. Поря¬ 
док использования этих свойств и совместимый программный код, действующий 
в ІЕ, демонстрируются в примере 15.8. 

геасіопіу Міпсіом рагепі 

Объект Міпсіом, содержащий данное окно. Если данное окно является окном верх¬ 
него уровня, рагепі ссылается на само окно. Если данное окно является фреймом, 
свойство рагепі ссылается на окно или фрейм, в котором содержится данное окно. 

зігіпд геіигпѴаІие 

Это свойство отсутствует в обычных окнах, но присутствует в объектах Міпсіом, соз¬ 
данных методом зМо\л/Мос1аШа1од(), и по умолчанию содержит пустую строку. Ко¬ 
гда окно диалога закрывается (см. описание метода с1озе()), этому свойству при¬ 
сваивается значение, возвращаемое методом зІ~юмМос!а10іа1од(). 

геасіопіу Зсгееп зсгееп 

Объект Зсгееп, свойства которого содержат информацию об экране, включая число 
доступных пикселов и цветов. Подробности см. в справочной статье Зсгееп. 

геасіопіу Іопд зсгеепХ 
геасіопіу Іопд зсгеепѴ 

Координаты верхнего левого угла окна на экране. 
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геасіопіу Міпсісм зеИ 

Ссылка на само окно. Синоним свойства міпсіом. 
геасіопіу Зіогаде зеззіопЗІогаде 

Это свойство ссылается на объект Зі:огаде, предоставляющий доступ к хранилищу 
пар имя/значение на стороне клиента. Данные, сохраненные с помощью свойства 
зеззіопЗііогаде, доступны только документам в том же окне верхнего уровня или 
вкладке и хранятся только в течение сеанса работы с броузером. См. также Іосаі- 
Згогаде и раздел 20.1. 

геасіопіу іл/іпсісм *ор 

Окно верхнего уровня, содержащее данное окно. Если данное окно является окном 
верхнего уровня, свойство Іор содержит ссылку на само окно. Если данное окно 
представляет собой фрейм, свойство 1:ор ссылается на окно верхнего уровня, содер¬ 
жащее данный фрейм. Сравните со свойством рагепі:. 

геасіопіу оЬ^есІ: 1^1. 

На момент написания этих строк данное свойство было ссылкой на объект, опреде¬ 
ляющий функции, которые были описаны в справочной статье 1Ш1_. В будущем это 
свойство может превратиться в конструктор IIРЦ) и определять прикладной ин¬ 
терфейс для анализа ІШЬ-адресов и строк запроса в них. 

геасіопіу Міпсісм иіпііои 

Свойство міпсіом идентично свойству зеН - оно содержит ссылку на данное окно. 
Поскольку в клиентских сценариях на языке ЛѵаЗсгірі объект Міпсіом является 
глобальным объектом, данное свойство позволяет обращаться к глобальному объ¬ 
екту как к глобальной переменной міпсіом. 

Конструкторы 

Будучи глобальным объектом, объект Міпсіом должен определять все глобальные кон¬ 
структоры, необходимые для клиентского окружения. Хотя здесь их перечень не при¬ 
водится, следует понимать, что все глобальные конструкторы, описанные в этой час¬ 
ти книги, являются свойствами объекта Міпсіоѵ/. Тот факт, что в клиентском ЛѵаЗсгірі 
определены, к примеру, конструкторы Ітаде() и ХМШПрВедиезШ, означает, что каж¬ 
дый объект іл/іпсісм имеет свойства с именами Ітаде и ХМЫНІіІірРІедиезі:. 

Методы 

Объект іл/іпсіом определяет следующие методы, а также наследует все глобальные 
функции, определяемые в базовом языке ЛѵаЗсгірі (см. справочную статью СІоЬаІ 
в третьей части книги). 

ѵоісі а1ег!(зі:гіпд теззаде) 

Метод а1егі:() показывает пользователю сообщение теззаде в диалоговом окне. 
Диалоговое окно содержит кнопку 0К, на которой пользователь может щелкнуть, 
чтобы закрыть окно. Обычно метод аІегіО выводит модальное диалоговое окно, 
и исполнение Лѵа8сгірІ-кода приостанавливается до тех пор, пока пользователь 
не закроет его. 

зіігіпд а!оЬ(з1:гіпд аіоЬ) 

Эта вспомогательная функция принимает строку в формате Ьазе64 и декодирует ее 
в двоичную строку, где каждый символ представлен единственным байтом. Извле¬ 
кать значения байтов из полученной строки можно с помощью ее метода сМагСо- 
с!еА1:(). См. также Ы:оа(). 
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ѵоісі Ыиг() 

Метод Ыиг() убирает фокус ввода из окна верхнего уровня, соответствующего объ¬ 
екту іл/іпсісм. Точно не определено, какому окну передается фокус в результате вьг 
зова этого метода. В некоторых броузерах и/или на некоторых платформах дан¬ 
ный метод может не оказывать никакого эффекта. 

зТгіпд ЬТоа(зі:гіпд Ы:оа) 

Эта вспомогательная функция принимает двоичную строку (в которой каждый 
символ представлен единственным байтом) и возвращает ее в формате Ьазе64. Соз¬ 
дать двоичную строку из произвольной последовательности байтов можно с помо¬ 
щью метода 8ігіпд.1тотСііагСос1е(). См. также аІоЬО. 

ѵоісі с1ѳагІп*егѵа1(1опд ЬагиЗІе) 

Метод сІеагІпіегѵаЦ ) останавливает периодическое выполнение программного ко¬ 
да, которое было начато вызовом метода зеіІпіегѵаІО. В качестве аргумента ЬапсЯе 
должно передаваться значение, полученное при вызове метода зеіІпіегѵаІО 

ѵоісі с1ѳагТітеои*(1опд Ьапсііе) 

Метод сІеагТішеоиіО отменяет выполнение программного кода, отложенное мето¬ 
дом зеіТітеоиіО. Аргумент ЬапсІІе- это значение, возвращаемое вызовом зеШте- 
оиі() и идентифицирующее блок программного кода, отложенное исполнение ко¬ 
торого отменяется. 

ѵоісі с1озе() 

Метод с1озе() закрывает окно верхнего уровня, относительно которого он был вы¬ 
зван. Закрыты могут быть только те окна, которые были открыты Лѵа8сгірі-сце- 
нарием. 

Ьооіеап соп^ігт(зі:гіпд теззаде) 

Выводит сообщение теззаде в диалоговом окне, содержащем кнопки 0К и Сапсеі (От¬ 
мена), с помощью которых пользователь должен ответить на вопрос. Если пользо¬ 
ватель щелкнет на кнопке 0К, метод сопІЧгтО вернет Іігие. Если пользователь щелк¬ 
нет на кнопке Сапсеі, метод соп^ігш() вернет іаізе. 

ѵоісі ^осиз() 

Передает фокус ввода окну верхнего уровня, соответствующему объекту іл/іпсіо\л/. 
На большинстве платформ при получении фокуса окно верхнего уровня переме¬ 
щается на вершину стека окон. 

СЗЗЗіуІеОесІагаІііоп дѳ*Сотри*е<1$*у1е(Е1етепі: еІТ, [зігіпд рзеибоЕІі]) 

Элемент документа может получать информацию о стиле из встроенного атрибута 
зіуіе и из произвольного числа каскадных таблиц стилей. Прежде чем элемент бу¬ 
дет отображен в окне, информация о стилях для этого элемента должна быть из¬ 
влечена из каскадных таблиц стилей, а величины, выражаемые в относительных 
единицах (таких как проценты или «етз»), должны быть «вычислены» и преобра¬ 
зованы в абсолютные значения. Эти вычисленные значения иногда называют «ис¬ 
пользуемыми» значениями. 

Данный метод возвращает доступный только длячтенияобъектСЗЗЗіуІеОесІагаІііоп, 
который представляет эти вычисленные С88-стили, фактически используемые 
при отображении элементов. Все размеры в этих стилях выражены в пикселах. 

Второй аргумент при вызове этого метода обычно опускается или в нем передается 
значение пи 11, однако в нем можно также передать псевдоэлемент С88 «::Ъеіоге» 
или «::аі:1ег», чтобы определить стили для содержимого. 

Сравните метод де!Сотри1:есІ5і:у1е() со свойством зіуіе объекта НТМІ_Е1етеп1:, которое 
предоставляет доступ только к встроенным стилям элемента. Величины в этом 
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свойстве могут измеряться в любых единицах, но оно ничего не сообщает о стилях 
из таблиц стилей, которые применяются к элементу. 

Этот метод не реализован в ІБ версии 8 и ниже, но аналогичная функциональ-» 
ноетъ доступна через нестандартное свойство сиггеп1:31:у1е, имеющееся у каждого 
объекта НТМІ_Е1етепі:. 

Іл/іпсісм орѳп([зі:гіпд игі], [зігіпд ТагдеТ], [зігіпд ТеаТигез], [зіігіпд геріасё]) 

Метод ореп() загружает и отображает документ с адресом игі в новом или сущест¬ 
вующем окне или вкладке. Аргумент игі определяет ІІКЬ-адрес документа, кото¬ 
рый требуется загрузить. Если он не указан, используется адрес «аЪоиігЫапк». 

Аргумент ТагдеТ определяет имя окна, в которое требуется загрузить документ с ад¬ 
ресом игі. Если не указан, используется значение «_Ыапк». Если аргумент ТагдеТ 
имеет значение «_Ыапк», или если окно с указанным именем не найдено, для ото¬ 
бражения документа с адресом игі будет создано новое окно с указанным именем. 

Аргумент ТеаТигез используется для определения позиции окна, размеров и дру¬ 
гих особенностей (таких как необходимость отображения строки меню, панелей 
инструментов и так далее). В современных броузерах, поддерживающих вкладки, 
этот аргумент обычно игнорируется и поэтому не описывается здесь. 

При использовании метода Міпс1о\л/.ореп() для загрузки нового документа в сущест¬ 
вующее окно методу можно передать аргумент геріасе , определяющий, должна ли 
для нового документа создаваться новая запись в истории просмотра окна или ІІКЬ- 
адрес документа должен заменить текущую запись. Если аргумент геріасе равен 
{гие, то ІІКЬ-адрес нового документа заменяет старую запись. Если этот аргумент 
равен Шзе или не указан, то ІІКЬ-адрес нового документа добавляется в историю 
просмотра окна в качестве новой записи. Этот аргумент обеспечивает методу функ¬ 
циональность, во многом схожую с функциональностью метода 1_оса1:іоп. гер1асе(). 

ѵоіеі ро8ІМе88аде(апу теззаде, зігіпд ТагдеТОгідіп , [МеззадеРогі:[] рогТз ]) 

Посылает данному окну копию сообщения теззаде в порты рогТз 9 но только если 
документ, отображаемый в данном окне, имеет происхождение ТагдеТОгідіп. 

В аргументе теззаде можно передать любой объект, который можно скопировать 
с применением алгоритма структурированного копирования (врезка «Структуриро¬ 
ванные копии» в главе 22). Аргумент ТагдеТОгідіп должен быть абсолютным ІІКЬ-ад- 
ресом, содержащим протокол, имя хоста и порт, которые определяют требуемое 
происхождение. Если происхождение не имеет значения, в аргументе ТагдеТОгідіп 
можно передать строку «*», а чтобы указать собственное происхождение сценария - 
строку «/». Вызов этого метода генерирует событие «теззаде» в окне. См. также 
МеззадеЕѵепі: и раздел 22.3. 

ѵоіеі ргіпі() 

На вызов метода ргіпі:() броузер реагирует так же, как если бы пользователь вы¬ 
брал пункт меню или щелкнул на кнопке Ргіпі (Печать). Обычно после этого появля¬ 
ется диалоговое окно, позволяющее отменить операцию печати или выполнить 
дополнительную настройку. 

зігіпд рготрі(з1:гіпд теззаде , [зіігіпд РеТаиЩ) 

Метод рготріО выводит сообщение теззаде в диалоговом окне, содержащем поле 
ввода и кнопки 0К и Сапсеі, и блокирует работу сценария, пока пользователь не 
щелкнет на одной из кнопок. 

Если пользователь щелкнет на кнопке Сапсеі, метод рготрШ вернет пиіі. Если 
пользователь щелкнет на кнопке 0К, метод рготргО вернет значение, указанное 
в этот момент в поле ввода. 
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Аргумент беТаиИ определяет начальное содержимое поля ввода, 
ѵоісі 8сго11(1опд х, Іопд у) 

Синоним метода 8сго11То(). 
ѵоісі 8СГОІ1Ву(1опд х, Іопд у) 

Прокручивает документ, отображаемый в окне, на относительную величину, за¬ 
данную аргументами х и у. 

ѵоісі 8СГо11То(1опд х, Іопд у) 

Прокручивает документ, отображаемый в окне, так, чтобы точка с координатами 
х и у в документе оказалась в левом верхнем углу, если это возможно. 

Іопд зеііпіѳгѵаі^ипсііоп Т , ипзідпесі Іопд іпТегѵаІ , апу агдз...) 

Метод зеіІпіегѵаІО регистрирует функцию и которая должна быть вызвана через 
іпТегѵаІ миллисекунд и затем должна вызываться через каждые іпТегѵаІ миллисе¬ 
кунд. Ключевое слово іійз внури функции Т будет ссылаться на объект АѴішіолѵ, 
а в аргументе агдз она получит все дополнительные аргументы, переданные мето¬ 
ду зеіІпіегѵаІО. 

Метод зеіІпіегѵаІО возвращает число, которое позднее может быть передано мето¬ 
ду Міпс1о\л/.с1еагІпі:егѵа1() для прекращения периодического вызова функции Т. 

По историческим причинам в аргументе Т можно передать не только функцию, но 
и строку с программным кодом на языке ЛѵаЗсгірі. В этом случае каждые іпіегѵаі 
миллисекунд будет выполняться программный код, содержащийся в строке (как 
если бы он был заключен в тег <зсгір1:>). 

Если необходимо просто отложить выполнение программного кода и не требуется 
периодически запускать его, следует использовать метод зеіТітеоиіО. 

Іопд зѳНітеоиІ^ипсІііоп Т , ипзідпесі Іопд ТітеоиТ, апу агдз...) 

Метод зеШтеоиіО напоминает метод зеіІпіегѵаІО, но вызывает указанную функ¬ 
цию только один раз: он регистрирует функцию и которая должна быть вызвана 
через ТітеоиТ миллисекунд и возвращает число, которое позднее можно передать 
методу сІеагТітеоиіО, чтобы отменить вызов ожидающей функции. Когда истечет 
указанный интервал времени, функция Т будет вызвана как метод объекта Міпсіом 
и ей будут переданы аргументы агдз. Если Т - это строка с программным кодом, 
а не функция, она будет выполнена спустя іітеоиі: миллисекунд как сценарий в те¬ 
ге <зсгір1:>. 

апу зЬоиМо<іа10іа1од(зі:гіпд игі, [апу агдитепТз]) 

Создает новый объект Ш пбоѵ/, сохраняет значение агдитепТз в свойстве РіаІодАгдитепіз 
этого объекта, загружает в окно документ с адресом игі и блокирует выполнение 
сценария, пока окно не будет закрыто. После закрытия окна метод возвращает 
значение свойства геіигпѴаІие окна. Обсуждение и порядок использования метода 
можно найти в разделе 14.5 и в примере 14.4. 

Обработчики событий 

Большинство событий, возникающих в НТМЬ-элементах, всплывают вверх по дереву 
документа до объекта Ооситепі: и затем до объекта Міпсісм. По этой причине в объекте 
Міпсіом можно использовать любые свойства обработчиков событий, которые перечис¬ 
лены в справочной статье Еіетепі:. И дополнительно можно использовать свойства об¬ 
работчиков событий, перечисленные ниже. По историческим причинам каждое из 
свойств обработчиков событий, перечисленных ниже, можно также определить (в ви¬ 
де НТМЬ-атрибутов или ЛѵаЗсгірі-свойств) в элементе <ЬосІу>. 
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Обработчик 
событий _ 

опаІЧегргіпІ: 

опЬеІчэгергіпІ: 

опЬеІ'огеііпІоасІ 


опЫііг 

опеггог 

опросив 


Вызывается... 


После вывода содержимого окна на печать 
Перед выводом содержимого окна на печать 

Перед тем как броузер покинет текущую страницу. Если возвращает 
строку или присваивает строку свойству геІигпѴаІие объекта события, эта 
строка будет выведена в диалоге подтверждения. См. ВеІ'огеІІпІоасІЕѵепі:. 

Когда окно теряет фокус ввода 

Когда возникает ошибка в ^ѵаБсгірІ-сценарии. Это необычный обработ¬ 
чик события. См. раздел 14.6. 

Когда окно получает фокус ввода 


оп&азЬсЬапде 

оШоас! 

оптеззаде 

опоШіпе 

опопііпе 


Когда идентификатор фрагмента (см. 1_осаі:іоп. ЬазЬ) документа изменяет¬ 
ся в результате перемещения по истории посещений (см. НазГіСГіапдеЕѵепі:) 

Когда документ и все внешние ресурсы будут загружены полностью 

Когда сценарий в другом окне отправит сообщение вызовом метода розі- 
МеззадеО. См. МезвадеЕѵепІ:. 

Когда броузер потеряет соединение с Интернетом 
Когда броузер восстановит соединение с Интернетом 


опрадеЬісІе 

опрадевРом 


опрорвіаііе 


опгевііе 


Перед началом процедуры сохранения страницы в кэше и замещения ее 
другой страницей 

Когда страница загружается впервые, событие «ра&евЬолѵ» возбуждается 
сразу после события «Іоасі», при этом свойство регзізіесі объекта события 
имеет значение Шве. Однако когда ранее загруженная страница восста¬ 
навливается из кэша броузера, размещенного в памяти, событие «1оа<1» 
не возбуждается (поскольку страница в кэше считается уже загружен¬ 
ной), а событие «ра^евЬолѵ» возбуждается с объектом события, свойство 
регвівііесі которого имеет значение {те. См. РадеТгапзіІііопЕѵепІ:. 

Когда броузер загружает новую страницу или восстанавливает состоя¬ 
ние, сохраненное с помощью метода Нівііогу. ривИ51:а1;е() или Нівііогу. ге- 
р1асе$іаіе(). См. РорЗіаіеЕѵепІ. 

Когда пользователь изменяет размер окна броузера 


0П5СГ0І1 


Когда пользователь прокручивает окно броузера 


опзЮгаде 


Когда изменяется содержимое 1оса1$1:огаде или везвіопбііогаде. См. Зііога- 
деЕѵепі:. 


опііпіоасі 


Броузер покинул страницу. Обратите внимание: если страница зарегист¬ 
рирует обработчик события опііпіоасі, она не будет сохраняться в кэше. 
Чтобы обеспечить быстрый возврат к странице без повторной ее загруз¬ 
ки, следует использовать обработчик опрадеИісІе. 


ѴѴогкег 

фоновый поток выполнения ЕѵепІГагдеі 

Объект Могкег представляет фоновый поток выполнения. Создать новый объект Іл/огкег 
можно с помощью конструктора Могкег(), передав ему ІШЬ-адрес файла с программ¬ 
ным кодом на языке ^ѵаВсгірі. Программный код в этом файле может использовать 
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синхронные прикладные интерфейсы или выполнять продолжительные вычисле¬ 
ния, не оказывая влияния на главный поток выполнения. Фоновые потоки работают 
в отдельном контексте выполнения (см. МогкегбІоЬаІЗсоре), и обмен данными с фоно; 
вым потоком выполнения возможен только через механизм асинхронных событий. 
Отправить данные фоновому потоку можно вызовом метода р 08 ТМе 88 аде(), а полу¬ 
чить - с помощью обработчика события «теззаде». 

Введение в фоновые потоки выполнения приводится в разделе 22.4. 

Конструктор 

пе\л/ Могкѳг(8І:гіпд зсгіртіли.) 

Создает новый объект Іл/огкег и запускает ^ѵаВсгірІ-сценарий, находящийся по 
адресу зсгірти 

Методы 

ѵоісі ро8ІМез8аде(апу теззаде , [Ме88адеРогі:[] рогТз ]) 

Отправляет сообщение теззаде фоновому потоку выполнения, котопый получит его 
в виде объекта МеззадеЕѵепі:, в обработчике опте88аде. Аргумент теззаде может быть 
простым значением, объектом или массивом, но не функцией. Допускается переда¬ 
вать такие объекты клиентского ^ѵаЗсгірі, как АггауВиІ^ег, Рііе, ВІоЬ и ІтадеОаІіа, 
но узлы, такие как Ооситепі: и Еіетепі:, передавать нельзя (подробности приводятся 
во врезке «Структурированные копии» в главе 22). 

Необязательный аргумент рог із позволяет указать один или более прямых кана¬ 
лов связи с объектом Могкег. Например, если имеются два объекта Іл/огкег, можно 
обеспечить прямое взаимодействие между ними, передав их конструкторам кон¬ 
цы соединения МеззадеСГіаппеІ. 

ѵоісі ІегтіпаІеО 

Останавливает фоновый поток выполнения и прерывает работу сценария в нем. 

Обработчики событий 

Поскольку фоновые потоки выполняются в окружении, отличном от окружения, соз¬ 
давшего их, они могут взаимодействовать с родительским потоком только посредст¬ 
вом событий. Обработчики этих событий можно зарегистрировать с помощью свойств, 
перечисленных ниже, или с помощью методов интерфейса ЕѵетТагдеІ:. 

опеггог 

Когда в сценарии, выполняемом в фоновом потоке, возбуждается исключение и это 
исключение не обрабатывается обработчиком опеггог объекта МогкегОІоЬаІЗсоре, ге¬ 
нерируется событие «еггог» в объекте Могкег. Обработчику этого события передает¬ 
ся объект ЕггогЕѵепі:. Событие «еггог» не всплывает. Если данный фоновый поток 
выполнения запущен другим фоновым потоком, отмена события «еггог» предот¬ 
вратит его передачу родительскому фоновому потоку. Если объект Могкег создан 
в главном потоке выполнения, отмена события может предотвратить вывод сооб¬ 
щения в консоли ^ѵаЗсгірі. 

опте88аде 

Когда сценарий, выполняемый в фоновом потоке, вызовет свою глобальную функ¬ 
цию ро8іМе88аде() (см. МогкегОІоЬаІЗсоре), в объекте Могкег будет сгенерировано со¬ 
бытие «теззаде». Обработчику события будет передан объект Ме88адеЕѵепі:, свойст¬ 
во сіаіа которого будет содержать копию значения, переданного сценарием из фоно¬ 
вого потока выполнения методу ро8іМе88аде(). 
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ѴѴогкегСІоЬаІБсоре 

ЕѵепіТагдеі, СІоЬаІ 

Фоновый поток, представляющий объект Іл/огкег, работает в среде выполнения, совер 1 
шенно отличной от родительского потока, породившего его. Объект МогкегСІоЬаІЗсоре 
является глобальным объектом для фонового потока выполнения, поэтому получает¬ 
ся, что данная справочная статья описывает среду выполнения «внутри» объекта 
Іл/огкег. Поскольку объект МогкегСІоЬаІЗсоре играет роль глобального объекта, он насле¬ 
дует свойства и методы глобального объекта базового языка ^ѵаЗсгірі. 

Свойства 

В дополнение к свойствам, перечисленным ниже, объект ЫогкегСІоРаІЗсоре определяет 
все глобальные свойства базового ^ѵаЗсгірІ, такие как Маі и ^(Ж 

геасіопіу МогкегІ_осаі:іоп Іосаііоп 

Это свойство, подобно свойству ѵу/іпсіоѵу/. ІосаТіоп, является объектом І_осаі:іоп: оно по¬ 
зволяет фоновому потоку проверить ІШЬ-адрес, откуда был загружен выполняе¬ 
мый в нем сценарий, и включает в себя свойства, возвращающие отдельные части 
ІШЬ. 

геасіопіу Могкег№ѵідаі:ог паѵідаіог 

Это свойство, подобно свойству ѵу/іпсіоѵѵ/. паѵідатог, является объектом Ыаѵідаіог: оно 
определяет свойства, позволяющие фоновому потоку определить тип броузера, 
в котором он выполняется, и состояние подключения к сети. 

геасіопіу МогкегбІоЬаІЗсоре зеИ 

Это свойство ссылается на сам глобальный объект МогкегбІоЬаІЗсоре. Оно похоже 
на свойство міпсіом объекта Міпсіоѵѵ в главном потоке выполнения. 

Методы 

В дополнение к методам, перечисленным ниже, объект ЫогкегСІоРаІЗсоре определяет 
все глобальные функции базового ^ѵаЗсгірі, такие как і$№М() и еѵа1(). 

ѵоісі с1еагІп*егѵа1(1опд ЬапсІІе) 

В точности соответствует одноименному методу объекта Міпсісм. 
ѵоісі с1еагТітеоЩ(1опд ЬапсІІе) 

В точности соответствует одноименному методу объекта МіпРом. 
ѵоісі с1озе() 

Переводит поток выполнения в особое состояние «завершения». Оказавшись в этом 
состоянии он больше не будет возбуждать события. Сценарий продолжит работу 
до момента возврата в цикл событий фонового потока выполнения, где тут же бу¬ 
дет остановлен. 

ѵоісі ітрогІ$сгірІз(зі:гіпд с/гіз...) 

Для каждого из аргументов игіз этот метод разрешает ІШЬ-адрес относительно 
свойства Іосаііоп, затем загружает содержимое ІШЬ-адреса и выполняет его, как 
программный код на языке ^ѵаЗсгірі. Обратите внимание, что это синхронный 
метод. Он загружает и выполняет файлы по очереди и не возвращает управление, 
пока не выполнит все сценарии. (Однако, если какой-то сценарий возбудит исклю¬ 
чение, это исключение начнет распространение и помешает загрузке и выполне¬ 
нию следующих за ним сценариев.) 
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ѵоісі розТНеззаде(апу теззаде, [МеззадеРогі:[] рогТз ]) 

Отправляет сообщение теззаде (и массив портов, если указан) потоку выполнения, 
породившему данный фоновый поток. Вызов этого метода генерирует событие 
«тезза&е» в объекте Могкег в родительском потоке выполнения, обработчику кото-* 
рого передается объект МеззадеЕѵепі: со свойством сіаіа, содержащим копию аргу¬ 
мента теззаде . Обратите внимание, что в фоновом потоке выполнения метод розТ- 
МеззадеО является глобальной функцией. 

Іопд зеТІпТегѵа1(апу ЬапсІІег , [апу ТітеосіТ], апу агдз...) 

В точности соответствует одноименному методу объекта ѴѴіпсіоѵу/. 

Іопд зегТітеоиІ(апу ЬапсІІег, [апу ТітеосіТ], апу агдз...) 

В точности соответствует одноименному методу объекта Міпсіом. 

Конструкторы 

Объект МогкегСІоЬаІЗсоре содержит все конструкторы базового ^ѵаЗсгірІ, такие как 
АггауО, йаііе() и РедЕхр(). Он также определяет некоторые наиболее важные конструк¬ 
торы клиентского ^ѵаЗсгірІ, позволяющие создавать объекты ХМІНПрРедиезІ:, РіІеРе- 
асІегЗупс и даже сам объект Іл/огкег. 

Обработчики событий 

Обработчики событий для фонового потока выполнения можно зарегистрировать, ус¬ 
тановив следующие глобальные свойства или воспользовавшись методами интерфей¬ 
са ЕѵепТТагдеІ:, реализованными в объекте МогкегбІоЬаІЗсоре. 

опеггог 

Это необычный обработчик события: это свойство больше похоже на свойство 
опеггог объекта Міпсіом, чем на свойство опеггог объекта Могкег. Когда в фоновом пото¬ 
ке выполнения появляется необработанное исключение, будет вызвана эта функ¬ 
ция, если она определена, с тремя строковыми аргументами, определяющими со¬ 
общение об ошибке, ІШЬ-адрес сценария и номер строки в сценарии. Если функ¬ 
ция вернет іаізе, исключение будет считаться обработанным и прекратит дальней¬ 
шее распространение. В противном случае, если это свойство не установлено или 
обработчик не вернул іаізе, исключение продолжит распространение и вызовет со¬ 
бытие «еггог» в объекте \Ѵогкег в родительском потоке выполнение. 

оптеззаде 

Когда родительский поток выполнения вызывает метод розііМеззадеО объекта Мог- 
кег, представляющего данный фоновый поток выполнения, в данном объекте Ѵі ог- 
кегбІоЬаІЗсоре генерируется событие «тезза&е». Обработчику этого события будет 
передан объект МеззадеЕѵепі:, свойство сіаііа которого хранит копию аргумента тез¬ 
заде, переданного родительским потоком выполнения. 

ѴѴогкег1.оса*іоп 

ІЛИ-адрес главного сценария в фоновом потоке выполнения 

Объект МогкегІ_осаіііоп, на который ссылается свойство Іосаіііоп объекта МогкегбІоЬаІ- 
Зсоре, похож на объект Іосаіііоп, на который ссылается свойство Іосаііоп объекта Міп- 
боѵк он представляет ІШЬ-адрес главного сценария в фоновом потоке выполнения 
и определяет свойства, представляющие различные части этого ІШЬ-адреса. 

Объект Могкег отличается от объекта МіпРом тем, что он не может перейти по другому 
адресу или перезагрузить сценарий, поэтому свойства объекта МогкегІ_осаіііоп доступ¬ 
ны только для чтения, и в этом объекте отсутствуют методы интерфейса Іосаіііоп. 
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В отличие от обычного объекта І_осаі:іоп, объект МогкегІ_осаі:іоп не преобразуется в стро¬ 
ку автоматически. В фоновом потоке выполнения нельзя просто обратиться к имени 
Іосаііоп там, где подразумевается Іосаіііоп. Мге'Г. 

Свойства 

Следующие свойства имеют то же назначение, что и одноименные свойства объекта 

І_оса1:іоп. 

геасіопіу зіігіпд ЬазЬ 

Часть ІШЬ-адреса - идентификатор фрагмента, включающий начальный символ 
решетки. 

геасіопіу зтгіпд Ьоз* 

Часть ШІЬ-адреса - имя хоста и порт, 
геасіопіу зТгіпд Ьозгпатѳ 

Часть ХЖЬ-адреса - имя хоста. 

геасіопіу зТгіпд Ьгѳ? 

Полный текст ХЖЬ-адреса, переданный конструктору Ѵ\/огкег( ). Это единственное 
значение, которое фоновый поток выполнения получает непосредственно от роди¬ 
тельского потока: все остальные значения передаются косвенно - посредством со¬ 
бытий «тезза&е». 

геасіопіу зіігіпд раІГмате 

Часть ШІЬ-адреса - путь, 
геасіопіу зіігіпд рог* 

Часть ІШЬ-адреса - порт, 
геасіопіу зігіпд ргоіосоі 

Часть ШІЬ-адреса - протокол, 
геасіопіу зігіпд зѳагсЬ 

Часть ІШЬ-адреса - строка поиска или запроса, включая начальный знак вопроса. 

ѴѴогкег№ѵіда(ог 

информация о броузере для фонового потока выполнения 

Свойство паѵідаіог объекта МогкегбІоЬаІЗсоре ссылается на объект Ѵ\/огкегМаѵідаі:ог, ко¬ 
торый является упрощенной версией объекта Маѵідаіог окна. 

Свойства 

Следующие свойства имеют то же назначение, что и одноименные свойства объекта 

№ѵідаі:ог. 

геасіопіу зігіпд аррИате 

См. описание свойства аррМате объекта №ѵідаі:ог. 
геасіопіу зігіпд аррѴегзіоп 

См. описание свойства аррѴегзіопз объекта №ѵіда1:ог. 
геасіопіу Ьооіеап опІ_іпе 

Имеет значение 1:гие, если броузер подключен к сети, и Шзе - в противном случае. 

геасіопіу зігіпд р1а*?огт 

Строка, идентифицирующая операционную систему и/или аппаратную платфор¬ 
му, на которой выполняется броузер. 
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геасіопіу зТгіпд изегАдепІ: 

Значение, используемое броузером для заголовка изег-адепт в НТТР-запросах. 

♦ 

ХМИННрКеяиез* 

позволяет выполнять НТТР-запросы и получать ответы ЕѵепіТагдеі 

Объект ХМІ_Ні:1:рВедие5І: позволяет из клиентских ^ѵаЗсгірі-сценариев запускать 
НТТР-запросы и получать от веб-сервера ответы (которые не обязательно должны 
быть в формате ХМЬ). Объект ХМІ_Н1:1:рВедие5І: подробно рассматривается в главе 18, 
там же можно найти множество примеров применения этого объекта. 

Создать объект ХМЫ-И:1;рРедиез1: можно с помощью конструктора ХМІ_Н1:1:рРедие5І:( ) (сведе¬ 
ния о том, как создавать объекты ХМ1_Н1:1:рРедиез1: в ІБ6, приводятся во врезке в разде¬ 
ле 18.1) и затем использовать его следующим образом: 

1. Вызывается метод ореп(), с помощью которого определяются ІШЬ-адрес и метод 
передачи запроса (обычно «СЕТ» или «Р08Т»). 

2. В свойство опгеас!узі:аі:есИапде записывается ссылка на функцию, которая будет вы¬ 
зываться в процессе выполнения запроса. 

3. Вызывается метод зе1:Редиез1:Неас1ег(), если необходимо указать дополнительные 
параметры запроса. 

4. Вызовом метода зепр() выполняется отправка запроса веб-серверу. Если был вы¬ 
бран метод отправки Р08Т, этому методу можно дополнительно передать тело за¬ 
проса. В процессе выполнения запроса будет вызываться функция-обработчик со¬ 
бытия опгеайузіаііесііапде. Когда свойство геасІуЗіаііе получит значение 4, выполне¬ 
ние запроса завертится. 

5. После того как свойство геас!у8і:аі:е достигнет значения 4, можно проверить код со¬ 
стояния в свойстве зіаііиз, чтобы убедиться, что запрос завершился успехом. 
В этом случае методом де1:ВезропзеНеас1ег() или де1:ВезропзеНеас1егз() следует извлечь 
значения из заголовка ответа и с помощью свойства гезропзеТехІ: или гезропзеХМІ. 
получить тело ответа. 

Объект ХМЬНИрВедиез! определяет относительно высокоуровневый прикладной интер¬ 
фейс к протоколу НТТР. Он учитывает такие особенности, как обработка переадреса¬ 
ции, управление соокіез и обслуживание меж доменных запросов с заголовками СОК8. 

Возможности объекта ХМІНПрВедиезі:, описанные выше, прекрасно поддерживаются 
всеми современными броузерами. На момент написания этих строк велись работы 
над стандартом «ХМЬНІІрКециезІ Ьеѵеі 2», и производители броузеров уже присту¬ 
пили к его реализации. Свойства, методы и обработчики событий, перечисленные ни¬ 
же, включают особенности, введенные спецификацией «ХМЬШірКециеві Ьеѵеі 2», 
которые могут быть реализованы не во всех броузерах. Эти новые особенности поме¬ 
чены строкой «ХНК2». 

Конструктор 

пеѵу/ ХМ1_Н«рВедиезШ 

Этот конструктор, не имеющий аргументов, возвращает новый объект ХМШТТрРеди- 
езі. 

Константы 

Следующие константы определяют возможные значения свойства геас!у81:а1:е. До появ¬ 
ления спецификации ХНК2 эти константы не были стандартизованы и в большинстве 
программ вместо символических значений использовались целочисленные литералы. 
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ипзідпесі зМогІ: ІІМЗЕИТ = О 

Начальное состояние. Объект ХМІНПрРедиезі: только что создан или сброшен в ис¬ 
ходное состояние вызовом метода аЬогі:(). 

ипзідпесі зіюгі: ОРЕИЕО = 1 

Метод ореп() уже вызван, но обращения к методу зепй() еще не было. Запрос еще не 
отправлен. 

ипзідпесі зЬогі: НЕАОЕВЗ.ВЕСЕІѴЕО = 2 

Вызван метод зепс!() и приняты заголовки ответа, но тело ответа еще не принято. 

ипзідпесі зіюгі: І_0А0І№ = 3 

Начат прием тела ответа, но прием еще не завершился. 

ипзідпесі зіюгі: РОИЕ = 4 

НТТР-ответ принят полностью или прием был остановлен из-за ошибки. 

Свойства 

геайопіу ипзідпесі зМогТ геасІуЗіаіе 

Состояние НТТР-запроса. В момент создания объекта ХМ1_Н1:1:рРедие51: это свойство 
приобретает значение 0, а к моменту получения полного НТТР-ответа это значение 
возрастает до 4. Возможные значения свойства определяют константы, перечис¬ 
ленные выше. 

Значение свойства геасІуЗіаіе может уменьшаться, только если в процессе выпол¬ 
нения запроса был вызван метод аЬогі:( ) или ореп(). 

Теоретически при каждом изменении значения этого свойства должен вызываться 
обработчик события опгеасіузіаііесііапде. Однако на практике событие гарантиро¬ 
ванно возникает, только когда свойство геагіуЗіаіе получает значение 4. (События 
«рго&гевв», введенные спецификацией ХНК2, обеспечивают более надежный спо¬ 
соб слежения за ходом выполнения запроса.) 

геасіопіу апу гезропзе 

В спецификации ХНК2 это свойство хранит ответ сервера. Тип свойства зависит 
от значения свойства гезропзеТуре. Если гезропзеТуре содержит пустую строку или 
строку «іехі», данное свойство содержит тело ответа в виде строки. Если гезропзе¬ 
Туре содержит строку «сіоситепі», значением данного свойства будет объект йоси- 
тепТ, полученный в результате разбора ХМЬ- или НТМЬ-документа в теле ответа. 
Если гезропзеТуре содержит строку «аггауЪиТТег», значением данного свойства бу¬ 
дет объект АггауВиі^ег, представляющий двоичные данные в теле ответа. А если 
гезропзеТуре содержит строку «ЫоЪ», значением данного свойства будет объект ВІоЬ, 
представляющий двоичные данные в теле ответа. 

геасіопіу зігіпд гезропзеТех! 

Если значение свойства геасІуЗіаіе меньше 3, данное свойство будет содержать пус¬ 
тую строку. Если значение свойства геайуЗіаІе равно 3, данное свойство возвраща¬ 
ет часть ответа, которая была принята к текущему моменту. Если значение свойст¬ 
ва геайуЗіаіе равно 4, это свойство содержит полное тело ответа. 

Если в ответе имеется заголовок, определяющий кодировку символов в теле отве¬ 
та, используется эта кодировка, в противном случае предполагается кодировка 
ІЛТ-8. 

зігіпд гезропзеТуре 

В спецификации ХНК2 это свойство определяет тип ответа и тип свойства гезропзе. 
Допустимыми значениями являются «іехі», «сіоситепі», «аггауЪиТТег» и «ЫоЪ». 
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Значением по умолчанию является пустая строка, которая также является сино¬ 
нимом значения «іехі». Если установить это свойство вручную, последующие по¬ 
пытки обратиться к свойствам гезропзеТехТ и гезропзеХМІ. будут возбуждать исклю; 
чения и для получения ответа сервера необходимо будет использовать свойство 
гезропзе, предусмотренное спецификацией ХНК2. 

геасіопіу йоситепі: гезропзеХМІ. 

Ответ на запрос, который интерпретируется как ХМЬ- или НТМЬ-документ и воз¬ 
вращается в виде объекта йоситепі:. Это свойство будет иметь значение пиіі, если 
тело ответа еще не получено или оно не является допустимым ХМЬ или НТМЬ-до- 
ку ментом. 

геасіопіу ипзідпесі зіюгі: зіаіиз 

НТТР-код состояния, полученный от сервера, такой как 200 - в случае успеха, 
404 - в случае ошибки отсутствия документа или 0 - если сервер еще не прислал 
код состояния. 

геасіопіу зігіпд зІаІіизТехІ: 

Это свойство содержит текст, соответствующий НТТР-коду состояния в ответе. То 
есть, когда свойство зіаіиз имеет значение 200, это свойство содержит строку 
«ОК», а когда 404 - строку «N 0 ! ГоипсЬ. Это свойство содержит пустую строку, ес¬ 
ли сервер еще не прислал код состояния. 

ипзідпесі Іопд Іітеоиі 

Свойство, введенное спецификацией ХНК2, определяющее предельное время ожи¬ 
дания ответа в миллисекундах. Если выполнение НТТР-запроса займет больше 
времени, чем указано в данном свойстве, он будет прерван и будет сгенерировано 
событие «іітеоиі». Это свойство можно установить только после вызова метода 
ореп() и перед вызовом метода зепр(). 

геасіопіу ХМІНПрРедиезіІІрІоасІ иріоасі 

Свойство, введенное спецификацией ХНК2, ссылающееся на объект ХМЬНПрВери- 
езіііріоасі, который определяет набор свойств регистрации обработчиков событий 
для слежения за процессом выгрузки тела НТТР-запроса. 

Ьооіеап мШіСгейепгіаІз 

Свойство, введенное спецификацией ХНК2, определяющее необходимость аутен¬ 
тификации при выполнении междоменного СОН8-запроса и необходимость обра¬ 
ботки заголовков соокіе в СОК8-ответах. По умолчанию имеет значение іаізе. 

Методы 

ѵоісі аЬоП() 

Возвращает объект ХМІНіірВериезІ: в исходное состояние, соответствующее значе¬ 
нию 0 в свойстве геайу8*а*е, и отменяет любые запланированные сетевые взаимо¬ 
действия. Этот метод может потребоваться, например, если запрос выполняется 
слишком долго и надобность в получении ответа уже отпала. 

зігіпд деІАНВезропзеНеаРегзО 

Возвращает все НТТР-заголовки ответа (с отфильтрованными заголовками соокіе 
и С0В8), полученные от сервера, или пиіі, если заголовки еще не были получены. 
Заголовки соокіе и С0В8 отфильтровываются и не могут быть получены. Заголовки 
возвращаются в виде единственной строки и отделяются друг от друга комбинаци¬ 
ей символов \г\п. 
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зігіпд деІВезропзеНеасіеіЧзігіпд беабег) 

Возвращает значение указанного заголовка Ьеабег в НТТР-ответе или пиіі, если 
заголовки вообще не были получены или если ответ не содержит требуемого заго; 
ловка Ьеабег. Заголовки соокіе и СОВЗ отфильтровываются, и их нет смысла запра¬ 
шивать. Если было принято несколько заголовков с указанным именем, значения 
этих заголовков объединяются в одну строку через запятую и пробел. 

ѵоісі ореп(з1:гіпд теТІюб , зШпд игі, [Ьооіеап азупс, зіігіпд изег , зігіпд разз]) 

Этот метод инициализирует объект ХМІНПрВедиезі: и сохраняет свои аргументы для 
последующего использования методом зепсі(). 

Аргумент теТІюб определяет НТТР-метод, используемый для отправки запроса. 
Среди наиболее устоявшихся методов можно назвать СЕТ, Р08Т и НЕАБ. Реали¬ 
зации могут также поддерживать методы С(ЖКЕСТ, БЕЬЕТЕ, ОРТІСЖ8, РИТ, 
ТКАСЕ и ТКАСК. 

Аргумент игі определяет ІІКЬ-адрес, который является предметом запроса. Разре¬ 
шение относительных ІШЬ-адресов производится обычным образом с использова¬ 
нием ІШЬ-адреса документа со сценарием. Политика общего происхождения (см. 
раздел 13.6.2) требует, чтобы данный ІШЬ-адрес содержал те же имя хоста и номер 
порта, что и документ со сценарием, выполняющим запрос. Объект ХНК2 позволя¬ 
ет выполнять междоменные запросы к серверам, поддерживающим заголовки С0В8. 

Если аргумент азупс указан и имеет значение іаізе, запрос будет выполняться 
в синхронном режиме, и последующий вызов зепс!() заблокирует работу сценария, 
пока ответ не будет получен полностью. Синхронные запросы рекомендуется ис¬ 
пользовать только в фоновых потоках выполнения. 

Необязательные аргументы изег и разз определяют имя пользователя и пароль для 
НТТР-запроса. 

ѵоісі оѵеггі(1еНітеТуре(з1:гіпд тіте ) 

Этот метод позволяет указать, что ответ сервера должен интерпретироваться в со¬ 
ответствии с указанным МІМЕ-типом тіте (и параметром сИагзеІ:, если он указан 
в определении типа тіте), без учета значения заголовка Сопіепі-Туре в ответе. 

ѵоісі зепсКапу Ьобу) 

Инициирует выполнение НТТР-запроса. Если перед этим не вызывался метод 
ореп() или, обобщенно, если значение свойства геайуЗіаіе не равно 1, метод зепй() 
возбуждает исключение. В противном случае он начинает выполнение НТТР-за¬ 
проса, который состоит из: 

• НТТР-метода, ІШЬ-адреса и информации об авторизации (если необходимо), 
определенных предшествующим вызовом метода ореп(); 

• заголовков запроса, если они были определены предшествующим вызовом ме¬ 
тода зеіРедиезіНеасІегО; 

• значения аргумента Ьобу , переданного данному методу. Аргумент Ьобу может 
быть строкой, объектом йоситепі:, образующим тело запроса; он может быть 
опущен или иметь значение пиіі, если запрос не имеет тела (например, ОЕТ-за- 
просы вообще не имеют тела). Согласно спецификации ХНК2 телом запроса 
также могут быть объекты АггауВиІ'іег, ВІоЬ и РогтОаіа. 

Если в предшествующем вызове метода ореп() аргумент азупс имел значение І'аізе, 
данный метод блокируется и не возвращает управление, пока значение свойства 
геасІуВіаіе не станет равно 4 и ответ сервера не будет получен полностью. В против¬ 
ном случае метод зепсі() немедленно возвращает управление, а ответ сервера обра¬ 
батывается асинхронно, с помощью обработчиков событий. 
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ѵоісі 5е1Ведиез1Неа<іег($1:гіпд пате , зТгіпд ѵаіие) 

Определяет НТТР-заголовок с именем пате и значением ѵаіие , который должен 
быть включен в запрос, передаваемый последующим вызовом метода зепс!(). Это? 
метод может вызываться, только когда свойство геас1у51:аі:е имеет значение 1, т.е. 
после вызова метода ореп(), но перед вызовом метода зепсі( ). 

Если заголовок с именем пате уже был определен, новым значением заголовка ста¬ 
нет прежнее значение заголовка плюс запятая с пробелом и новое значение ѵаіие , 
переданное методу. 

Если методу ореп() была передана информация об авторизации, объект ХМІ_Н«р- 
ВедиезТ автоматически добавит заголовок АиТІюгііаТіоп. Однако этот заголовок мо¬ 
жет быть также добавлен методом зеІВедиезіНеайегО. 

Объект ХМЫПрВедиез!: автоматически устанавливает заголовки «Сопіепі-Ьеп^іЬ», 
«Баіе», «Кеіегег» и «ІІзег-А^епі» и не позволяет изменять их значения. Существу¬ 
ет еще несколько заголовков, включая заголовки, имеющие отношение к соокіез, 
которые нельзя установить с помощью этого метода. Полный их список приводит¬ 
ся в разделе 18.1. 

Обработчики событий 

Оригинальный объект ХМЫНТіірРедиезІ: определяет только одно свойство регистрации 
обработчика событий: опгеасіузіаіесііапде. Спецификация ХНК2 дополняет этот спи¬ 
сок множеством обработчиков событий хода выполнения запроса, которые намного 
проще в использовании. Зарегистрировать обработчики можно с помощью свойств, 
перечисленных ниже, или с помощью методов интерфейса ЕѵегцТагдеІ. События, воз¬ 
никающие в объекте ХМЫНТІірРедиезІ:, всегда доставляются самому объекту ХМШТТр- 
Ведиезі:. Они не всплывают и не предусматривают действий по умолчанию, которые 
можно было бы отменить. Обработчикам событий «геасІу8Іа1есЬап&е» передается объ¬ 
ект Еѵепі:, а обработчикам остальных событий - объект РгодгеззЕѵепІ:. 

См. также описание свойства иріоасі и ХМЫН1;1;рРедиезі:ир1оас!, где приводится список со¬ 
бытий, которые можно использовать для слежения за ходом выгрузки тела НТТР-за- 
проса. 

опаЬогі: 

Вызывается при прерывании запроса. 

опеггог 

Вызывается в случае завершения запроса по ошибке. Обратите внимание, что 
НТТР-коды состояния, такие как 404, не считаются ошибкой, поскольку сам от¬ 
вет получен успешно. Однако это событие может породить отрицательный ответ 
сервера 0№ или бесконечный цикл переадресаций. 

опіоас! 

Вызывается при успешном выполнении запроса. 

опіоасіепсі 

Вызывается в случае успешного или неудачного завершения запроса, после собы¬ 
тий «Іоасі», «аЪогі», «еггог» и «іітеоиі». 

опіоайзііагі: 

Вызывается с началом выполнения запроса. 

опргодгезз 

Вызывается периодически (примерно раз в 50 миллисекунд) в ходе загрузки тела 
ответа. 



ХМ ШіірКедиезіІ) ріоасі 


1039 


опгеасіузііаііесііапде 

Вызывается при изменении значения свойства геасіуЗііаііе. Наиболее важен для об¬ 
работки ситуации завершения запроса. 

опіітеоиі: 

Вызывается, если истекло время ожидания, определяемое свойством Ііітеоиі:, а от¬ 
вет так и не был принят. 

ХМІННрКеяиезШрІоасІ 

ЕѵепІГагдеі 

Объект ХМІ_Н1:1:рРедие5І:ир1оа(1 определяет множество свойств регистрации обработчиков 
событий для слежения за ходом выгрузки тела НТТР-запроса. В броузерах, реализую¬ 
щих положения спецификации «ХМЬНирКециевІ Ьеѵеі 2», каждый объект ХМІ_нир- 
Редиезі: имеет свойство иріоай, ссылающееся на объект этого типа. Чтобы реализовать 
слежение за ходом выполнения операции выгрузки, достаточно просто установить со¬ 
ответствующие обработчики событий с помощью следующих свойств или методов ин¬ 
терфейса ЕѵетТагдеІ:. Обратите внимание, что перечисленные ниже свойства регистра¬ 
ции обработчиков событий для слежения за процессом выгрузки в точности соответ¬ 
ствуют свойствам регистрации обработчиков событий для слежения за процессом за¬ 
грузки, которые определяются самим объектом ХМ1_Н1:1:рРедие51:, за исключением 
свойства опгеасіузііаііесііапде. 

Обработчики событий 

опаЬогі: 

Вызывается при прерывании выгрузки. 

опеггог 

Вызывается, когда в процессе выгрузки возникает сетевая ошибка. 

опіоасі 

Вызывается в случае успешного завершения выгрузки 

опіоасіепд 

Вызывается в случае успешного или неудачного завершения выгрузки. Событие 
«Іоасіепсі» всегда следует за событиями «Іоасі», «аЪогІ», «еггог» и «Іітеоиѣ». 

опіоасізііагі: 

Вызывается с началом выгрузки. 

опргодгезз 

Вызывается периодически (примерно раз в 50 миллисекунд) в ходе выгрузки. 

опіітеоиі: 

Вызывается, если истекло время ожидания, определяемое свойством Ііітеоиі: объ¬ 
екта ХМЫНіііірВедиезІ;. 
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Символы 

$ (знак доллара) 

$$(), метод объекта СопаоІеСошшашіЬіпе, 908 
$(), метод объекта СопаоІеСошшагкіЬіпе, 907 
$0» функция, 32, 558, 559 

использование вместо ^ие^у8е1ес1о^А11(), 564 
поиск элементов по идентификаторам, 381 
$0 и $1, свойства объекта СопаоІеСошшаші- 
Ьіпе, 907 

обозначение конца строки в регулярных выра¬ 
жениях, 277, 284 
& (амперсанд) 

&& (логическое И), оператор, 62, 85, 98 
&-= (поразрядное И и присваивание), оператор, 
85,101 

поразрядное И, оператор, 85, 92 
| (вертикальная черта) 

| (логическое ИЛИ), оператор, 85, 99 
-= (поразрядное ИЛИ и присваивание), опера¬ 
тор, 85,101 

поразрядное ИЛИ, оператор, 85, 92 
разделитель альтернатив в регулярных выра¬ 
жениях, 281, 283 
1 (восклицательный знак) 

логическое НЕ, оператор, 69, 85,100 
!«— (не идентично), оператор, 85, 93 

проверка свойств на неравенство значению 
ипсіейпесі, 148 

I 9 (не равно), оператор, 85, 93 
- (дефис) 

диапазон в классах символов регулярных вы¬ 
ражений, 279 
, (запятая) оператор, 108 
* (звездочка) 

квантификатор в регулярных выражениях, 
280 

символ шаблона в расширении Е4Х, 312 
*= (умножение и присваивание), оператор, 85, 
101 

умножение, оператор, 53, 85 
? (знак вопроса) 

квантификатор в регулярных выражениях, 280 
?= отрицательное условие на последующие 
символы в регулярных выражениях, 284 
?! положительное условие на последующие 
символы в регулярных выражениях, 284 
?: (условный) оператор, 85,105 
~ (знак вставки) 

в регулярных выражениях, 284 
отрицание в классах символов в регулярных 
выражениях, 278 


(поразрядное ИСКЛЮЧАЮЩЕЕ ИЛИ 
и присваивание), оператор, 85,101 
поразрядное ИСКЛЮЧАЮЩЕЕ ИЛИ, опера¬ 
тор, 85, 92 
- (знак минус) 

(вычитание и присваивание), оператор, 101 
-- (декремент), оператор, 84, 91 
побочные эффекты, 87,110 
вычитание, оператор, 53, 85 
унарный минус, оператор, 84, 90, 91 
+ (знак плюс) 

++ (инкремент), оператор, 84, 90, 91 
побочные эффекты, 87,110 
квантификатор в регулярных выражениях, 280 
оператор конкатенации строк, 85 
оператор сложения, 53, 85 
типы данных операндов, 86 
оператор сложения и конкатенации строк, 89 
+— (сложение и присваивание), оператор, 85, 
101 

добавление текста в свойство іппегНТМЬ, 
409 

унарный плюс, оператор, 84, 90 
% (знак процента) 

%= (деление по модулю и присваивание), опе¬ 
ратор, 85,101 

оператор деления по модулю, 53, 85 
9 (знак равно) 

— (идентично), оператор, 85, 93 
оператор присваивания, 85 
левостороннее выражение, 86 
побочные эффекты, 87 
== (равно), оператор, 85,93 
и значение N814, 54 
// и /* */ в комментариях, 43 
" (кавычки, двойные), строковые литералы, 56 
в регулярных выражениях, 282 
в таблицах стилей или в атрибуте аіуіе, 463 
’ (кавычки, одинарные), строковые литералы, 56 
в регулярных выражениях, 282 
[] (квадратные скобки) 

в выражениях доступа к свойствам, 82,191 
генераторы массивов, 307 
доступ к отдельным символам в строке, 184 
инициализаторы массивов, 81 
классы символов в регулярных выражениях, 
278 

получение и изменение значений свойств, 142, 
143 

создание массивов, 165 

чтение и запись элементов массивов, 166 
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чтение и запись элементов многомерных мас¬ 
сивов, 171 

@ (коммерческое «аі») 

@ІІ, @е1ае и @еп(і, ключевые слова в условных 
комментариях, 360 
в именах атрибутов, 312 
() (круглые скобки) 

в выражениях вызова функций и методов, 83 
в выражениях-генераторах, 308 
в выражениях создания объектов, 84 
в определениях функций, 82,186 
группировка в регулярных выражениях, 281, 
283 

окружающие выражения в условных инструк¬ 
циях іі, 115 
\\ (обратный слэш) 

\\п (ссылки в регулярных выражениях, 283 
создание многострочных текстовых литера¬ 
лов, 57 

управляющие последовательности в регуляр¬ 
ных выражениях, 277 
управляющие последовательности в строко¬ 
вых литералах, 58 
_ (символ подчеркивания) 
в именах функций, 186 
/ (слэш) 

/— (деление и присваивание), оператор, 85,101 
/* */» комментарии в ІЖЬ-адресах вида ^ѵа- 
Зсгірі:, 342 

литералы регулярных выражений, 276 
оператор деления, 53, 85 
~ (тильда), оператор поразрядное НЕ, 84, 92 
. (точка) 

.. (вложенный элемент), оператор, 312 
в выражениях обращения к свойствам, 82 
в регулярных выражениях классы символов, 
279 

оператор точка 

доступ к свойствам при вызове методов, 190 
получение и изменение значений свойств, 
142 

; (точка с запятой) 

завершение инструкций, 109 
необязательное, 46 
и блоки инструкций, 111 
разделение пар имя/значение в свойствах сти¬ 
ля, 445 

<> (угловые скобки) 

>— (больше или равно), оператор, 85, 95 
> (больше чем), оператор, 85, 95 
<= (меньше или равно), оператор, 85, 95 
< (меньше чем), оператор, 85,95 
«= (сдвиг влево и присваивание), оператор, 
85,101 

«(сдвиг влево), оператор, 85, 92 
»>= (сдвиг вправо с заполнением нулями 
и присваивание), оператор, 85,101 
»> (сдвиг вправо с заполнением нулями), опе¬ 
ратор, 85, 93 

»= (сдвиг вправо с сохранением знака и при¬ 
сваивание), оператор, 85, 86 
» (сдвиг вправо с сохранением знака), опера¬ 
тор, 85, 93 
{} (фигурные скобки) 
блок инструкций, 110 
в определениях функций, 186 
инициализаторы объектов, 81 


количество повторений в регулярных выраже¬ 
ниях, 280 

отсутствие в краткой форме записи функций, 
309 

А 

<а>, элемент 

Ьге?, атрибут, 342, 396 

наличие атрибута пате вместо атрибута Ьгеі, 
396 

аЬогі(), метод 

РПеКеайег, объект, 947 
ХМЬННрІ^иеаѣ, объект, 541, 544,1036 
аЪоиі:Ыапк, ІЖЬ-адрес, 383 
аЪа(), функция, объект МаіЬ, 823 
ассері, свойство объекта Іприі, 964 
ассеріСЬагаеі, свойство объекта Рогш, 950 
ассигасу, свойство объекта Сеосоопііпаіеа, 955 
асоа(), функция, объект МаіЬ, 823 
асііоп, свойство объекта Рогш, 431, 950 
асііѵеЕІетепі, свойство объекта Боситепі, 915 
ай<1(), метод 

ІЮМТокепІлаі, объект, 470, 924 
НТМЬОрііопаСоІІесііоп, объект, 960 
І(}иегу, объект, 619 
Зеіесі, элемент, 1009 
аййСІаааО, метод объекта іС^иегу, 567 
а<1<1Со1ог8іор(), метод объекта СапѵааСгайіепѣ, 
690, 890 

ай<1Е1етеп1(), метод объекта БаіаТгапаГег, 509,912 
аййЕѵепіІлаіепегО, метод, 348, 489 
ЕѵепіТаг&еі, объект, 944 
'ѴѴогкегСІоЬаІЗсоре, объект, 724 
ДѴогкег, объект, 722 

несовместимость с методом аііасЬЕѵепі(), 356 
отсутствует в Іпіегпеі Ехріогег, 353 
перехватывающие обработчики событий, 496 
регистрация обработчиков событий, 491 
а<1орДОо<1е(), метод объекта Боситепі, 917 
аГіег(), метод объекта іС^иегу, 572 
А^ах,архитектура 

в версии іС^иегу 1.5,603 
и ХМЬ, 527 
определение, 524 
транспорты, 525 

утилиты в библиотеке і($иегу, 595, 597 
аіах(), функция, 601 
&еѣ() и роа!(), функции, 600 
ВеіІ8(Ж(), функция, 598 
веі8сгірі(), функция, 598 
1оа<і(), метод, 595 
коды состояния, 596 
передача данных, 599 
события Аіах, 608 
типы данных, 601 

функции поддержки в библиотеке іС^иегу, 980 
аіах(), функция, 601 

редко используемые параметры и обработчи¬ 
ки, 607 

функции обратного вызова, 605 
часто используемые параметры, 603 
а1ег1(), метод 

ЛѴіпйоѵѵ, объект, 334, 377,1025 
бесконечный цикл, 367 
аііііікіе, свойство объекта Сеосоопііпаіеа, 955 
аІѣіішІеАссигасу, свойство объекта 
Сеосоогсііпаіеа, 955 
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аІІКеу, свойство, 500, 519 
Еѵепі, объект, 937 
событий мыши, 483 
апдЗеЩ), метод объекта іС^иегу, 622 
апітаіеО» метод 

объект, определяющий изменяемые атрибуты, 
590 

объект с параметрами анимационного эффек¬ 
та, 591 

объекта іС^иегу, 586, 587 
реализация собственных анимационных эф¬ 
фектов, 589 
аррепд(), метод 

ВІоЬВиіШег, объект, 736, 887 
РогтВаіа, объект, 954 
ІС^иегу, объект, 572 

аррепдСЫШО, метод объекта Коде, 413, 999 
арреп(Шаіа(), метод 
Соттепі, узел, 905 
Техі, объект, 1015 

арреп<іТо(), метод объекта іС^иегу, 572 
<арр1еі>, элемент, 571 
АррІісаііопСасЬе, объект, 883 
аіаіиа, свойство, 649 
8\ѵарСасЬе(), метод, 649, 883 
ирдаіе(), метод, 649, 884 
константы, значения для свойства вШиз, 883 
методы, 883 

обработчики событий, 884 
свойства, 883 

аррІісаііопСасЬе, свойство объекта ЛѴіпдоѵѵ, 646, 
1023 

аррІуО» метод объекта Гипсііоп, 811 
арр1у() и са11(), методы объекта Гипсііоп, 193, 210 
ограничение на использование в безопасных 
подмножествах, 293 
аррКате, свойство 

Каѵіртіог, объект, 375, 996 
ЛѴогкегК аѵі&аіог , объект, 1033 
аррѴегвіоп, свойство 

Каѵі&аіог, объект, 375, 996 
ЛѴогкегКаѵі&аіог, объект, 1033 
агс(), метод объекта СапѵааКепдегіп&Сопіехі2В, 
685, 686, 896 
агсТо(), метод объекта 
СапѵааКепдегіпвСопіехі2В, 685, 897 
Аг&итеп1а, объект, 194, 761 
саііее н саііег, свойства, 196 
саііее, свойство, 761, 762 
1еп&іЬ, свойство, 209, 761, 762 
ограничение на использование в безопасных 
подмножествах, 293 

аг&итеп1а, свойство объекта Гипсііоп, 811 
аг&итепѣа[], массив, 761 
АггауВиГСег, объект, 730, 885 

геадАаАггауВиНег(), метод объекта 
РіІеКеадег, 740, 741 
порядок следования байтов, 731 
свойства, 885 

АггауВи^егѴіеѵѵ, объект, 885 
Аггау, объект 

ІаАггауО, метод, 181 
ІаАггауО» функция, 181 
80 гі(), метод, 247 
Аггау(), конструктор, 165 
ааіп(), функция, объект МаіЬ, 823 
аааегіО, метод объекта Сопаоіе, 905 


аааі^пО, метод объекта Ьосаііоп, 372,987 
ааупс, свойство объекта Зсгірі, 1007 
аіап(), функция, объект МаіЬ, 824 
аіап2(), функция, объект МаіЬ, 824 
аіоЬ(), метод объекта ЛѴіікіоѵѵ, 1025 
аМасЬЕѵепі(), метод, 349, 489,945 

значение ссылки іЬіа в обработчиках событий, 
494 

несовместимость с методом аддЕ ѵепіЬі аЪепег(), 
356 

регистрация обработчиков событий в ІЕ, 492 
АПг, объект, 408, 885 
аНг(), метод объекта іС^иегу, 565, 576 
аМгіЬиіеа, свойство объекта Еіетепі, 408,925 
<аи<ііо>, элемент, 658 
сопігоіа, атрибут, 658 
события, 486 
Ашііо, объект, 886 
ашііо, свойство объекта Ѵідео, 1019 
Ашііо(), конструктор, 659 
АиіЬогігаііоп, заголовки, 530 
аиіосошріеіе, свойство 
Гогш, объект, 950 
Іприі, объект, 964 

аиіоіосиа, свойство объекта ГогшСопігоІ, 952 
аиіоріау, свойство объекта МедіаЕІетепі, 661,988 
аѵаіІНеі&М, свойство объекта Зсгееп, 377,1006 
аѵаіІЛѴідіЬ, свойство объекта Зсгееп, 377,1006 

В 

\\Ъ (граница слова) в регулярных выражениях, 
284 

\\Ъ (забой) в регулярных выражениях, 279 
\\В (не слово) метасимвол, 284 
Ьаск(), метод объекта Ніаіогу, 373, 958 
Ьаск&гоипд-соіог, свойство, 453, 458 
Ьаск&гоипд, СЗЗ-свойства стиля, 459 
ЬааеІІКІ, свойство объекта Коде, 998 
Ье?оге(), метод объекта і($иегу, 572 
Ве^огеІІпІоадЕѵепі, объект, 886 
Ье&іпРаіЬ(), метод объекта 
СапѵааКепдегіпвСопѣехі2В, 674,897 
ЬеЬаѵіог, свойство, 641 
ЬегіегСигѵеТо(), метод объекта 
СапѵааКепдегіп&СопІех12В, 685, 897 
Ьіпд(), метод, 211 

Рипсѣіоп, объект, 231, 812 
и динамические события, 584 
метод Гипсііоп.Ьіпд() для ЕСМАЗсгірѣ 3, 212 
регистрация обработчиков событий в библио¬ 
теке і(}иегу, 579 
_Ыапк, имя окна, 383 
ВІоЬ, объект, 732, 886 
ВІоЬВиіШег, объект, 736, 887 
Ыиг, событие, 433, 480 

всплывающая альтернатива, 485 
Ыиг(), метод 

Еіетепі, объект, 929 
ЛѴіпдоѵѵ, объект, 1026 

<Ьоду>, элемент, установка обработчиков собы¬ 
тий, 490 

Ьоду, свойство объекта НТМЬБоситепІ, 396 
Вооіеап, объект, 779 
ІоЗігіпвО, метод, 780 
ѵаІиеОЗД, метод, 780 
Воо1еап(), конструктор, 64 
Воо1еап(), функция, преобразование типов, 69 
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Ьоггіег, свойство, 447 

Ъоііош, іор, гі&Ьі и Іеіі, свойства стиля, 423, 456, 
457 

Ъох- 8 І 2 Іп 2 , свойство, 457 
Ьгеак, инструкция, 125 
Ъгеак, ключевое слово, 118 
Ьгоѵѵзег, свойство, 610 
Ыоа(), метод объекта ЛѴіп(іо\ѵ, 1026 
ЬиЬЫеа, свойство объекта Еѵепі, 937 
ЪиНег, свойство объекта АггауВиііегѴіеѵг, 885 
ЪиНегей, свойство объекта МедіаЕІетепі, 661,988 
ЪиНегейАтоипі, свойство объекта ЛѴеЬ8оскеі, 
1021 

<Ъиііоп>, элемент, 428 

Ьиііоп, свойство объекта Еѵепі, 501, 502,937 
Ьиііопа, свойство объекта Еѵепі, 942 
ЬуіеЬеп&іЬ, свойство объекта АггауВиГГегѴіеѵг, 
885 

ЪуіеСЖаеі, свойство объекта АггауВиТТегѴіелѵ, 885 

С 

<сапѵаа>, элемент, 672 

САСНБ, раздел в файле объявления кэшируемого 
приложения, 645 

са11() и арр1у(), методы объекта Гипсііоп, 193, 210 
ограничение на использование в безопасных 
подмножествах, 293 
са11(), метод объекта Гипсііоп, 159, 812 
саііее, свойство объекта Аг^итепіа, 761, 762 
саііее и саііег, свойства 
Аг^итепіа, объект, 196 
ограничение на использование в безопасных 
подмножествах, 293 
саііег, свойство объекта Гипсііоп, 813 
сапсеІаЫе, свойство объекта Еѵепі, 937 
сапсеІВиЬЫе, свойство объекта Еѵепі, 938 
сапсеІВиЬЫеО, метод объекта Еѵепі, 584 
сапР1ауТуре(), метод объекта МебіаЕІетепі, 991 
СапѵааСгабіепі, объект, 687, 690, 890 
а<1<1Со1ог8іор, метод, 890 
создание, 898 

СапѵааРаііегп, объект, 687, 890 
создание, 898 

СапѵааКеш1егіпвСопіехі2В, объект, 673, 890 
агс(), метод, 896 
агсТо(), метод, 897 
Ъе&іпРаі1і(), метод, 897 
ЪегіегСигѵеТо(), метод, 897 
с1еагКесі(), метод, 897 
с1ір(), метод, 691, 693, 897 
с1оаеРаіЬ(), метод, 898 
сгеаіеІта^еБаіа(), метод, 898 
сгеаіеІлпеагСга<1іепі(), метод, 690,898 
сгеаіеРаііегп(), метод, 689, 898 
сгеаіеКа<1іа1Сга<1іепі(), метод, 690,898 
<1гаигІта&е(), метод, 696, 899 
Ш1(), метод, 899 
Ш1Кесі(), метод, 899 
Ш1Техі(), метод, 692, 899 
&еіІта&еБаіа(), метод, 900 
іаРоіпіІпРаіЬО, метод, 900 
1іпеТо(), метод, 901 
теааигеТехі(), метод, 693, 901 
тоѵеТо(), метод, 901 
риіІта&еБаіа(), метод, 901 
^иа<і^аіісСи^ѵеТо(), метод, 902 
гесі(), метод, 902 


геаіоге(), метод, 691, 902 
гоіаіе(), метод, 902 
ааѵе() и геаіоге(), методы, 894 
ааѵе(>» метод, 691, 902 
аса1е(), метод, 902 
аеіТгапаіогтО, метод, 903 
аігоке(), метод, 691,903 
аігокеКесіО, метод, 903 
аігокеТехі(), метод, 692, 903 
ігапаІогтО, метод, 903 
графические атрибуты, 678 
графические атрибуты эффекта тени, 695 
композиция, 698 
рисование и заливка кривых, 685 
рисование прямоугольников, 687 
Сапѵаа, объект 

&еіСопіехі(), метод, 889 
іоБаіаІІКЦ), метод, 889 
манипулирование пикселами, 894 
массив байтов в свойстве СапѵааРіхеІАггау, 730 
справка, 888 

Сапѵаа, прикладной интерфейс, 673 
Сапѵаа, объект, 673 

деіСопіехіО, метод, 673 
іоБаіаІІНЬ(), метод, 698 
атрибуты рисования линий, 691 
изображения, 696 
композиция, 698 
контур, 673 
отсечение, 693 

преобразование системы координат, 680 
пример рисования красного квадрата 
и голубого круга, 673 
прямоугольники, 687 
размеры и система координат холста, 679 
рисование и заливка кривых, 685 
рисование линий и заливка многоугольников, 
675 

рисование текста, 692 

цвет, прозрачность, градиенты и шаблоны, 687 
эффект тени, 695 

сарііоп, свойство объекта ТаЫе, 1011 
саае, ключевое слово, 117 
саае, конструкции в инструкции аѵѵіісЬ 
завершение ключевым словом Ьгеак, 118 
саісЬ, конструкция (инструкция ігу/саісЬ/ 
Гіпаііу), 129 

множественные блоки саісЬ, 309 
с<1(), метод объекта СопаоІеСотташІІлпе, 907 
СБАТА8есііоп, узлы, 411 
сеі1(), функция, объект МаіЬ, 824 
сеіііпсіех, свойство объекта ТаЫеСеІІ, 1013 
сеііа, свойство объекта ТаЫеНоѵѵ, 1013 
СЕКТ Асіѵіаогу, о межсайтовом скриптинге, 367 
сЬап&е(), метод объекта іС^иегу, 575 
сЬап&есІТоисЬеа, свойство события прикоснове¬ 
ния, 489 

сЬаг, свойство объекта Еѵепі, 486, 942 
СЬагасіегБаіа, объект, 412 
сЬагасіегВеі, свойство объекта Боситепі, 915 
сЬагАі(), метод объекта 8ігіп^, 864 
сЬагСойе, свойство объекта Еѵепі, 938 
сЬагСо<1еАі(), метод объекта 8ігіп&, 535, 864 
сЬагаеі, свойство 

Боситепі, объект, 915 
8сгірі, объект, 1007 
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сЬескед, свойство 
ІприЪ, объект, 964 
элементов форм, 431 
сЬескѴа1ідіЪу(), метод объекта Гогш, 951 
сЫІд, свойства объекта Еіетепі, 402 
сЬіІдЕІетепіСоипі, свойство объекта Еіетепі, 
402,926 

сЫкДОодеа, свойство объекта Кобе, 401, 998 
сЫІдгеп, свойство объекта Еіетепі, 402, 405,926 
сЬіЫгеп(), метод объекта і(}иегу, 620 
СЬготе, веб-броузер, 504 
ѣехііприі, событие, 486 
реализация прикладного интерфейса 
к файловой системе, 742 
текущая версия, 355 
сіааа, атрибут, 31,159,160 

НТМЬ-элементов, 381, 397, 406 
проверка на принадлежность объекта классу 
Гипсііоп, 214 

сіаааілаі, свойство, 470, 567 
Еіешепѣ, объект, 926 

реализация функциональности (пример), 471 
с1ааа№те, свойство, 334, 397, 470 
Еіешепѣ, объект, 334, 926 
с1еаг(), метод объекта ЗДогадо, 1009 
с1еагІ)аіа(), метод объекта БаіаТгапаІег, 912 
с1еагІпіегѵа1(), метод, 370 
ЛѴіпдоѵѵ, объект, 1026 
ЛѴогкегОІоЬаІВсоре, объект, 1031 
с1еагІпіегѵа1(), функция, 323 
с1еаг()иеие(), метод объекта іС^иегу, 595 
с1еагКесі(), метод объекта 
СапѵааКепдегіпвСопѣехгёБ, 687, 897 
с1еагТітеоиі(), метод 
\Ѵіпдо\ѵ, объект, 1026 
'ѴУогкегСІоЪаІЗсоре, объект, 1031 
с1еагТішеоиі(), функция, 323 
с1еаіЛѴаісЬ(), метод объекта СеоІосаЪіоп, 708, 955 
сііск, событие, 500 
деіаіі, свойство, 483 
регистрация обработчика, 31 
регистрация обработчиков событий в элемен¬ 
тах ЬиМоп, 491 
с1іск(), метод 

Еіешепі, объект, 929 
І(}иегу, объект, 575 

сііепі, свойства элементов документа, 426 
сІіепѣНеі&М и сІіепіЛѴідіЬ, свойства объекта 
Еіетепі, 423, 926 

сІіепіЬеП и сІіепіТор, свойства объекта Еіешепѣ, 
926 

СІіепіКесі, объект, 904 

сІіепіХ и сІіепіУ, свойства объекта Еѵепі, 500, 
501, 938 

сіір, свойство, 459 

с1ір(), метод объекта СапѵааКепдегіпвСопіех12Б, 
691, 693, 897 

с1опе(), метод объекта і(}иегу, 573 
сІопеЙодеО, метод объекта Коде, 413, 999 
с1оае(), метод 

Боситепі, объект, 918 
ЕѵепіЗоигсе, объект, 943 
Меааа^еРогі, объект, 994 
ЛѴеЪЗоскеІ, объект, 756,1021 
\Ѵіпдо\ѵ, объект, 1026 
ЛѴогкегСІоЪаІЗсоре, объект, 722,1031 
генераторов, 305 


объектов ЛѴіпдоѵѵ и Боситепі, 385 
сіоаед, свойство объекта ЛѴіпдоѵѵ, 385 
СІоаеЕѵепЪ, объект, 904 
сІоаеРаіЬО, метод объекта 
Сапѵа8Кепдегіп&Сопіехі2Б, 675,898 
сІоаеаѣО, метод объекта іС^иегу, 621 
Сіоаиге, фреймворк, 368 
соде, свойство 

БОМЕхсерііоп , объект, 923 
РіІеЕггог, объект, 946 
СеоІосаѣіопЕггог, объект, 957 
МедіаЕггог, объект, 992 
соІогБеріЬ, свойство объекта Зсгееп, 1006 
соІЗрап, свойство объекта ТаЫеСеІІ, 1013 
Сотеі, архитектура, 525 

на основе стандарта Зегѵег-Зепі Еѵепіа, 550 
транспортные механизмы, 526 
сотрагеБоситепіРоаіііопО, метод объекта Коде, 
1000 

сошрагеТоО, метод, реализация в классах, 246 
сошраШоде, свойство объекта БоситепЪ, 358, 915 
сотріеіе, свойство объекта Іта&е, 963 
сотріеіе, свойство объекта с параметрами анима¬ 
ционного эффекта, 591 
сопсаі(), метод 

Аггау, объект, 173, 765 
Зѣгіпе, объект, 865 
сопГі^игаЫе, атрибут, 138 
удаление свойств, 147 
сопГігшО, метод объекта ЛѴіпдоѵѵ, 377 
Сопаоіе, объект, 905 
методы, 905 

СопаоІеСошшапдЬіпе, объект, 907 
сопаоІе.Іо&О, функция, 727 
сопаі, ключевое слово, 295 
сопаігисіог, свойство, 158 

имя конструктора как идентификатор класса, 
234 

ограничение на использование в безопасных 
подмножествах, 293 

сопѣаіпа(), метод объекта БОМТокепІлаі, 470,924 
сопіаіпаО, функция, 610 
сопЪепЪ-Ьох, модель, 457 

сопіепІБоситепі, свойство объекта ІРгаше, 961 
сопіепіедііаЫе, свойство объекта Еіетепі, 441 
сопіепіаО, метод объекта і($иегу, 620 
Сопіепі-Туре, заголовок 
НТТР-запросы, 530 

автоматическая установка в запросе объектом 
ХМЬНирНециеаі, 540 
переопределение некорректного МІМЕ-типа 
в ответе, 535 

сопЪепіТуре, параметр, 600 
сопіепіЛѴіпдоѵѵ, свойство объекта ІРгаше, 386,961 
сопіехі, свойство, 969 
ІС^иегу, объект, 562 
сопіехЪтепи, событие, 500, 501 
сопііпие, инструкция, 126 
без метки, 127 

сопігоі, свойство объекта ЬаЬеІ, 984 
сопігоіа, атрибут элементов <аидіо> и <ѵідео>, 658 
сопѣгоіа, свойство объекта МедіаЕІетепі, 988 
соокіе, свойство объекта Боситепі, 437, 915 
соокіеа, 634, 635 

атрибуты, определяющие срок хранения 
и область видимости, 635 
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как определить, когда поддерживаются, 635 
ограничения на размер и количество, 639 
реализация хранилища, 639 
сохранение, 637 
чтение, 638 

соокіеаБпаЫебО, метод объекта Каѵі&аЪог, 376 
соогсів, свойство объекта Сеороаіііоп, 957 
СОК8 (Сгоаа-Огі^іп Кеаоигсе ЗЬагіп^), заголовки, 
545 

соа(), функция, объект МаіЬ, 825 
соипі(), метод объекта Сопаоіе, 906 
сгеаіеО» функция, 141, 841 

добавление свойств во вновь созданный объект, 
156 

сгеаіеСарііопО, метод объекта ТаЫе, 1012 
сгеаіеСоттепі(), метод объекта Боситепі, 918 
сгеаіеБоситепіО, метод объекта 
ВОМІтрІетепІаііоп, 923 
сгеаІеБоситепіГга^тепіО, метод объекта 
Оосишепѣ, 416, 918 
сгеаІеБоситепіТуреО, метод объекта 
ВОМІтрІетепЪаЪіоп, 923 
сгеа1еЕ1етеп1(), метод объекта Боситепі, 413,918 
сгеаіеЕ1етепШ8(), метод объекта Боситепі, 413, 
669, 918 

сгеаіеЕѵепіО, метод объекта Боситепі, 918 
сгеаіеНТМЫ)оситепІ(), метод объекта 
ООМІтрІетепіаііоп, 923 
сгеаіеІта^еВаіа(), метод объекта 
СапѵааКеп(іегіп^Сопіехі2В, 898 
сгеаіеІп<1ех(), метод хранилища объектов, 750 
сгеаіеІлпеагСга<1іепІ(), метод объекта 
СапѵааНеп(іегіп^Сопіехі2В, 690, 898 
сгеаіеОЪіесіВіогеО, метод объекта ІпбехесШВ, 750 
сгеаіеОЪіесШКЬО, метод объекта ІШЬ, 1019 
сгеаіеОЬіесШКЬО» функция, 737 
сгеаіеРаМег п(), метод объекта 
СапѵааНепсіегіп^Сопіехі2В, 689,898 
сгеаІеРгосеааіп^ІпаІгисііопО, метод объекта 
Боситепі, 918 

сгеаіеКайіаЮгасііепІО, метод объекта 
СапѵааКеп<1егіпвСопіехі2І), 690,898 
сгеаіеКап&е(), метод, 440 

сгеаіе8іу1е8Ьееі(), метод объекта Боситепі, 475 
сгеаіеТВойуО, метод объекта ТаЫе, 1012 
сгеаіеТехДОойеО, метод объекта Боситепі, 413, 
918 

сгеаіеТГооіО, метод объекта ТаЫе, 1012 
сгеаіеТНеабО, метод объекта ТаЫе, 1012 
саа(), метод объекта і($иегу, 566 
С882Ргорегііеа, объект, 908 
С88 Апітаѣіопа, модуль, 450 
С88 (Саасабіп^ Віуіе ВЬееіа - каскадные таблицы 
стилей), 444 

блочная модель и детали позиционирования, 
455 

выбор элементов документа по классу С88, 397 
использование в ЛаѵаВсгірі для оформления 
документов НТМЬ, 31 
наиболее важные свойства стиля, 450 
обзор, 445 

определение стилей в веб-странице (пример), 
448 

определение стилей для объектов Еіетепі, 334 
отображение и видимость элементов, 457 
перекрытие полупрозрачных окон (пример), 460 


позиционирование элементов, 451 
получение вычисленных стилей, 468 
селекторы, 398 

ультрасовременные свойства, 450 
управление С88-классами, 470 
управление встроенными стилями, 463 
анимационные эффекты, 465 
управление таблицами стилей, 472 
цвет, прозрачность и полупрозрачность, 458 
частичная видимость, свойства оѵегПоѵѵ и сіір, 
459 

чтение и запись значений СВВ-атрибутов мето¬ 
дами объекта іС^иегу, 566 
чтение и запись значений С88-классов метода¬ 
ми объекта іС^иегу, 566 
С880М-Ѵіе\ѵ Моёиіе, стандарт, 421 
С88Ки1е, объект, 473, 908 

сааКиІеа, свойство объекта С 888іу1е8Ьееі , 473,910 
СВбВЪуІеБесІагаЪіоп, объект, 909 
вычисленные стили, 468 
использование для управления встроенными 
стилями, 463 

описание стилей, связанных с селектором, 473 
свойства, соответствующие сокращенным фор¬ 
мам записи, 464 
С888іу1е8Ьееі, объект, 472, 910 
(ііааЫеб, свойство, 473 
получение, вставка и удаление правил 
из таблиц стилей, 473 
создание, 475 
сааТехі, свойство 

С88Ки1е, объект, 909 
С888іу1еБес1агаііоп , объект, 465, 474, 910 
С88 Тгапаіогша, модуль, 450 
С88 ТгапаШопа, модуль, 467, 468 
сігІКеу, свойство, 500, 519 
Еѵепі, объект, 938 
событий мыши, 483 

сиггепіВгс, свойство объекта МесІіаЕІетепі, 988 
сиггепЪВіуІе, свойство (ІЕ), 469 
сиггепіВіуІе, свойство объекта Еіетепі, 926 
сиггепЪТаг&еі, свойство объекта Еѵепі, 578,938 
сиггепЪТіте, свойство объекта МейіаЕІетепѣ, 

660, 988 

сиаіотЕггог, свойство объекта ГогтѴаІШііу, 954 

Р 

\\6 (цифры, А8СІІ), 279 

\\Б (не цифры, А8СІІ) любой символ, не являю¬ 
щийся цифровым, 279 
баіа://, ІЖЬ-адрес, 949 
<1аѣа, свойство 

СЬагасіегБаіа, объект, 412 
Соттепі, объект, 905 
ЕѵепЪ, объект, 515, 518, 579, 942 
Іта&еБаіа, объект, 730, 963 
МеааазеЕѵепі, объект, 717,993 
Ргосеааіп&Іпаігисііоп, объект, 1004 
<1аѣа(), метод объекта іС^иегу, 570, 624 
сіаіааеі, свойство объекта Еіетепі, 407, 926 
БаІаТгапаГег, объект, 509, 511, 911 
Шеа, свойство, 539, 735 

(іаіаТгапаГег, свойство объекта Еѵепѣ, 509, 511,938 
БаЪаѴіеѵѵ, объект, 913 

методы чтения/записи значений из 
АггауВиГГег, 731 
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Баіе(), конструктор, 781 
сіаіеріскег(), метод, 626 
(іЫсІіск, событие, 500, 501 
(іЫсІіскО, метод объекта іС^иегу, 575 
(іеЬи^О, метод объекта Сопаоіе, 906 
йеЪидоег, инструкция, 132 
<іесосіеІШІ(), функция, 801 
<іесосіеІШІСотропепі(), функция, 372, 637, 802 
сіеГаиІіСЬагаеі, свойство объекта Боситепі, 916 
сіеГаиІіСЬескесі, свойство 
СЬескЬох, объект, 434 
Іприі, объект, 964 

сіеГаиІіРІауЬаскКаіе, свойство объекта 
МейіаЕІетепі, 660, 989 

сіеГаиІіРгеѵепіесі, свойство объекта Еѵепі, 497,938 
<іеГаи1і8е1есіесі, свойство объекта Орііоп, 1002 
(ІеГаиІЪѴаІие, свойство 
Іприі, объект, 964 
Оиіриі, объект, 1003 
ТехіАгеа, объект, 1016 
(іеГаиІіѴіеиг, свойство объекта Боситепі, 916 
сіеГег, свойство объекта Всгірі, 1007 

_сіеГіпеСеііег_() и_сіеГіпеВеііег_(), методы, 

158, 405 

сіеГіпеРгорегііеаО, функция, 842 

определение и изменение нескольких свойств 
сразу, 156 

сіеГіпеРгорегіуО, функция, 124,155,158, 842 
обеспечение доступа только для чтения 
к свойству Іеп&іЬ массивов, 168 
определение настраиваемых свойств, доступ¬ 
ных только для чтения, 146 
определение неперечислимых свойств, 262 
(іе1ау(), метод объекта іС^иегу, 593 
(іе1е^аіе(), метод объекта іС^иегу, 585 
сіеіеіе, оператор, 85, 107 
побочные эффекты, 87,110 
удаление атрибутов в расширении Е4Х, 313 
удаление свойств, 147 
удаление свойств глобального объекта, 148 
удаление элементов массивов, 169 
сіе1еіеСарііоп(), метод объекта ТаЫе, 1012 
<іе1еіеСе11(), метод объекта ТаЫеКолѵ, 1013 
<іе1еіеБаіа(), метод 
Соттепі, узел, 905 
Техі, объект, 1015 
(1е1еіеКо\ѵ(), метод 

ТаЫеВесііоп, объект, 1014 
ТаЫе, объект, 1012 

сіе1еіеКи1е(), метод объекта С888іу1е8Ьееі, 474, 911 
сіе1еіеТГооі(), метод объекта ТаЫе, 1012 
<іе1еіеТНеасі(), метод объекта ТаЫе, 1012 
сіеІіаМосіе, свойство объекта Еѵепі, 942 
сіеІіаХ, (ІеІіаУ и (1е1іа2, свойства объекта Еѵепі, 
505, 506, 942 

<^иеие(), метод объекта і($иегу, 594 
сіеаівпМосіе, свойство объекта Ьоситепі, 441, 916 
сіеіасЬ(), метод объекта іС^иегу, 574 
сіеіасЬЕѵепі(), метод, 492, 945 
сіеіаіі, свойство объекта Еѵепі, 505, 506, 938 
БНТМЬ фупатіс НТМЬ - динамический НТМЬ), 
336 

<На1овАг&итепі8, свойство объекта ЛѴіпсіолѵ, 378, 
1023 

<1іе(), метод объекта іС^иегу, 586 
(ііг, свойство объекта Ьоситепі, 916 


(1іг(), метод 

СопаоІеСотташіЬіпе, объект, 907 
Сопаоіе, объект, 906 
БігесіогуЕпігу, объект, 743 
БігесіогуКеасіег, объект, 743 
(1ігхт1(), метод 

СопаоІеСоттапсіЫпе, объект, 907 
Сопаоіе, объект, 906 
сііааЫесі, свойство 

С888іу1е8Ьееі, объект, 910 
РіеМ8еі, объект, 945 
ГогтСопігоІ, объект, 952 
Ыпк, объект, 985 
Орііоп, объект, 1002 
8 іу1е, объект, 1011 

сііараісЬЕѵепіО, метод объекта ЕѵепіТаг&еі, 944 
(ИараісЬГогтСЬап^еО, метод объекта Рогт, 951 
сііараісЬГогтІприіО» метод объекта Рогт, 951 
сііаріау, свойство, 457 
БОСТУРЕ, объявление 

режим совместимости и стандартный режим, 
358 

сіо сіу ре, свойство объекта Боситепі, 916 
Боситепі, объект, 334, 390, 914 
асісіЕѵепіЫаіепегО, метод, 492 
с1оае(), метод, 385 
сотраіМосіе, свойство, 358 
соокіе, свойство, 634 

анализ содержимого, 638 
сгеаіеБоситепіРга&тепіО» метод, 416 
сгеаіеЕ1етепШ8(), метод, 413 
сгеаіеЕ1етепі(), метод, 413 
сгеаіе8іу1е8Ьееі(), метод, 475 
сгеаіеТехШосіе(), метод, 413 
сіеаі&пМосіе, свойство, 441 
(іотаіп, свойство, 364 
е1етепіРготРоіпі(), метод, 424 
ехесСоттапсі(), метод, 442 
Гог та, свойство, 430 
&еіЕ1етепіВуІсі(), метод, 381, 393, 430 
&е1Е1етепіВуТа&Кате(), метод, 395 
ЗеіЕІетепіаВуСІаааКатеО» метод, 398 
^еіЕ1етепіаВуТа^Кате(), метод, 430 
ітрогШосіе(), метод, 413 
Іосаііоп, свойство, 371 
ореп(), метод, 374 

^ие^уСотташіЕпаЫе<і(), метод, 442 
^ие^уСотташіIп<іеіе^тО* метод, 443 
^ие^уСоттап<і8іаіе(), метод, 442 
^ие^уСоттап(іVа1ие(), метод, 442 
^ие^у8е1есіог(), метод, 399 
^ие^у8е1есіо^А11(), метод, 399, 473 
геасіу8іаіе, свойство, 351, 498 
гетоѵеЕѵепіЬіаіепег(), метод, 492 
аіуІеВЬееіа, свойство, 473 
ІЖЬ, свойство, 371 
иггііеО, метод, 345, 351, 374, 438 
\ѵгііе1п(), метод, 439 
как НТТР-ответ, 534 
методы, 917 
свойства, 437, 915 
события, 921 

сіоситепі, свойство объекта \Ѵіпсіолѵ, 334,1023 
сіоситепі.аЩ], коллекция, 400 
сіоситепіЕІетепі, свойство объекта Боситепі, 
396, 422, 916 
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БоситепЪГга&тепЪ, объект, 393, 416,921 
циегу8е1есІог(), метод, 399 
циегу8е1есІогА11(), метод, 399 
реализация метода іпаегіАфасепШТМЦ) 
с использованием свойства іппегНТМЬ, 417 
реализация перестановки дочерних узлов 
в обратном порядке, 417 
создание, 918 

БосишепіТу ре, объект, 922 
Боіо, фреймворк, 368 

БОМ (Боситепі ОЬіесі Мойеі - объектная модель 
документа) 

БОМ Ьеѵеі 3 Еѵепіз, спецификация, 485 
предлагаемые к реализации методы, 942 
предлагаемые к реализации свойства, 941 
іехѣіприі, событие, 516 
обзор, 390 

реализация типов как классов, 404 
(Іошаіп, свойство объекта Боситепі, 364, 437, 916 
ЕЮМСопіепЪЬоасІесІ, событие, 351, 498, 499 
ЕЮМЕхсерЪіоп, объект, 922 
ЕЮМІтрІетепіаііоп, объект, 923 
ІЮММоиаеЕсгоІІ, событие, 504 
ЕЮМбеМаЫеТокепЬіаі, объект, 923 
ЕЮМТокепЬіаі, объект, 470, 924 
а<1<1(), метод, 470 
сопіаіпа(), метод, 470 
гешоѵе(), метод, 470 
ІодоІеО, метод, 470 
йо/игЬіІе, циклы, 120 

сопііпие, инструкция, 127 
йгадоаЫе, атрибут, 509 
бгалѵІша^еО, метод объекта 
СапѵааКет1егіпвСоп1ех12Б, 696, 899 
(ІгорЕНесі, свойство объекта БаіаТгапаГег, 509, 
912 

(ігоргопе, атрибут, 511 

(іигаііоп, свойство объекта МедіаЕІетепі, 660,989 
Е 

Е, константа (объект МаіЬ), 825 
Е4Х (ЕСМА8сгірі іог ХМЬ), расширение 
введение, 310 

еасЬ(), метод объекта іС^иегу, 563 
еасЬ(), функция, 610 

ЕСМАВсгірі, стандарт расширения ^ѵаВсгірі, 
290 

ЕСМАВсгірі 5, стандарт 

зарезервированные слова, 44 
классы 

дескрипторы свойств, 268 
определение неизменяемых классов, 263 
определение неперечислимых свойств, 262 
подклассы, 267 

предотвращение расширения классов, 266 
сокрытие данных объекта, 265 
методы массивов, 176, 563 
еНесіАПоигесІ, свойство объекта БаѣаТгапаГег, 
509, 511, 912 
Еіетепі, класс, 393 
ЕІетепЪ, объект, 334, 925 
аМгіЬиіеа, свойство, 408 
сопіепЪесІіЪаЫе, свойство, 441 
сіаіааеі, свойство, 407 
^еіАіігіЬиІеО, метод, 406 
&еіАМгіЬиЪе() и аеІАІІгіЪиІе(), методы, 465 


&еШоип<1іпвС1іепШесІ(), метод, 426 
2 еіС1іепШесіа(), метод, 424 
ЬазАіІгіЬиіеО, метод, 407 
іппегНТМЬ, свойство, 409 
іпаегіАфасепШТМЦ), метод, 410 
Иоде, объекты, 401 
оНаеіЬеК и оНаеіТор, 426 
оНаеіРагепі, свойство, 426 
оНаеіЛѴШіЬ и оНаеіНеі&М, 426 
оиіегНТМЬ, свойство, 409 
гешоѵеАигіЬиѣеО, метод, 407 
аеіАНгіЪиіеО, метод, 406 
методы, 929 

обработчики событий, 931 
определение собственных методов, 404 
свойства, 925 

е1етепЪГготРоіпЪ(), метод объекта БосшпепЪ, 

424, 918 

еіетепіа, свойство 
Гіе1с18еЪ, объект, 945 
Рогш, объект, 950 
элементов форм, 430 

еіае, конструкция во вложенных инструкциях і{, 
115 

еіае іГ, инструкция, 116 
<етЬе<і>, элемент, 571 
етЬейа, свойство 

Боситепі, объект, 916 
НТМЬБоситепі, объект, 396 
етріу(), метод объекта і(}иегу, 574 
епаЫеШ&ЬАссигасу, параметр объекта 
Сеоіосаѣіоп, 956 
епсойеШЗД), функция, 802 
епсо<1еІЖІСотропепѣ(), функция, 637,803 
епсойіпв, свойство объекта Рогш, 431 
епсіуре, свойство объекта Рогш, 950 
еп<1(), метод 

іфиегу, объект, 621 
ТішеНап^еа, объект, 1017 
еп<1е<1, свойство объекта МейіаЕІетепІ, 989 
епитегаЫе, атрибут (свойств), 154,155 

ргорегіуІаЕпшпегаЫеО, функция проверки, 148 
ец(), метод объекта іС^иегу, 618 
ециа1а(), метод, реализация в классах, 244 
еггог, свойство 

ГіІеКеасІег, объект, 947 
МесІіаЕІетепЪ, объект, 662,663, 989 
еггог, событие 

ГіІеКеасІег, объект, 740 
Еггог(), конструктор, 804 
еггог(), метод 

Сопаоіе, объект, 906 
ІС^иегу, объект, 575 
ЕггогЕѵепі, объект, 935 
еасаре(), функция, 806 
еѵа1(), функция, 102, 807 

отсутствует в безопасных подмножествах, 292 
ЕѵаІЕггог, объект, 808 
Еѵепі, объект, 577,936 

сІеГаиІІРгеѵепіесІ, свойство, 497 
рге ѵепШеГаи Н(), метод, 497 
геіигпѴаІие, свойство, 497 
аЪорІттесІіаІеРгора&аЪіопО, метод, 498 
8 ІорРгора&аЪіоп(), метод, 497 
в библиотеке і($иегу, 577 
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константы, определяющие значения свойства 
еѵепЪРЬаае, 937 
методы, 941 

предлагаемые к реализации методы, 942 
предлагаемые к реализации свойства, 941 
свойства, 937 

еѵепѣ, свойство объекта ЛѴіпбоѵѵ, 493,1023 
еѵепіРЬаае, свойство объекта ЕѵепЪ, 939 

константы, определяющие возможные значе¬ 
ния, 937 

ЕѵепЪбоигсе, объект, 550, 943 
имитация с помощью объекта 
XМ^НМрКе^ие8^, 552 
использование в простом клиенте чата, 551 
константы, определяющие допустимые значе¬ 
ния свойства геабуВіаіе, 943 
ЕѵепіТаг^еі, объект, 944 
еѵегу(), метод объекта Аггау, 178, 765 
ехсапѵаа.іа, библиотека, 356 
ехес(), метод объекта Ке&Ехр, 288, 858 
ехесСоішпапб(), метод объекта Боситепі, 442,918 
ехр(), функция, объект МаіЬ, 825 
ехрігеа, свойство, сохранение данных с помощью 
механизма иаегОаіа, 641 
ЕхрІогегСапѵаа, проект, 672 
ехѣепб(), функция, 150, 611 
ехіепаіЫе, атрибут, 160,161 

Р 

1абеТо(), методы объекта іС^иегу, 588 
РАІХВАСК, раздел в файле объявления кэшируе¬ 
мого приложения, 645 
іаізе и ігие, значения, 67 
Ріе1б8еѣ, объект, 945 
Гііе, объект, 734, 945 
Рііе АРІ, спецификация, 487 
РіІеЕпІгу, объект, 743 
РіІеЕггог, объект, 946 
РіІеЬіаі, объект, 735 

Шепате, свойство объекта ЕггогЕѵепі, 936 
ГіІеКеабег, объект, 734, 946 
возбуждение событий, 487 
константы, определяющие возможные значе¬ 
ния свойства геабуВіаіе, 947 
методы, 947 

обработчики событий, 948 
свойства, 947 

слежение за ходом выполнения асинхронных 
операций ввода/вывода, 487 
чтение двоичных объектов, 739 
Рі1еКеабег8упс, объект, 741, 949 
Шеа, свойство 

БаІаТгапаіег, объект, 512, 735, 912 
Іприі, объект, 964 

Рііеііріоаб объект, ограничение возможностей из 
соображений безопасности, 362 
ГіІеЛѴгііег, объект, 734, 743 

Ш1(), метод объекта Сапѵа8Кепбегіп&СопІех12Б, 
674, 899 

Ш1Кес1(), метод объекта 
СапѵааКепбегіп&СопѣехгёБ, 687, 899 
ШІВіуІе, свойство объекта 
СапѵааКепбегіпвСопѣехі2В, 678, 894 
Ш1Тех1(), метод объекта 
СапѵааНеп<іегіп^Соп1ех12В, 692, 899 
Шіег, свойство (ІЕ), 459 


Шіег(), метод 

Аггау, объект, 177, 766 
ІС^иегу, объект, 618 

Гіпаііу, конструкция'(инструкция Ъгу/саісЬ/ 
ГіпаіІу), 129 

1 іпб(), метод объекта і(}иегу, 620 
ГігеІох, веб-броузер, 375 
сЬагСобе, свойство, 515 
БОММоиаебсгоИ, событие, 504 
версии и расширения баѵаВсгірі, 290, 297 
глобальный подход к композиции, 700 
изменения в прикладном интерфейсе объекта 
Ніаіогу в Гігеіох 4, 713 
текущая версия, 355 

:Гігаі-1іпе и :іігаІ-1еМег, псевдоэлементы (С88), 400 
Гіг8І(), метод объекта іС^иегу, 618 
{ігаѣСЬіІб, свойство объекта Кобе, 401,998 
ГігаЪЕІетепіСЬіІб, свойство объекта Еіетепі, 402, 
927 

Р1оаі32Аггау, класс, 728,1017 
Г1оаі64Аггау, класс, 728,1017 
Поог(), функция, объект МаіЬ, 826 
Гп, объект-прототип (і(}иегу), 622 
Госиа, событие, 433,480 

Госиаіп и іосиаоиі, всплывающие версии, 485 
фокус ввода в элементах документа, 485 
ІосиаО, метод 

Еіетепі, объект, 929 
ЛѴіпсІоѵѵ, объект, 1026 
Гопі, свойство, 447, 892,894 
текста в холсте, 692 
{опіРатіІу, свойство, 469 
ГогЕасЬО, метод объекта Аггау, 171,176, 767 
Гог/еасЬ, циклы, 300 

в генераторах массивов, 307 
в расширении Е4Х, 312 
іог/іп, циклы, 121,122 

сопѣіпие, инструкция, 127 
в генераторах массивов, 307 
вызов метода і()иегу.еас1і(), 563 
использование ключевого слова Іеі для иници¬ 
ализации переменной цикла, 295 
использование с ассоциативными массивами, 
144 

итерации по полям, методам и свойствам баѵа- 
классов и объектов, 317 
обход элементов массива, 170,171 
объявление переменных с помощью ключевого 
слова Іеі, 295 
перечисление свойств, 149 
порядок перечисления свойств, 123 
расширение для работы с итерируемыми объ¬ 
ектами, 302 
Рогт, объект, 949 

сЬескеб, свойство, 431 
еіетепіа, свойство, 430 
аиЪтііО и геаеѣ(), методы, 432 
ѵаіие, свойство, 431 
методы, 951 

обработчики событий, 951 
свойства, 950 
Гогт, свойство, 432, 433 
ГогтСопІгоІ, объект, 952 
ЬаЬеІ, объект, 984 
Меіег, объект, 995 
Орііоп, объект, 1002 
Рго^геаа, объект, 1005 
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ГогтАсііоп, свойство 
ВиМоп, объект, 888 
ІприЪ, объект, 965 
ГогтСопігоІ, объект, 951 
обработчики событий, 953 
свойства, 952 

ГогтВаіа, объект, 540, 953 
ГогтЕпсіуре, свойство 
Вииоп, объект, 888 
Іприі, объект, 965 
ГогтМеіЬосІ, свойство 
Вииоп, объект, 888 
Іприі, объект, 965 
ГогтКоѴаІісІаѣе, свойство 
Вииоп, объект, 888 
Іприі, объект, 965 

Гог те, свойство объекта Боситепі, 430,916 
Гогта, свойство объекта НТМЬБоситепі, 396 
ГогтТаг^еі, свойство 
Вииоп, объект, 888 
Іприі, объект, 965 
ГогтѴаІісШу, объект, 954 
Гогѵѵагс1(), метод объекта Ніаіогу, 373, 958 
ГгатеЕІетепі, свойство объекта ЛѴіпсіоѵѵ, 386,1023 
Ггатеа, свойство объекта ЛѴіпсіоѵѵ, 386,1023 
<ГгатеаеЪ> и <Ггате>, элементы (устаревшие), 
382 

Ггееге(), функция, 161, 843 
ГготСЬагСос1е(), метод объекта 8 ігіп&, 865 
ГготЕІетепі, свойство объекта Еѵепі, 939 
Га, модуль для работы с файлами и файловой сис¬ 
темой, Коде, 325 
Гипсііоп, инструкция, 113 
Рипсѣіоп, класс, 50 
1 о 8 ігіп&(), метод, 71 
ГипсЪіоп, ключевое слово, 82,185 
создание переменной, 387 
Гипсііоп, объект, 809 
аррІуО» метод, 811 
аг&итепіа, свойство, 811 
Ьіпсі(), метод, 211, 231, 812 
саііег, свойство, 813 
са11(), метод, 159, 812 
1еп&Мі, свойство, 814 
ргоЪоЪуре, свойство, 814 
ѣо 8 ігіпв(), метод, 213, 814 
методы, 810 

определение собственных свойств, 200 
свойства, 810 

РипсѣіопО, конструктор, 213 

отсутствует в безопасных подмножествах, 292 

О 

В, флаг (регулярные выражения), 285, 286, 289 
Сеосоопііпаіеа, объект, 955 
Оеоіосаііоп, объект, 707, 955 

демонстрация всех возможностей, 710 
использование для отображения карты, 708 
веоіосаііоп, свойство объекта Каѵідаіог, 376, 708, 
996 

СеоІосаііопЕггог, объект, 956 
Сеороаіііоп, объект, 957 
СЕТ, метод, 529 

выполнение НТТР-запросов с данными 
в формате НТМЬ-форм, 537 
запрос без тела, 530 


веі(), функция, 600 

веГАПКеаропаеНеайегаО, метод объекта 
XМ^НирКе^ие 8 і, 1036 

ВеіАигіЪиіеО, метод объекта Еіетепі, 406,929 * 
веѣАигіЪиіеК 8 (), метод объекта Еіетепі, 929 
^еШоипсИп^СНепШесіО, метод объекта Еіетепѣ, 
423,426,929 

веіСІіепіКесіаО, метод объекта Еіетепі, 424,929 
веѣСотриіес18ѣу1е(), метод объекта ЛѴіпсіоѵѵ, 468, 
1026 

веѣСопіехі(), метод объекта Сапѵаа, 673, 889 
веѣСиггепѣРоаіііопО, метод объекта Сеоіосаѣіоп, 
708, 955 

&еДОаіа(), метод объекта БаіаТгапаГег, 511,912 
&еШаѣе(), метод объекта БаЪе, 785 
&еШау(), метод объекта Баіе, 785 
^еіЕІетепІВуИО, метод объекта Боситепі, 381, 
393,430,919 

&еіЕ1етепіВуКате(), метод объекта 
НТМЬБоситепі, 394 
веіЕ1етепШуТавКате(), метод объекта 
Боситепі, 395 

ЗеШетепіаВуСІаваКатеО, метод 
Боситепі, объект, 398, 919 
Еіетепі, объект, 929 

&еіЕ1етепіаВуКате(), метод объекта БоситепЪ, 
919 

&еіЕ ІетепіаВу Та &Ка те(), метод 
Боситепі, объект, 430,919 
Еіетепѣ, объект, 929 
веіЕ 1 етепіаВуТавКатеК 8 (), метод 
БоситепЪ, объект, 919 
ЕІетепЪ, объект, 930 
выбор форм и элементов форм, 430 
веіР1оаі32(), метод объекта ВаіаѴіеѵѵ, 913 
&еіПоаі64(), метод объекта ВаЪаѴіеѵѵ, 913 
^еіГи11Уеаг(), метод объекта Ваіе, 785 
&еШоига(), метод объекта Ваіе, 786 
&еіІтавеЬаіа(), метод объекта 
СапѵааНеп(іегіп^Сопіехі2В, 900 
&еІІпі 8 (), метод объекта ВаіаѴіеѵѵ, 914 
&еЪІпі16(), метод объекта ВаіаѴіеѵѵ, 913 
&еіІпі32(), метод объекта ВаіаѴіеѵѵ, 914 
&еіІіет(), метод объекта Віога^е, 1009 
&е^80К(), функция, 598 
&еіМШіаесопсІ 8 (), метод объекта Ваіе, 786 
&еіМіпиіеа(), метод объекта Ваіе, 786 
&еіМос1іГіег8іаіе(), метод объекта Еѵепі, 943 
&еіМопіЬ(), метод объекта Ваіе, 786 
ЕеіОѵѵпРгорегіуВеасгіріогО, функция, 158, 844 
2 еіОѵѵпРгорегіуКатез(), функция, 151, 845 
ЯеіРгоіоіуреОГО» функция, 158, 845 
веШеаропаеНеас1ег(), метод объекта 
ХМЬНіірІ^иеаі, 1037 
&еі 8 сгірі(), функция, 598 
&еі 8 есопсІ 8 (), метод объекта Ваіе, 786 
&еі8е1есііоп(), метод объекта ЛѴіпсіоѵѵ, 440 
2 еіТіте(), метод объекта Ваіе, 787 
веіТітегопеОГГаеіО, метод объекта Ваіе, 787 
2 еШіпі 8 (), метод объекта ВаіаѴіеѵѵ, 914 
веШіпі16(), метод объекта ВаіаѴіеѵѵ, 914 
&еШіпі32(), метод объекта ВаіаѴіеѵѵ, 914 
&еШТСВаіе(), метод объекта Ваіе, 787 
&еШТСБау(), метод объекта Ваіе, 788 
^еШТСГиіІУеагО, метод объекта Ваіе, 788 
ВеШТСНоигз(), метод объекта Ваіе, 788 
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веШТСМіІІіаесошІаО, метод объекта БаЪе, 788 
^еШТСМіпиІезО, метод объекта БаЪе, 788 
&еШТСМопіЬ(), метод объекта Баіе, 789 
&еШТС8есопсІ8(), метод объекта Баіе, 789 
&еіУеаг(), метод объекта Баіе, 789 
&1оЬа1, свойство объекта Ке^Ехр, 287, 858,859 
&1оЬа1А1рЬа, свойство, 688, 894 
&1оЬа1Сотро8ІЪеОрегаЪіоп, свойство, 698, 893, 895 
&1оЪа1Еѵа1(), функция, 611 
СМТ (СгееплѵісЬ Меап Тіше - среднее время по 
Гринвичу), 781 

&о(), метод объекта Ніаіогу, 373, 958 
Соо&1е, компания, предоставляет возможность 
загрузки сценариев веб-приложениями с других 
сайтов, 340 

&гер(), метод объекта іС^иегу, 619 
&гер(>» функция, 611 
&гоир(), метод объекта Сопаоіе, 906 
вгоирСо11арае<і(), метод объекта Сопаоіе, 906 
&гоирЕп<1(), метод объекта Сопаоіе, 906 
СДУТ, фреймворк, 368 

Н 

Ьапсііег, свойство объекта Еѵепі, 579 
Ьаа(), метод объекта і(}иегу, 619 
ЬааАМгіЬиЪеО, метод объекта Еіетепі, 407, 930 
ЬааАіігіЬиІеГІ8(), метод объекта Еіетепі, 930 
ЬааСІаааО, метод объекта і($иегу, 567 
ЬааГосиа(), метод объекта Боситепі, 919 
ЬааЬ, свойство 
Ьіпк, объект, 985 
Ьосаііоп, объект, 371, 711, 986 
ЛѴогкегЬосаііоп, объект, 1033 
ЬазЬсЬап&е, событие, 711 
НааЬСЬап^еЕѵепѣ, объект, 957 
ЬааОигпРгорегіуО, метод класса ОЪіесі, 148,846 
НАѴЕ, константы объекта МесІіаЕІетепЪ, 988 
Ьеа<1іп&, глобальная переменная, 381 
Ьеайіпв, свойство объекта Сеосоогсііпаіеа, 955 
НЕАО, метод, получение информации о ссылках 
при поддержке заголовка СОК8, 546 
Ьеа<1, свойство объекта Босишеп!, 396, 916 
Ьеі&М, свойство 

СІіепІКесѣ, объект, 904 
I Гг а те, объект, 961 
Іта&еОаіа, объект, 964 
Іта&е, объект, 963 
8сгееп, объект, 377 

Ьеі&М и лѵі<Ші, свойства стиля, 456, 457 
Ьеі&М(), метод объекта і($иегу, 569 
Ьі<1е(), метод объекта іС^иегу, 588, 591 
Ы^Ь, свойство объекта МеЪег, 995 
Ніаіогу, объект, 373, 958 

Ьаск(), Гог\ѵагс1() и &о(), методы, 373 
риаЬ8іа1е(), метод, 712 

управление историей посещений (пример), 
713 

гер1асе8Ъаіе(), метод, 713 
Ьізіогу, свойство объекта \Ѵіп(1о\ѵ, 373,1023 
Ьо8І, свойство 
Ьіпк, объект, 985 
Ьосаѣіоп, объект, 371, 986 
ЛѴогкегЬосаііоп , объект, 1033 
Ьобѣпате, свойство 
Ьіпк, объект, 985 
Ьосаѣіоп, объект, 371, 986 


ЛѴогкегЬосаііоп , объект, 1033 
:Ьоѵег, псевдокласс, 656 
Ьоѵег(), метод объекта іС^иегу, 576, 580 
ЬгеГ, атрибут элемента <а>, 342, 396 
ЬгеГ, свойство 

С888іу1е8Ьееі, объект, 910 
Ьіпк, объект, 985 
Ьосаііоп, объект, 371, 987 
ЛѴогкегЬосаііоп , объект, 1033 
Н8Ь (Ьие-заіигаЪіоп-ѵаІие - тон-насыщенность- 
яркость), формат определения цвета, 458 
Н8ЬА (Ьие-заіигаііоп-ѵаІие-аІрЬа - тон- 
насыщенность-яркость-альфа), формат опреде¬ 
ления цвета, 458 
<Ыш1>, элемент 

тапіГеві, атрибут, 643 
Ыш1(), метод объекта і(}иегу, 568 
НТМЬ, язык разметки 

Гііеііріоасі, объект, ограничение возможностей 
из соображений безопасности, 362 
<асгірі>, элемент, 335 
8е1есі и Орѣіоп, элементы, 435 
атрибуты элементов, 405 
включение таблиц стилей в НТМЬ-страницы, 
446 

встраивание ^ѵаЗсгірі, 337 
обработчики событий, 341 
сценарии во внешних файлах, 339 
элемент <асгірі>, 338 
имена тегов нечувствительны к регистру 
символов, 395 
кнопки, 433 

непосредственное использование разметки 
8ѴС в НТМЬ-файлах, 667 
нечувствительность к регистру, 41 
обработчики событий, 341 
переключатели и флажки, 434 
содержимое элементов в виде разметки НТМЬ, 
409 

текстовые поля ввода, 434 
управление содержимым с помощью 
^ѵа8сгірѣ, 32 
формы, 428 

чтение и запись значений НТМЬ-атрибутов 
методами объекта і($иегу, 565 
НТМЬ5, стандарт, 706 

АРІ механизма буксировки (<1га&-ап<1-<1гор), 508 
сІаззЬізѣ, свойство, 470, 567 
БОМСопіепіЬоасіесі, событие, 498 
&еѣЕ1етепѣ8ВуС1а88Кате(), метод, 398 
іппегНТМЬ и оиіегНТМЬ, свойства, 409 
іпзегѣА<1іасепШТМЬ(), метод, 410 
рІасеЬоМег, атрибут текстовых полей ввода, 435 
ЛѴеЪЗоскеІ АРІ, спецификация, 755 
\ѴеЬ ЛѴогкегз, спецификация, 720 
\Ѵіп(іо\ѵРгоху, объект, 389 
атрибуты с данными и свойство сіаіааеі, 407 
базы данных на стороне клиента, 747 
взаимодействие документов с разным 
происхождением, 716 
геопозиционирование, 707 
двоичные объекты, 732 
команды редактирования текста, 443 
кэш приложений, 643 

прикладные интерфейсы для веб-приложений, 
337 
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события, 486 

типизированные массивы и буферы, 728 
управление историей посещений, 711 
НТМЬСоІІесііоп, объект, 396, 959 
обзор, 396 
элементы форм, 430 
НТМЫЗоситепі, объект, 392,959 
ве1Е1етеп1ВуКате(), метод, 394 
ітавез, Іогтз и Ііпкз, свойства, 396 
НТМЬЕІетепі, объект, 392, 959 
іехі, свойство, 341 

представление НТМЬ-элементов в документе, 
380 

свойства, отражающие НТМЬ-атрибуты, 405 
МтІГог, свойство 
ЬаЪеІ, объект, 984 
Оиіриі, объект, 1003 

НТМЬГог тСопІгоІзСоІІесІіоп , объект, 959 
НТМЬОрііопзСоІІесііоп, объект, 960 
НТМЬ-атрибуты, отображаемые в обработчики 
событий, 341 

НТМЬ-атрибуты управления воспроизведением, 
660 

НТМЬ-формы 

ГогтСопігоІ, объект, 951 
ЕогшИвіа, объект, 953 
ГогтѴаІісіііу, объект, 954 
Гогт, объект, 949 

чтение и запись значений элементов форм, 567 
НТМЬ-элементы, 932 
НТТР, протокол, 755 

НТТР-сервер в Кобе (пример), 327 
взаимодействие с объектом ХМЬНИрНечиез!, 
363 

модуль утилит клиента НТТР в Кобе, 329 
работа с помощью объекта ХМЬНМрКечиезІ, 
527 

работа с протоколом, 524 

использование архитектуры Сотеі на осно¬ 
ве стандарта 8егѵег-8епі Еѵепіз, 550 
использование элементов <зсгірі>, 548 
НТТР-методы, 529 

I 

і, флаг (регулярные выражения), 285, 288 
і<1, атрибут НТМЬ-элементов, 380 
і<1, свойство объекта Еіетепі, 927 
ЮВКап&е, объект, 749 
і I, инструкция, 114 

в генераторах массивов, 308 
вложенная, с конструкцией еізе, 115 
<і!гате>, элемент 

и история посещений, 373 
как транспорт в архитектуре Аіах, 525 
свойства в документе для ссылки на объект 
ЛѴіпбоѵѵ, 395 
ІРгаше, объект, 961 

хідоогеСазе, свойство объекта Не^Ехр, 288, 858, 
860 

Іша^е, объект, 962 
Іша^еВаІа, объект, 963 

баіа, свойство, массив байтов, 730 
копирование в элемент <сапѵаз>, 901 
передача фоновому потоку с помощью метода 
розШезза^еО, 725 
создание, 898 


ітавез, свойство объекта Боситепі, 396, 916 
<іт^>, элемент, 656 

как транспорт в архитектуре Аіах, 525 
отображение изображений в формате 8ѴС, 666 
ітріетепіаііоп, свойство объекта Боситепі, 917 
ітрог1Кобе(), метод объекта Боситепі, 413, 919 
ітрог!8сгіріз(), метод объекта 
ЛѴогкегОІоЬаІЗсоре, 722,1031 
іп, оператор, 85, 97 

проверка существования унаследованных 
и неунаследованных свойств, 148 
іпАггау(), функция, 611 
іпбеіегтіпаіе, свойство объекта Іприі, 965 
іпсіех, свойство 
Аггау объект, 287 
Орііоп, объект, 1002 
іп(іех(), метод объекта іС^иегу, 564 
ІпбехебВВ, прикладной интерфейс, 748 
база данных с почтовыми индексами США 
(пример), 750 
іпбехО?(), метод 

Аггау, объект, 180, 768 
8ІГІП&, объект, 866 

-Іпііпііу (отрицательная бесконечность), 53 
Іпііпііу (положительная бесконечность), 53 
Іпііпііу, свойство, 817 
іп1о(), метод объекта Сопзоіе, 906 
іпііЕѵепІО, метод объекта Еѵепі, 941 
іпіііаІТіте, свойство объекта МебіаЕІетепі, 660, 
989 

іппегНеі^Ы и іппег^УкШі, свойства объекта 
ТОпболѵ, 1023 

іппегНеі^ЫО и іппег^Уі<Ші(), методы объекта 
І(}иегу, 569 

іппегНТМЬ, свойство объекта Еіетепі, 409,927 
использование в объектах і(}иегу для получе¬ 
ния содержимого элемента, 568 
іппегТехі, свойство объекта Еіетепі, 410 
<іприі>, элемент как кнопка, 433 
выгрузка файлов, 539 
іприі, глобальная переменная, 381 
Іприі, объект, 964 
методы, 966 
свойства, 964 
іприі, свойство, 287 

іприі, событие, возбуждаемое после вставки 
текста в элемент, 518 

іприІМеіЬоб, свойство объекта Еѵепі, 515,518,942 
іпзегІАбіасепШТМЬ(), метод объекта Еіетепі, 
410, 930 

іпзегіА1іег(), метод объекта і(}иегу, 572 
іпзегіВеІогеО, метод объекта і(}иегу, 572 
іпзегіВеІогеО, метод объекта Кобе, 413,1000 
іпзегіСеЩ), метод объекта ТаЫеНоѵѵ, 1013 
іпзегШа1а(), метод 
Соттепі, узел, 905 
Техі, объект, 1015 
іпзегШолѵ(), метод 
ТаЫе, объект, 1012 
ТаЫеВесііоп, объект, 1014 
іпзегШи1е(), метод объекта С888іу1е8Ьееі, 474,911 
іпзрес1(), метод объекта СопзоІеСоттапбЬіпе, 908 
іпзіапсео?, оператор, 85, 97 
и метод ізРгоіоіуреОІО, 159 
использование с конструкторами для проверки 
принадлежности к классу, 225 
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невозможность отличить массивы от объектов, 
181 

определение классов объектов, 232 
работа с объектами и классами Лаѵа в Шііпо, 
316 

ІпівАггау, класс, 728,1017 
ІпіІбАггау, класс, 728,1017 
Іп132Аггау, класс, 728,1017 
Іпіегпеі Ехріогег (ІЕ), веб-броузер 

АРІ механизма буксировки (<1гав-ат1-<1гор), 508 
<сапѵаз>, элемент, 672 
сііепііпіогтаііоп, свойство, 374 
сиггепіЗіуІе, свойство, 469 
Шіег, свойство, 459 

ргорегіусЬап&е, событие, применение для 
определения факта ввода текста, 518 
ХМЫШрНеяиеаі в ІЕ6, 528 
блочная модель С88, 457 
вычисленные свойства, 469 
и перехват событий, 496 
методы таймера, 371 
механизм сохранения иаегБаіа, 641 
модель событий 

аМасЬЕѵепі(), метод, 349, 492, 945 
(іеіасЬЕѵепІО, метод, 492, 945 
события форм, 482 

невсплывающие версии событий мыши, 484 
не поддерживает 

метод веІЕІетепІаВуСІаааКатеО, 398 
получение выделенного текста, 440 
свойство іппегТехі вместо ІехіСопіепі, 410 
текущая версия, 355 
условные комментарии, 359 
іРЬопе и іРасі, устройства компании Арріе, 
события вегіиге И ІоисЬ, 488 
іа(), метод объекта і(}иегу, 564 
ізАггауО, метод объекта Аггау, 181 
ізАггауО, функция, 611 

ізСопІепіЕсііІаЫе, свойство объекта Еіетепі, 927 
І8Пе{аи1ДОате8расе(), метод объекта Кобе, 1000 
ізЕтрІуОЪіесІО, функция, 611 
ізЕяиаІКобеО, метод объекта Кобе, 1000 
ізЕхІепзіЫеО, функция, 160, 847 
ігРіпііеО, функция, 55, 817 
ізРгогепО, функция, 161, 847 
ізРипсііопО, функция, 214, 611 
ізКаКО, функция, 55, 817 
ізРІаіпОЬіесІО, функция, 612 
ізРоіпІІпРаіЬО, метод объекта 
Сапѵа8Непбегіп^Соп1ехі2В, 900 
ізРгоІоІуреОД), метод, 159, 848 
і&8атеКобе(), метод объекта Кобе, 1000 
і&8еа1еб(), функция, 161, 848 
іаТгигіеб, свойство объекта Еѵепі, 939 
ііет(), метод 

БОМТокепЫг!, объект, 925 
НТМЬСоІІесііоп, объект, 397, 959 
НТМЬОрІіопзСоІІесІіоп , объект, 960 
КобеЬізі, объект, 397,1002 
8е1есі, элемент, 1009 

ііета, свойство объекта БаІаТгапБІег, 512 

_ ііегаіог _(), метод, 302 

І1ега1ог(), функция, 303 

присваивание с разложением, 303 


баѵа, язык программирования 

изменение значений статических полей 
классов в Шііпо, 317 « 

создание экземпляров классов языка баѵа, 316 
управление с помощью Шііпо, 315 

создание графического интерфейса (при¬ 
мер), 319 

ІаѵаЕпаЫеб(), метод объекта Каѵідаіог, 376 
ІаѵаЕхсерііоп, свойство объекта Еггог, 318 
баѵаЗсгірІ, язык программирования 

в веб-документах и веб-приложениях, 336 
версии, 290, 297 

поддержка событий колесика мыши, 504 
справочник, 881 
Іаѵаасгірі:, ІЖЬ-адреса, 342 
Іоіп(), метод объекта Аггау, 172, 769 
І()ііегу, библиотека, 32, 622, 626, 967 
Аіах в версии і()ііегу 1.5, 603 
ІфіегуО, функция ($()), 558 
анимационные эффекты, 586 
базовые методы и свойства, 969 
вспомогательные функции, 610 
грамматика селекторов, 968 
запросы и результаты запросов, 562 
запросы на основе селекторов С88,400 
имена функций и методов в официальной 
документации, 562 

методы воспроизведения анимационных 
эффектов, 978 

методы вставки и удаления, 974 
методы выбора, 618 

использование результатов выбора 
в качестве контекста, 619 
методы работы с событиями, 976 
методы работы с элементами, 972 
обработка событий, 575 
основы, 557 
получение, 559 

расширение с помощью модулей расширений, 
622 

реализация Аіах, 595 
аіах(), функция, 601 
&еі() и ро&1(), функции, 600 
веіб80К(), функция, 598 
веі8сгірі(), функция, 598 
1оаб(), метод, 595 
вспомогательные функции, 597 
коды состояния, 596 
события Аіах, 608 
типы данных, 601 
селекторы, 613 
группы, 617 
комбинированные, 617 
простые, 614 
терминология, 561 
фабричная функция, 967 
функции поддержки архитектуры А^ах, 980 
І(}иегу, объект 

изменение структуры документа, 571 
методы чтения и записи, 565 
Іяиегу, свойство, 563 
І (}иег у.Ъгоѵѵзег, свойство, 610 
І()ііегу.еа8Іпб, объект, 592 
І()ііегу.?х.8рее<І8, объект, 586 
І()ііегу Ш, библиотека, 625 
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ІяХНН, объект, 603 

Л8(Ж, формат представления данных, 161, 818 
І9иегу.^е1Л80К(), функция, 598 
ІоЛ8СЖ(), метод, 162,163 
выполнение Р08Т-запросов с данными 
в формате Л8(Ж, 538 
методы, реализация в классах, 243 
Л8(ДО.раг8е(), функция, 161,162, 819 
Л8(ДО.8Ігіп&і?у(), функция, 161, 712,820 
Л8СЖР, формат данных, 548 

выполнение запросов с помощью элемента 
<зсгірі>, 549 

К 

КеуЪоагсіЕѵепі, объект, 485 
кеу, свойство, 519 

Еѵепі, объект, 486, 942 
8іога&еЕѵепі, объект, 1010 
кеу(), метод объекта 8іога&е, 1010 
кеуСобе, свойство, 515, 519 
Еѵепі, объект, 939 
КеуЕѵепі, объект, 984 
кеуИепіШег, свойство, 519 

Кеутар, класс поддержки обработки комбинаций 
клавиш (пример), 520 

кеу&(), метод объекта СопзоІеСотташІІлпе, 908 
кеуз(), функция, 849 

перечисление имен свойств, 151 

I. 

ЬаЬеІ, объект, 984 

ІаЬеІ, свойство объекта Орііоп, 1002 

ІаЬеІз, свойство 

ГогтСопігоІ, объект, 952 
Меіег, объект, 995 
Рговгезз, объект, 1005 
1ап&, свойство объекта Еіетепі, 927 
ІазіО, метод объекта і(}иегу, 618 
ІазІСМЫ, свойство объекта Кобе, 401, 998 
ІазіЕІетепіСЬіІсІ, свойство объекта Еіетепі, 402, 
927 

ІазіЕѵепіІсІ, свойство объекта Мезза&еЕѵепі, 993 
Іазііпсіех, свойство 

Не^Ехр, объект, 288, 858,860 
методы объекта 8ігіп&, 288 
ІазіІпбехОіО, метод 
Аггау, объект, 180, 769 
8ІГІП&, объект, 866 

1азіМо<1Ше<1, свойство объекта Босшпепі, 437, 917 
ІазіМоёШесШаіе, свойство объекта Рііе, 735, 946 
Іаіііибе, свойство объекта Сеосоопііпаіез, 955 
Іеіі, ГІ&М, іор и Ъоііот, свойства объекта 
СІіепіКесі, 904 

Іеіі и іор, свойства стиля, 452, 456 
1еп&1Ь,свойство 

Агвшпепіз, объект, 194, 209, 761, 762 
Аггау, объект, 764, 770 
Соттепі, объект, 905 
С888іу1еЕ)ес1агаііоп, объект, 910 
БОМТокепІлзі, объект, 924 
Еогт, объект, 950 
Гипсііоп, объект, 814 
Нізіогу, объект, 958 
НТМЬСоІІесііоп, объект, 959 
НТМЬОрііопзСоІІесііоп, объект, 960 
ІС^иегу, объект, 562 
Ыосіеілзі, объект, 1002 


8е1есі, элемент, 1008 
8іога&е, объект, 1009 
8ігіп&, объект, 867 
Техі, объект, 1014 
ТітеНап^е, объект, 1017 
^Ѵіпбодѵ, объект, 387,1023 
массивов, 166 

манипулирование, 168 
разреженных, 167 
типизированных, 1018 
функций,209 

Іеп&іЬСотриіаЫе, свойство объекта 
Рго&геззЕѵепі, 1006 
Іеі, ключевое слово, 295 

использование для инициализации перемен¬ 
ной цикла, 295 

как замена инструкции ѵаг, 295 
НпеСар, свойство объекта 
СапѵазНепсіегіп^Соп1ехі2В, 691, 892, 895 
ІіпеЛоіп, свойство объекта 
Сапѵа8Непйегіп^Соп1ехі2Б, 692, 892,895 
Ііпепо, свойство объекта ЕггогЕѵепі, 936 
1іпеТо(), метод объекта 

Сапѵа8Непйегіп^Соп1ехі2В, 675, 684,691,901 
1іпё\Уі(Ші, свойство объекта 
СапѵазКеп<1егіп&Сопіехі2П, 678, 691, 892,895 
Ілпк, объект, 984 

Нпкз, свойство объекта Боситепі, 396, 917 
Іізі, свойство объекта Іприі, 965 
1іѵе(), метод объекта і(}иегу, 585 
Ь№, константа (объект МаіЬ), 826 
ЬШО, константа (объект МаіЬ), 826 
Іоасі, событие, 345, 482 
ЕіІеНеаёег, объект, 740 

оп Іоасі, обработчик события объекта ^Ѵіпбодѵ, 
335 

документ, распространение событий, 496 
поддержка в веб-броузерах, 351 
регистрация обработчика, 31 
1оа<1(), метод 

І^иегу, объект, 575 
МебіаЕІетепі, объект, 992 
мультимедийных элементов, 660 
утилита А^ах в библиотеке іС^иегу, 595 
1оа<1(), функция (Шііпо), 315 

Іоасіесі, свойство объекта Рго&геззЕѵепі, 542,1006 
Іосаіе, свойство объекта Еѵепі, 942 
1оса1еСотраге(), метод объекта 8ігіп&, 867 
ІосаШате, свойство объекта Аііг, 885 
ІосаДОате, свойство объекта Еіетепі, 927 
1оса18іога&е, свойство объекта АѴіпболѵ, 630,1023 
автономные веб-приложения, 650 
в сравнении с соокіег, 636 
прикладной программный интерфейс объекта 
8іога&е, 632 
события, 633 

срок хранения и область видимости, 630 
Ьосаііоп, объект, 986 
аззівпО, метод, 372 
Ьа&Ь,свойство, 371, 711 
Ьозіпате, свойство, 371 
ІІОЗІ, СВОЙСТВО, 371 
Ьгеі, свойство, 371 
раіЬпате, свойство, 371 
рогі, свойство, 371 
ргоіосоі, свойство, 371 
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ге1оа<1(), метод, 373 
гер1асе(), метод, 372 
зеагсЬ, свойство, 371 
1о81гш&(), метод, 371 
Іосаііоп, свойство 

Босшпепі, объект, 371, 437, 917 
Еѵепі, объект, 942 
\Ѵіпс1о\ѵ, объект, 334, 371, 1024 
^УогкегС1оЪа18соре, объект, 724,1031 
ЬОС2Е, константа (объект МаіЬ), 827 
ЬОСІОЕ, константа (объект МаіЬ), 827 
1о^(), метод объекта Сопзоіе, 727, 906 
1ог(), функция, объект МаіЬ, 827 
Іоп&ііисіе, свойство объекта Сеосоопііпаіез, 955 

_ІоокирСеМег_() и_ІоокирЗеМег_(), методы, 

158 

ІоокирКатезрасеІЖІО, метод объекта Кобе, 1001 
1оокирРгеТіх(), метод объекта Кобе, 1001 
Іоор, свойство объекта МейіаЕІетепІ, 661, 989 
Іолѵ, свойство объекта Меіег, 995 

М 

ш, флаг (регулярные выражения), 285, 288 
шакеАггауО, функция, 612 
шар(), метод 

Аггау, объект, 177, 215, 770 
объектов Аггау и іС^иегу, 564 
шар(), функция, 612 
шаг^іп, свойство, 464, 465 
таісЬ(), метод объекта 8ігіп&, 286, 288, 868 
МаіЬ, объект, 822 
аЪз(), функция, 823 
асоз(), функция, 823 
азіп(), функция, 823 
аіап2(), функция, 824 
аіап(), функция, 824 
сеі1(), функция, 824 
соз(), функция, 825 
ехр(), функция, 825 
11оог(), функция, 826 
Іо^О, функция, 827 
шах(), функция, 210, 827 
шіп(), функция, 828 
ролѵ(), функция, 828 
гапбошО, функция, 829 
гоип(і(), функция, 829 
зіп(), функция, 829 
8ягі(), функция, 829 
ѣап(), функция, 830 
константы, 822 
статические функции, 822 
функции и константы как свойства, 53 
шах, свойство 

Іприі, объект, 965 
Меіег, объект, 995 
Рго&гезз, объект, 1005 
шах(), функция объекта МаіЬ, 210, 827 
тах-а&е, атрибут соокіез, 636 
тахітитА&е, параметр объекта Сеоіосаііоп, 956 
тахЬеп&Ні, свойство объекта Іприі, 965 
МАХ ѴАЫІЕ, константа (объект КишЬег), 833 
теазигеТехІ(), метод объекта 
Сапѵа8Непёегіп^Соп1ех120, 693, 901 
шесііа, свойство 

СЗЗЗіуІеЗЬееі, объект, 910 
Зіуіе, объект, 1011 


МеёіаЕІетепі, объект, 987 

константы, определяющие возможные 
значения свойства геаёуЗіаіе, 987 
методы, 991 

обработчики событий, 990 
свойства, 988 
МеёіаЕггог, объект, 992 
тег&е(), функция, 612 
теззаде, свойство 

Еггог, объект, 804, 805 
ЕггогЕѵепі, объект, 936 
ЕѵаІЕггог, объект, 809 
СеоІосаііопЕггог, объект, 957 
НеГегепсеЕггог, объект, 857 
ІЖІЕггог, объект, 880 
теззаде, событие, 717 
Мезза&еСЬаппеІ, объект, 724, 992 
Мезза^еЕѵепі, объект, 993 
Мезза^еРогі, объект, 724, 994 
теіаКеу, свойство, 500, 519 
Еѵепі, объект, 939 

в библиотеке іС^иегу, 578 
событий мыши, 483 
Меіег, объект, 995 

шеіЬоб, свойство объекта Рогш, 431, 950 
МІМЕ-тип 

данных в формате НТМЬ-форм, 536 
объявления кэшируемого приложения, 644 
определение в НТТР-заголовках Сопіепі-Туре, 
530 

переопределение некорректного типа 
в НТТР-ответе, 535 

МШѴАІЛЕ, константа (объект МшпЪег), 833 
тіп , свойство 

Іприі, объект, 965 
Меіег, объект, 995 
тіп(), функция, объект МаіЬ, 828 
тііегілтіі, свойство, 895 

СапѵазКеп<1егіпвСоп1ехі2П, объект, 692 
топііогЕѵепізО, метод объекта 
СопзоІеСоттапбЫпе, 908 
тоизебодѵп, событие, 500 
тоизеепіег, событие, 500 
МоизеЕѵепі, объект, 996 
тоизеіеаѵе, событие, 500 
тоизетоѵе, событие, 500 
тоизеоиі, событие, 500 
тоизеоѵег, событие, 500 
тоизеир, событие, 500 
тоизелѵЬееІ, событие, 484, 485 
тоѵеТо(), метод объекта 
СапѵазНеп(1егіп^Соп1ех12Б, 675, 901 
МогШа, проект 

версии ЛаѵаЗсгірі, 290 
загрузка Шііпо, 315 

тиІШіпе, свойство объекта Не^Ехр, 288, 858 
тиіііріе, свойство 
Іприі, объект, 965 
8е1есі, элемент, 1007 
тиіей, свойство 

МегііаЕІетепі, объект, 989 
управление воспроизведением, 660 

N 

\\п (символ перевода строки), 59 
пате, атрибут НТМЬ-элементов, 381, 431 
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выбор элементов документа по значению 
атрибута пате, 394 

создание свойств в объекте Босшпепі, 395 
пате, свойство 
АМг, объект, 886 
ВосшпепіГга&тепІ, объект, 922 
БОМЕхсерІіоп , объект, 923 
Еггог, объект, 804, 805 
ЕѵаІЕггог, объект, 809 
Еііе, объект, 735, 946 
ГогтСопігоІ, объект, 952 
Гогт, объект, 950 
ІРгате, объект, 961 
КеІегепсеЕггог, объект, 857 
ІІНІЕггог, объект, 880 
АУіпболѵ, объект, 383,1024 
элементов форм, 432 
патебІ1ет(), метод 

НТМЬСоІІесііоп, объект, 397, 959 
НТМЬОрііопзСоІІесііоп , объект, 961 
8е1есі, элемент, 1009 

патезрасеІЖІ, свойство объекта АМг, 886 
патезрасеІЖІ, свойство объекта Еіетепі, 927 
КаК, константа (объект КшпЪег), 833 
КаК (нечисло), 54, 830 
і&КаК(), функция, 817 
КшпЪег.КаК, константа, 833 
и операции сравнения, 54 
паІигаІНеі^Ы и паіигаПУкШі, свойства объекта 
Іта^е, 963 

Каѵідоіог, объект, 359, 374, 996 
аррКате, свойство, 375 
аррѴегзіоп, свойство, 375 
соокіеЕпаЫеб, свойство, 635 
соокіезЕпаЫеё(), метод, 376 
веоіосаііоп, свойство, 376, 708 
ІаѵаЕпаЫеб(), метод, 376 
опііпе, свойство, 650 
опілпе, свойство, 376 
ріаііогт, свойство, 375 
изегА^епі, свойство, 375 
свойства, определяющие тип броузера, 374 
паѵі&аіог, свойство 

ЛУіпбо\ѵ, объект, 374,1024 
ЛѴогкегСІоЬаІЗсоре, объект, 724,1031 
КЕСАТІѴЕ_ІКПКІТУ, константа (объект 
КшпЪег), 833 

КЕТ\УОКК, раздел в файле объявления кэшируе¬ 
мого приложения, 645 

пеІлѵогкЗіаіе, свойство объекта МебіаЕІетепі, 
662,989 

пелѵ, ключевое слово 

в выражениях создания объектов, 84 
создание экземпляров классов языка баѵа, 316 
пелѵ, оператор 

вызов конструктора, 224 
создание объектов, 140 

пелѵІЖЬ, свойство объекта НагЬСЬап&еЕѵепІ, 957 
пелѵѴаІие, свойство объекта 81ога&еЕѵепі, 1010 
пехі() и ргеѵ(), методы объекта і(}иегу, 620 
пехі(), метод 

генераторов, 304 
итераторов, 301 

пех1А11()и ргеѵА11(), методы объекта іС^иегу, 620 
пех1Е1етепі8іЫіп^, свойство объекта Еіетепі, 
402,927 


пех18іЫіпб, свойство объекта Кобе, 401, 998 
пехШпШО и ргеѵШШО, методы объекта і(}иегу, 
621 

поСопШсіО, функция, 560,623 
Кобе, интерпретатор, 314 

электронная документация, 322 
Кобе, объект, 997 

аррепбСЬіІбО, метод, 413 
аМгіЪиіез, свойство, 408 
с1опеКобе(), метод, 413 
іпаегіВеГогеО, метод, 413 
гетоѵеСЬі1б(), метод, 415 
гер1асеСЬі1б(), метод, 415 
іехіСопіепі, свойство, 410 
документы как деревья узлов, 401 
константы, определяющие возможные значе¬ 
ния, возвращаемые методом 
сотрагеІ)осшпепіРо8і1іоп(), 998 
константы, определяющие возможные значе¬ 
ния свойства побеТуре, 998 
методы, 999 
свойства, 998 

Кобеілзі, объект, 394, 919,1001 
возвращается методом 
&е1Е1етепІ8ВуТа&Кате(), 395 
обзор, 396 

побеКате, свойство объекта Кобе, 401, 998 
побеТуре, свойство объекта Кобе, 401,999 
побеѴаІие, свойство объекта Кобе, 401, 412,999 
погтаІігеО, метод объекта Кобе, 1001 
поі(), метод объекта і(}иегу, 619 
поѴаІібаіе, свойство объекта Гогт, 950 
по\ѵ(), метод объекта Баіе, 789 
пиіі, значение, 62,63 

и выражения обращения к свойствам, 82 
свойства, ошибка доступа, 146 
КшпЪег, объект, 831 

М АХѴАІДІЕ , константа, 833 
МІКѴАЫІЕ, константа, 833 
КаК, константа, 833 
КЕСАТІѴЕ_ІКГІКІТУ, константа, 833 
Р08ІТІѴЕ_ІКГІКІТУ, константа, 834 
1оЕхропеп1іа1(), метод, 834 
1оГіхеб(), метод, 835 
1оЬоса1е81гіп&(), метод, 836 
1оРгесІ8Іоп(), метод, 836 
1о8ігіп&(), метод, 69, 837 
ѵаІиеОЗД, метод, 838 
константы, 831 
методы, 831 

КшпЪегО, конструктор, 64, 831 

КшпЪегО, функция, преобразование типов, 69 

О 

<оЬіес!>, элемент, 571, 658 

отображение изображений в формате 8ѴС, 666 
ОЬіесі, класс, 97,838 

СОП8ІШСІОГ, свойство, 838,840 
сгеаіе(), функция, 156,157, 841 
беІіпеРгорегііезО, функция, 156, 842 
беГіпеРгорегіуО, функция, 124,155,158,168, 
842 

{геегеО, функция, 161, 843 
2 еЮіѵпРгорег!уІ)е 8 Сгір!ог(), функция, 158,844 
беЮіѵпРгорегіуКате8(), функция, 151, 845 
беІРгоіоіуреОіО, функция, 158, 845 
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ЬазОлѵпРгорегІуО, метод, 148, 846 
І8Ехіеп8іЫе(), функция, 160, 847 
І8Ргогеп(), функция, 161, 847 
ізРгоіоІуреОЭД, метод, 159, 848 
і&8еа1е(1(), функция, 161, 848 
кеу&(), функция, 151, 849 
ргеѵепіЕхіеп8Іоп8(), функция, 160, 850 
рг орег ІуБезсг іріог 0, функция, 155 
ргорегІуІзЕпитегаЫеО, метод, 148, 850 
ргоіоіуре, свойство, 140 
&еа1(), функция, 160, 851 
1оЬоса1е8ігіпв(), метод, 851 
Іо8ігіп&(), метод, 852 
ѵаІиеСЩ), метод, 853 
методы, 162, 838 
статические, 839 

ОЪіесіО, функция, преобразование типов, 69 
ОШіпе \ѴеЬ Арріісаііопз АРІ, 628 
оНгеі, свойства элементов документа, 426 
оН&еі(), метод объекта і(}иегу, 568 
оНзеіНеі&М и оІІзеІЛѴібіЬ, свойства объекта 
Еіетепі, 426, 927 

оНгеіІіеіІ и оіізеІТор, свойства объекта Еіешепі, 
426,927 

оНзеіРагепі, свойство объекта Еіетепі, 426, 927 
оНзеіРагепіО, метод объекта іС^иегу, 569 
оІІзеіХ и оІІзеіУ, свойства объекта Еѵепі, 939 
оІсШНЬ, свойство объекта НазЬСЬап^еЕѵепІ, 957 
оІбѴаІие, свойство объекта Зіога^еЕѵепі, 1010 
опЪеІогеипІоаб, обработчик события окна, 495 
опсЬап&е, атрибут, 341 
опсЬап&е, обработчик событий 

переключателей и флажков в формах, 434 
текстовых полей ввода, 435 
опсііск, обработчик событий, 343 
кнопки в формах, 433 

опсіозе, свойство объекта ЛѴогкегСІоЬаІЗсоре, 722 
опбга&зіагі, обработчик событий, 510 
опе(), метод объекта і(}иегу, 580 
опеггог, свойство 

ЛУіпбоѵѵ, объект, 379, 482 

присваивание функции, 349 
ЛѴогкегСІоЬаІЗсоре, объект, 724 
опЬазЬсЬап&е, свойство объекта ЛУіпбоѵѵ, 711 
опЫпе, свойство 

Каѵі^аіог, объект, 376, 996 
ЛУогкегК аѵі&аіог, объект, 1033 
опіоаб, обработчик событий, 345 

в программе часов с цифровым табло, 338 
опЬоаб(), функция (пример), 349 
опшезза^е, свойство объекта ЛУогкегСІоЪаІВсоре, 
722 

оптоизеболѵп, атрибут элемента <сііѵ>, 504 
опгеабузіаІесЬапзе, свойство объекта 
ХМЬНМрКедиезІ, 532,1039 
опгезеі, обработчик событий элементов форм, 432 
опзіога&е, свойство объекта ^Уіпболѵ, 633 
опзиЪтіІ, обработчик событий элементов форм, 
432 

опіітеоиі, свойство объекта ХМЬНМрКеяиезі, 544 
орасііу, свойство, 459, 586 

анимационные эффекты, 588 
ореп(), метод 

Боситепі, объект, 920 
^Уіпболѵ, объект, 383,1027 
ХМЬНМрК^иезІ, объект, 1037 


орепег, свойство объекта ТОпболѵ, 385,1024 
Ореп8осіа1 АРІ, 294 
Орега, веб-броузер 

глобальный подход к композиции, 700 
текущая версия, 355 
оріішиш, свойство объекта Меіег, 995 
Орііоп, объект, 1002 
Орііоп, элемент, 435 
орііопз, свойство элемента 8е1есі, 1008 
огіепіаііоп, свойство объекта ЛУіпбоѵѵ, 489 
огіепІаІіопсЬап&еб, событие, 489 
огі&іп, свойство объекта Мевза&еЕѵепІ, 717,993 
огі&іпаІЕѵепі, свойство объекта Еѵепі, 579 
оиІегНеі&М и оиіег^УібіЬ, свойства объекта 
ЛУіпбоѵѵ, 1024 

оиіегНТМЬ, свойство объекта Еіетепі, 409, 928 
оиіег^УібіЬ() и ои!егНеі&М(), методы объекта 
І(}иегу, 569 
Оиіриі, объект, 1003 
оѵегііоѵѵ, свойство, 459, 483 
оѵеггісіеМітеТуре(), метод объекта 
ХМЬНМрКеяиеаі, 535,1037 
олѵпегОоситепі, свойство объекта Кобе, 999 
оѵѵпегКобе, свойство объекта С8881у1е8Ьееі, 911 
олѵпегНиІе, свойство объекта С8881у1е8Ьееі, 911 

Р 

раббіпв, свойство, 447 
Ра^еТгапаіІіопЕѵепІ, объект, 1003 
ра&еХ и ра&ёУ, свойства объекта Еѵепі, 939 
в библиотеке і(}иегу, 578 
ра&еХОНзеі и ра&ёУОНвеі, свойства объекта 
^Уіпболѵ, 422, 1024 
рагаш(), функция, 600 
рагепі, свойство объекта ^Уіпболѵ, 1024 
рагепіО и рагепізО, методы объекта і(}иегу, 621 
рагепШобе, свойство объекта Кобе, 401,999 
рагепДОиІе, свойство объекта С88Ни1е, 909 
рагеп181у1е8Ьееі, свойство 
С88Ки1е, объект, 909 
С8881у1е8Ьееі, объект, 911 
рагепІ8ІІпШ(), метод объекта іС^иегу, 621 
рагзеО, метод объекта Баіе, 790 
рагзе(), функция, 161, 819 
рагзеЕ1оа1(), функция, 70, 854 
рагзеІпІ(), функция, 70, 855 
рагзеб80К(), функция, 612 
раіЬпаше, свойство 
Ьіпк, объект, 985 
Ьосаііоп, объект, 371, 987 
АУогкегЬосаііоп, объект, 1033 
раіЬ, атрибут соокіез, 636 
раііегп, переменная, 277 
раііегп, свойство объекта Іприі, 965 
раиегпМізтаісЬ, свойство объекта ЕогшѴаІібііу, 
954 

раигеб, свойство объекта МебіаЕІешепі, 989 
раи&е(), метод объекта МебіаЕІешепі, 660, 992 
регзізіеб, свойство объекта Ра&еТгапзіІіопЕѵепІ, 
1003 

ріхеШеріЬ, свойство объекта Всгееп, 1006 
РІ, константа (объект МаіЬ), 828 
рІасеЬоІбег, атрибут текстовых полей ввода, 435 
рІасеЬоІбег, свойство объекта Іприі, 966 
ріаііогш, свойство 

Каѵі&аіог, объект, 375, 996 
\ѴогкегКаѵі^а1ог, объект, 1033 
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р1ау(), метод объекта МесІіаЕІетепІ, 660, 992 
рІауЪаскКаІе, свойство объекта МесІіаЕІетепІ, 
660, 989 

ріауеб, свойство объекта МесІіаЕІетепІ, 661, 989 
ріи^іпз, свойство 

Боситепі, объект, 917 
НТМЬБоситеп!, объект, 396 
РКС, формат изображений, получение содержи¬ 
мого холста, 698 

рор(), метод объекта Аггау, 169,175, 771 
рорзіаіе, событие, 712, 713 
РорЗІаІеЕѵепІ, объект, 1004 
рог 11 и рог 12, свойства объекта МеззавеСЬаппеІ, 
993 

рогі, свойство 
Ьіпк, объект, 985 
Ьосаііоп, объект, 371, 987 
АУогкегЬосаІіоп, объект, 1033 
рогіз, свойство объекта Мезза^еЕѵепІ, 994 
розіііоп, свойство, 451 
объекта Рго^гезз, 1005 
ро8І1іоп(), метод объекта і(}иегу, 569 
Р08ІТІѴЕШГШІТѴ, константа (объект 
КшпЪег), 834 

Р08ІХ (ІЖІХ) АРІ, поддержка в ІЯосіе, 325, 326 
Р08Т, метод, 529 

выгрузка файлов посредством НТТР-запросов, 
540 

выполнение НТТР-запросов с данными 
в формате НТМЬ-форм, 537 
в формате Л8СДО, 538 
в формате ХМЬ, 538 
передача простого текста серверу, 531 
тело запроса, 531 
ро8І(), функция, 600 
розіег, свойство объекта Ѵісіео, 1020 
розІМезза&еО, метод 

Мезза^еРогІ, объект, 994 
\Ѵіпс1о\ѵ, объект, 716,1027 

модуль поиска на сайте Тѵѵіііег, 718 
АѴогкег, объект, 721,1030 
АУогкегСІоЪаІЗсоре, объект, 1032 
ро\ѵ(), функция, объект МаіЬ, 828 
ргеііх, свойство 
А11г, объект, 886 
Еіетепі, объект, 928 

ргеіоаё, свойство объекта МесІіаЕІетепІ, 660, 989 
ргереп<1(), метод объекта і(}иегу, 572 
ргерепсГГоО, метод объекта і(}иегу, 572 
ргеѵ(), метод объекта і<іиегу, 620 
ргеѵА11(), метод объекта і(}иегу, 620 
ргеѵепШеІаиІ1( ), метод объекта Еѵепі, 497, 584, 
941 

ргеѵеп1Ех1еп8Іоп8(), функция, 160, 850 
ргеѵіоизЕІешепІЗіЬІіп^, свойство объекта 
Еіетепі, 402, 928 

ргеѵіоизЗіЫіп^, свойство объекта Кобе, 401, 999 
ргеѵІЛі1і1(), метод объекта і(}иегу, 621 
ргіп!(), метод объекта ЛѴіпсІоѵѵ, 1027 
ргіп1(), функция (Шііпо), 316 
ргосеззіЗаІа, параметр, 600 
Ргосеззіп&іпзігисііоп, объект, 1004 
ргоШе(), метод 

Сопзоіе, объект, 906 
СопзоІеСоттапсІІлпе, объект, 908 


ргоШеЕпбО, метод 
Сопзоіе, объект, 907 
СопзоІеСотташІЬіпе, объект, 908 
Рго&гезз, объект, 1004 
рговгезз, событие, 488 
Рго^геззЕѵепІ, объект, 1005 
рготр1(), метод объекта ЛѴіпсІоѵѵ, 377,1027 
ргорег1уІ>е8Сгір1ог(), функция, 155 
ргорег1уІзЕпишегаЫе(), метод, 148,850 
ргоіосоі, свойство 
Ьіпк, объект, 985 
Ьосаііоп, объект, 371, 987 
■\УеЪ8оске1, объект, 757,1021 
АУогкегЬосаІіоп, объект, 1033 
ргоіоіуре, атрибут, 158,159 
Ргоіоіуре, библиотека, 368 
ргоіоіуре, свойство 
Гипсііоп, объект, 814 
наследование, 140 

ограничение на использование в безопасных 
подмножествах, 293 
функций, 209 

функции-конструктора, 226 
Ргоіоіуре, фреймворк 

Зсгіріасиіоиз, библиотека, 467 
ргоху(), функция, 612 

риЫісИ, свойство объекта БоситепІРга^шепІ, 922 
ризЬ(), метод объекта Аггау, 175, 771 

добавление элементов в конец массива, 169 
ризЬЗІаскО, метод объекта іС^иегу, 622 
ризЬЗІаІеО, метод объекта Нізіогу, 712, 958 
управление историей посещений (пример), 713 
риІІта&еБаІаО, метод объекта 
СапѵазКеп<1егіп&Соп1ехі2П, 901 

о 

ЯііайгаІісСигѵеТоО, метод объекта 
СапѵазКепс1егіп&Соп1ех12В, 685, 902 
^ие^уСоттапс1ЕпаЫес1(), метод объекта 
Оосишепі, 442, 920 

яиегуСоттап<1Іп<1е1егт(), метод объекта 
Боситепі, 443, 920 

^ие^уСоттап<181а1е(), метод объекта Боситепі, 
442, 920 

яиегуСоттап<18ііррог1е<1(), метод объекта 
Иоситепі, 920 

яиегуСоттап<1Ѵа1ие(), метод объекта Боситепі, 
442,920 

яиегу8е1ес1ог(), метод 

Иосишепі, объект, 399, 920 
НоситепіРга&тепІ, объект, 399 
Еіетепі, объект, 930 
^ие^у8е1ес1о^А11(), метод 

Боситепі, объект, 399, 473, 920 
в сравнении с функцией $(), 564 
БоситепІЕга^тепІ, объект, 399 
Еіетепі, объект, 930 
выбор элементов форм, 430 
яиеие, свойство объекта с параметрами анимаци¬ 
онного эффекта, 591 
яиеие(), метод объекта і(}иегу, 594 

К 

гаш1от(), функция, объект МаіЬ, 829 
Кап&е, объект, 440 
Кап&еЕггог, объект, 856 

гап^еОѵегІІолѵ, свойство объекта ГогтѴаІШіІу, 954 




1058 


Алфавитный указатель 


гапяеІІпсІегПоѵѵ, свойство объекта ГоигіѴаІісіііу, 
954 

геасІАзАггауВиНегО, метод 

ЕіІеКеайег, объект, 740, 741, 948 
ГіІеКеайегЗупс, объект, 949 
геасІАзВіпагуЗігіпяО, метод 
ГіІеКеайег, объект, 740, 948 
ГіІеКеасІегЗупс, объект, 949 
геаёАзВаіаШЩ), метод 

ЕіІеКеаёег, объект, 740, 948 
ГіІеКеасІегЗупс, объект, 949 
геасІАзТехіО, метод 

ГіІеКеасІег, объект, 740, 741, 948 
ГіІеКеайегЗупс, объект, 949 
геасЮпІу, свойство объекта Іприі, 966 
геабуЗіаіе, свойство 

Ооситепі, объект, 351, 498, 917 
ЕѵепіЗоигсе, объект, 943 
ГіІеКеасІег, объект, 740, 947 
МесІіаЕІетепі, объект, 662, 990 
^ѴеЬЗоскеі, объект, 1021 
ХМЬНіірКеяиезі, объект, 532,1035 
значения, 532 

геасІузіаіесЬапве, событие, 498, 532 
гесі(), метод объекта Сапѵа8Кепс1егіп&СопІехі2В, 
687, 902 

гесіисе(), метод объекта Аггау, 178, 215, 772 
ге<1исеКібМ(), метод объекта Аггау, 178, 773 
КеіегепсеЕггог, объект, 80, 856 
геіеггег, свойство объекта Боситепі, 437, 917 
КевЕхр, класс, 50 
ІоЗігіп^О, метод, 72 
КевЕхр, объект, 60, 276, 287, 857 
ехес(), метод, 858 
&1оЪа1, свойство, 859 
ідоогеСазе, свойство, 860 
ІазІІпсіех, свойство, 860 
зоигсе, свойство, 860 
іезі(), метод, 861 
Іо8ігіп&(), метод, 861 
как вызываемый объект, 214 
методы поиска по шаблону, 288 
свойства экземпляра, 858 
Ке&Ехр(), конструктор, 277, 287 
ге&ізіегСопіепіНапс11ег(), метод объекта 
Каѵі&аіог, 997 

ге&ізіегРгоіосо1Напс11ег(), метод объекта 
Каѵі^аіог, 997 

геІаіесіТагзеі, свойство объекта Еѵепі, 484, 578, 
939 

геіілзі, свойство объекта Ьіпк, 985 
ге1оас1(), метод объекта Ьосаііоп, 373, 987 
гетоѵе(), метод 

БОМТокепЫві, объект, 470, 925 
І(}иегу, объект, 574 
НТМЬОрііопзСоІІесііоп, объект, 961 
Зеіесі, элемент, 1009 
гетоѵеАііг(), функция, 565 
гетоѵеАіігіЪиіеО» метод объекта Еіетепі, 407,930 
гетоѵеАіігіЪиіе1Я8(), метод объекта Еіетепі, 930 
гетоѵеСЬіШО, метод объекта Кобе, 415,1001 
гетоѵеСІаззО, метод объекта і(}иегу, 567 
гетоѵеБаіа(), метод объекта і<}иегу, 571 
гетоѵеЕѵепіІлзіепег(), метод 
Боситепі, объект, 492 
ЕѵепіТаг&еі, объект, 945 


^УогкегСІоЪаІЗсоре, объект, 724 
ЛѴогкег, объект, 722 

гетоѵеІіет(), метод объекта Зіога&е, 1010 
гереаі, свойство объекта Еѵепі, 942 
гер1асе(), метод 

Ьосаііоп, объект, 372, 987 
8 ІГІП&, объект, 285, 869 
гер1асеА11(), метод объекта іС^иегу, 572 
гер1асеСЬі1б(), метод объекта Кобе, 415,1001 
герІасеБаіаО, метод 
Соттепі, узел, 905 
Техі, объект, 1015 

гер1асе8іаіе(), метод объекта Нізіогу, 713, 959 
гер1асё\УііЬ(), метод объекта і(}иегу, 572 
геяиігеб, свойство объекта Іприі, 966 
гезеі(), метод объекта Еогт, 433, 951 
гезіге, событие окон, 483 
гезігеО, метод объекта і(}иегу, 575 
гезропзе, свойство объекта ХМЬНіірКесріезі, 1035 
гезропзеТехі, свойство объекта ХМЬНіірКециезі, 
535, 1035 

декодирование ответа, 534 
гезропзеТуре, свойство объекта ХМЬНіірКеяиезі, 
1035 

гезропзеХМЬ, свойство объекта 
ХМЬНіірКеяиезі, 534, 535,1036 
гезіоге(), метод объекта 
Сапѵа8Непбегіп^Соп1ех120, 691, 902 
гезиіі, свойство 

Еѵепі, объект, 577, 579 
ЕіІеНеабег, объект, 740, 947 
геіигп, инструкция, 83,127,188 

использование в конструкторах, 192 
использование в функциях-генераторах, 304 
геіиггіѴаІие, свойство 

ВеіогеІІпІоасІЕѵепі, объект, 886 
Еѵепі, объект, 497 
^Ѵіпболѵ, объект, 1024 
геѵегзе(), метод объекта Аггау, 172, 774 
г еѵокеОЬі есШ КЬ(), метод объекта ІШЬ, 739,1019 
НОВА, формат определения цвета, 458 
Шііпо, интерпретатор, 314 

поддержка расширений баѵаЗсгірі, 290 
поддержка расширения Е4Х (ЕСМАЗсгірі Іог 
ХМЬ), 310 

создание графического интерфейса (пример), 
319 

гі&Ьі, свойство объекта СІіепіНесі, 904 
гі&Ьі и Ьоііот, свойства стиля, 456, 457 
го1аіе(), метод объекта 
СапѵазКепбегіпвСопіехі2В, 681, 902 
гоіаііоп, свойство, 488 
гоипбО, функция, объект МаіЬ, 829 

ГОѴѴ8, СВОЙСТВО 

ТаЫе, объект, 1012 
ТаЫеЗесііоп, объект, 1014 
гоѵѵіпбех, свойство объекта ТаЫеНоѵѵ, 1013 
гоѵѵЗрап, свойство объекта ТаЫеСеІІ, 1013 
К8Н (Кеаііу Зітріе Нізіогу - действительно про¬ 
стое управление историей), библиотека, 374 
гиіез, свойство вместо сззНиІез, 473 

$ 

\\з, метасимвол в регулярных выражениях, 279 
\\8, непробельный символ Шісосіе, 279 
Заіагі, веб-броузер, 504 
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іехііприі, событие, 486 
текущая версия, 355 
запёЬох, свойство объекта ІРгате, 961 
заѵе(), метод объекта СапѵазКеп(1егіп&Сопіехі2В, 
691, 902 

зса1е(), метод объекта СапѵазНепсіегіп^Соп1ехі2В, 
681,902 

зсаіе, свойство, 488 
зсоресі, свойство объекта 8іу1е, 1011 
Зсгееп, объект, 377,1006 
аѵаіІНеі&Ьі, свойство, 377 
аѵаіПУісШі, свойство, 377 
Ьеі^Ы, свойство, 377 
лѵісШі, свойство, 377 

зсгееп, свойство объекта ЛѴіпйоѵѵ, 377,1024 
зсгеепХ и зсгеепУ, свойства 
Еѵепі, объект, 940 
ЛѴіпсіоѵѵ, объект, 1024 
<зсгірі>, элемент, 335 

сіеіег и азупс, атрибуты, 346 
зге, атрибут, 339 
іуре, атрибут, 341 

встраивание Лаѵа8сгірі в НТМЬ, 23, 338 
как транспорт в архитектуре Аіах, 525 
работа с протоколом НТТР, 535 
текстовое содержимое, 411 
удаление угловых скобок для предотвращения 
нападений по методике межсайтового скрип¬ 
тинга, 366 
8 сгірі, объект, 1007 

8 сгіріаси1оиз, библиотека из фреймворка 
Ргоіоіуре, 368, 467 

зегіріз, свойство объекта Боситепі, 396, 917 
зсгоН, свойства элементов документа, 426 
8 сго11(), метод 

І(}иегу, объект, 575 
ЛѴіпсіоѵѵ, объект, 425,1028 
зсгоНВуО, метод объекта ЛѴіпсіоѵѵ, 425,1028 
зсгоННеі^Ы и зсгоІПУісШі, свойства объекта 
Еіетепі, 928 

зсго11ІпіоѴіелѵ(), метод объекта Еіетепі, 931 
зсгоІІЬеІі и зсгоІІТор, свойства объекта Еіетепі, 
422,928 

зсго11Ье?і(), метод объекта і(}иегу, 570 
зсгоПТоО, метод объекта ЛѴіпсіоѵѵ, 425,1028 
зсгоПТорО, метод объекта і(}иегу, 570 
зеа1(), функция, 160, 851 
зеатіезз, свойство объекта ІРгаше, 962 
зеагсЬ, свойство 
Ілпк, объект, 985 
Ьосаііоп, объект, 371, 987 
ЛУогкегЬосаііоп, объект, 1033 
зеагсЬ(), метод объекта 8ігіп&, 285, 871 
весііоп Коѵѵіпйех , свойство объекта ТаЫеНоѵѵ, 1013 
зесиге, атрибут соокіез, 637 
зеекаЫе, свойство объекта МебіаЕІетепі, 661,990 
зеекіп&, свойство объекта МеёіаЕІетепі, 990 
8е1есі, объект, 1007 
8е1есі, элемент, 435 
зе1есі(), метод 

Іприі, объект, 966 
І(}иегу, объект, 575 
ТехіАгеа, объект, 1016 
зеіесіеб, свойство объекта Орііоп, 436,1002 
зеіесіеёішіех, свойство 

НТМЬОрііопзСоІІесііоп, объект, 960 


8е1есі, элемент, 436,1008 
зе1есіе<Юрііоп, свойство объекта Іприі, 966 
зеІесіесЮрііопз, свойство объекта 8е1есі, 1008 
8е1есііоп, объект, 440 
зеІесііопЕшІ, свойство 
Іприі, объект, 966 
ТехіАгеа, объект, 1016 
зе1есііоп8іагі, свойство 
Іприі, объект, 966 
ТехіАгеа, объект, 1016 
зеіесіог, свойство объекта і(}иегу, 562 
веІесіогТехі, свойство объекта С88Ки1е, 909 
зеіі, переменная, использование во вложенных 
функциях, 192 
зеіі, свойство 

\Ѵіпсіо\ѵ, объект, 1025 
\ѴогкегС1оЬа18соре, объект, 1031 
зепбО, метод 

■\УеЬ8оскеі, объект, 1021 
ХМЬНіірНеяиезі, объект, 530,1037 
генераторов, 306 
зегіаІігеО, метод, 599 
8 егѵег-8епі Еѵепіз, стандарт, 550 

имитация объекта Еѵепі8оигсе с помощью 
объекта ХМЬНіірКеяиезі, 552 
простой клиент чата на основе объекта 
Еѵепі8оигсе, 551 
сервер чата, 554 

зеззіопЕіога^е, свойство объекта ^Ѵіпёолѵ, 630, 
1025 

прикладной программный интерфейс объекта 
8 іогадо, 632 
события, 633 

срок хранения и область видимости, 630 
зеі(), метод типизированных массивов, 729,1019 
зеіАіігіЬиіе(), метод объекта Еіешепі, 406,931 
зеіСаріиге(), метод (ІЕ), 501 
зеШаіа(), метод объекта БаіаТгапзІег, 509, 913 
зеШаіеО, метод объекта Баіе, 790 
8 еШгаяІта&е(), метод объекта БаіаТгапзІег, 509, 
913 

зеіР1оаі32(), метод объекта БаіаѴіеѵѵ, 914 
зеіР1оаі64(), метод объекта БаіаѴіеѵѵ, 914 
зеіРи11Уеаг(), метод объекта Баіе, 791 
зеіНоигзО, метод объекта Баіе, 791 
зе1Іпі8(), метод объекта БаіаѴіеѵѵ, 914 
зеіІпі16(), метод объекта БаіаѴіеѵѵ, 914 
зеіІпі32(), метод объекта БаіаѴіеѵѵ, 914 
зеіІпіегѵа1(), метод 

^Уіпсіолѵ, объект, 370,1028 
^УогкегС1оЪа18соре, объект, 1032 
зеіІпіегѵа1(), функция, 323, 349 

использование в злонамеренном коде, 367 
зеіІіет(), метод объекта 8іога&е, 1010 
зеіМіНівесопбзО, метод объекта Баіе, 792 
зеіМіпиіез(), метод объекта Баіе, 792 
зеіМопіЬО, метод объекта Баіе, 792 
зеіНеяиезіНеабегО, метод объекта 
ХМЬНіірНеяиезі, 530,1038 
зеі8есоп(І8(), метод объекта Баіе, 793 
зеі8е1есііопКап&е(), метод 
Іприі, объект, 966 
ТехіАгеа, объект, 1016 
зеіТітеО, метод объекта Баіе, 793 
зеіТітеоиіО, метод 

\Ѵіпсіо\ѵ, объект, 334, 370,1028 
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\ѴогкегС1оЪа18соре, объект, 1032 
зеіТітеоиіО, функция, 323, 349 

ограничение времени ожидания выполнения 
запроса объектом ХМЬНіірКедиезі, 544 
зеіТгапзІогтО, метод объекта 
СапѵазКеп<1егіпвСоп1ехі20, 681, 683, 903 
зеіІЛп18(), метод объекта ОаіаѴіеѵѵ, 914 
зеШіпі16(), метод объекта БаіаѴіе\ѵ, 914 
зеШіпі32(), метод объекта БаіаѴіе\ѵ, 914 
зеШТСОаіе(), метод объекта Баіе, 793 
зеШТСГи11Ѵеаг(), метод объекта Е)аіе, 794 
8 еШТСНоигз(), метод объекта Баіе, 794 
зеШТСМШізесопйзО, метод объекта Баіе, 795 
зеШТСМіпиіез(), метод объекта Баіе, 795 
зеШТСМопіЬ(), метод объекта Баіе, 795 
зеШТСВесопбзО, метод объекта Баіе, 796 
зеіѴегзіопО, метод объекта ІпсІехесШВ, 750 
зеіѴеагО, метод объекта Баіе, 796 
зЬасіоѵѵВІиг, свойство, 695, 896 
зЬасІоѵѵСоІог, свойство, 695, 896 
зЬаёолѵОНзеіХ и зЬаёолѵОНзеІѴ, свойства, 695 
СапѵазКеп<1егіп&Соп1ехі2В, объект, 896 
зЬееі, свойство объекта Ілпк, 985 
зЬееі, свойство объекта 8іу1е, 1011 
зЬі?1(), метод объекта Аггау, 169,175, 774 
зЬШКеу, свойство, 500, 519 
Еѵепі, объект, 940 
событий мыши, 483 
зЬолѵ(), метод объекта іС^иегу» 588, 591 
зЬоѵѵМосіаШіаІо^О, метод объекта ЛѴіпсіоѵѵ, 378, 
1028 

зіЫіпв, свойства объекта Еіетепі, 402 
8 іЫіп&8(), метод объекта і(}иегу, 620 
зіп(), функция, объект МаіЬ, 829 
зіге, свойство 

ВІоЬ, объект, 887 
Іприі, объект, 966 
8 Іісе(), метод 

Аггау, объект, 174, 775 
ВІоЬ, объект, 732, 887 
І(}иегу, объект, 618 
81гіп&, объект, 871 

8 ІісіеВо\ѵп(), 8Ііс1еІІр() и з1ісіеТо^1е(), методы 
объекта і(}иегу, 589 
8 оте(), метод объекта Аггау, 178, 775 
зогі(), метод объекта Аггау, 173, 776 
функции как аргументы, 200 
<8оигсе>, элемент, 658 
зоигсе, свойство 

Мезза&еЕѵепі, объект, 717, 994 
Ке^Ехр, объект, 287, 858, 860 
зрагкііпе, встроенные диаграммы, 408, 704 
зрееб, свойство объекта Сеосоопііпаіез, 955 
8 рі(1егтопкеу, интерпретатор 

поддержка расширений ЛаѵаЗсгірі, 290 
поддержка расширения Е4Х (ЕСМА8сгірі іог 
ХМЬ), 310 

присваивание с разложением, 298 
зр1ісе(), метод объекта Аггау, 174, 777 
зр1іі(), метод 

8 ІГІП&, объект, 287, 872 
разбиение содержимого соокіе на пары 
имя/значение при его анализе, 638 
зр1ііТехі(), метод объекта Техі, 1015 
8(}КТ1_2, константа (объект МаіЬ), 830 
8()КТ2, константа (объект МаіЬ), 830 


зяП(), функция, объект МаіЬ, 829 
зге, атрибут элемента <зсгірі>, 339 
зге, свойство 

ІЕгате, объект, 962 
Іта&е, объект, 963 
МеёіаЕІетепі, объект, 990 
8 сгірі, объект, 1007 
згебое, свойство объекта ІЕгате, 962 
згсЕІетепі, свойство объекта Еѵепі, 940 
зіагі(), метод 

МеззадоРогі, объект, 994 
ТітеНап^ез, объект, 1017 
зіагіОІІзеіТіте, свойство объекта МейіаЕІетепі, 
990 

зіаіе, свойство 

Нізіогу, объект, 713 
РорВіаіеЕѵепі, объект, 1004 
зіаіиз, свойство 

АррІісаііопСасЬе, объект, 649 
ХМЬНіірКеяиезі, объект, 1036 
зіаіизТехі, свойство объекта ХМЬНіірКеяиезі, 
1036 

зіер, свойство объекта Іприі, 966 
зіерБоѵгпО, метод объекта Іприі, 967 
зіерМізтаісЬ, свойство объекта ГогтѴаІісІііу, 954 
зіерІГрО, метод объекта Іприі, 967 
зіор(), метод объекта і(}иегу, 593 
зіорІтте<1іаіеРгора&аііоп(), метод объекта Еѵепі, 
498, 941 

81орІ1егаііоп, исключение, 301 

возбуждение методом пехі() генераторов, 304 
зіорРгорадаііопО, метод объекта Еѵепі, 497, 941 
8 іога&е, объект, 1009 

зіога&еАгеа, свойство объекта Зіога^еЕѵепі, 1010 
8 іога&еЕѵепі, объект, 1010 
8 ігіп&, объект, 862 
сЬагАіО, метод, 864 
сЬагСос!еАі(), метод, 864 
сопсаі(), метод, 865 
ІготСЬагСосІеО, метод, 515, 865 
НТМЬ-методы, 863 
іпбехОІО, метод, 866 
1 азіІп<1ехО?(), метод, 866 
Іеп&іЬ, свойство, 867 
1оса1еСошраге(), метод, 96, 867 
таісЬ(), метод, 868 
гер1асе(), метод, 869 
зеагсЬ(), метод, 871 
з1ісе(), метод, 871 
зр1іі(), метод, 872 
зиЬзігО, метод, 874 
зиЪзігіп&О, метод, 874 
іоЬоса1еЬолѵегСазе(), метод, 875 
іоЬосаІеІІррегСазеО, метод, 875 
іоЬолѵегСазе(), метод, 96, 876 
іо8ігіп&(), метод, 876 
іоІІррегСазе(), метод, 96, 876 
ігіш(), метод, 876 
ѵа1иеОІ(), метод, 877 
методы, 862 

статические, 863 
81гіп&(), конструктор, 64 
8 ігіп&(), функция, преобразование типов, 69 
зігіп^ііуО, функция, 161, 820 
зігоке(), метод объекта 
СапѵазКеп<1егіп&Сопіехі2В, 675, 691, 903 
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8 ігокеКесі(), метод объекта 
СапѵавКешІегіпвСопІехгёБ, 687, 903 
вігокеЗіуІе, свойство объекта 
Сапѵа8Кеп<1егіпвСопіехі2Б, 678, 896 
вігокеТехі(), метод объекта 
Сапѵа8Кеп<1егіп#Сопіехі2П, 692, 903 
<8іу1е>, элемент, включение таблиц стилей, 446 
Біуіе, атрибут, 31 
8 іу1е, объект, 1011 
Біуіе, свойство, 334 
С88Ки1е, объект, 909 
Еіешепі, объект, 334, 928 
віуІеЗЬееіз, свойство объекта Боситепі, 473, 917 
БиЬаггауО, метод типизированных массивов, 730, 
1019 

8 иЪтіі(), метод 

Гогт, объект, 432, 951 
ІС^иегу, объект, 575 

возбуждение событий, 582 
8 иЪтіі() и гевеі(), методы объекта Гогт, 432 
8 иЪаіг(), метод объекта 8ігіп#, 874 
виЬвігіп^О, метод объекта 8ігіп#, 874 
виЬвігіп^ЬаіаО, метод 
Соттепі, узел, 905 
Техі, объект, 1015 
виррогі, свойство, 613 
<8ѵ&:раіЬ>, элемент, 669 

8 ѴС (8са1аЫе Ѵесіог СгарЬісв - масштабируемая 
векторная графика), формат, 665 
круговая диаграмма в формате 8ѴС, построен¬ 
ная ЛаѵаЗсгірі-сценарием, 667 
отображение времени посредством манипули¬ 
рования 8ѴС-изображением, 670 
8 ѵгарСасЬе(), метод объекта АррІісаііопСасЬе, 649, 
883 

бѵгіісЬ, инструкция, 117 
саве, конструкция, 117 
ЗупіахЕггог, объект, 877 

ошибка при удалении свойств в строгом 
режиме, 148 

БуБіетН, свойство объекта БоситепіГгаятепі, 
922 

Т 

ТаЫе, объект, 1011 
ТаЫеСеІІ, объект, 1013 
ТаЫеКоѵг, объект, 1013 
ТаЫеЗесііоп, объект, 1014 
іа^ате, свойство объекта Еіешепі, 928 
іап(), функция, объект МаіЬ, 830 
іаг&еі, свойство 
Еѵепі, объект, 940 

в библиотеке іС^иегу, 578 
Гогт, объект, 431, 951 
Ргосе88ІпвІп8ігисііоп, объект, 1004 
событий, 477 

іВогііеа, свойство объекта ТаЫе, 1012 
іегшіпаіе(), метод объекта \Ѵогкег, 722 
іе8і(), метод объекта Ке^Ехр, 289, 858, 861 
Техі, объект, 1014 

Техі и Техіагеа, элементы форм, 432 
іехі, свойство 

Ьіпк, объект, 986 
Орііоп, объект, 436,1003 
8 сгірі, объект, 1007 
Техі, узлы, 402 


как содержимое элементов, 411 
создание, 413 

іехі(), метод объекта і(}иегу, 568 
іехі-БІіайоѵг, свойство, 454 « 

іехіАНдо, свойство объекта 
Сапѵа&Кеп<1егіпвСопіехі2Б, 692, 896 
ТехіАгеа, объект, 1015 
іехіВаБеІіпе, свойство объекта 
СапѵавКеп<1егіп#Сопіехі2П, 692, 896 
іехіСопіепі, свойство объекта Кобе, 410, 999 
іехіЬеп^іЬ, свойство объекта ТехіАгеа, 1016 
ТехіМеігісБ, объект, 693, 901,1016 
ТехіКап^е, объект (ІЕ), 440 
іГооі, свойство объекта ТаЫе, 1012 
Шеад, свойство объекта ТаЫе, 1012 
іЬіб, ключевое слово 
в вызовах методов, 191 
в обработчиках событий, 433 
в функциях, используемых как методы, 191 
использование методов чтения и записи 
свойств, 153 

как первичное выражение, 80 
контекст вызова функции, 185 
ограничение на использование в безопасных 
подмножествах, 292 
ссылка на глобальный объект, 64 
ссылка на целевой объект в обработчиках 
событий, 493 
іЬгоѵг, инструкция, 128 
іЬгоѵгО, метод генераторов, 306 
ііте(), метод объекта Сопвоіе, 907 
іітеЕшІО, метод объекта Сопвоіе, 907 
іішеоиі, параметр объекта Сеоіосаііоп, 956 
іішеоиі, свойство объекта X МЬНіірКеяиеві , 544, 
1036 

ТітеНап^ев, объект, 661,1016 
ііше8іатр, свойство объекта Еѵепі, 578, 940 
іітевіашр, свойство объекта Сеоровіііоп, 957 
ііііе, свойство 

С888іу1е8Ьееі, объект, 472, 911 
Иоситепі, объект, 437, 917 
Еіешепі, объект, 928 
Ьіпк, объект, 986 
8 іу1е, объект, 1011 
іоАггауО, метод объекта іС^иегу, 562 
іоБаіаІІКЬ(), метод объекта Сапѵав, 698, 889 
іоБаіеВігіп^О, метод объекта Баіе, 796 
іоЕІешепі, свойство объекта Еѵепі, 940 
іоЕхропепііа1(), метод объекта №шЬег, 70, 834 
іоГіхе<1(), метод объекта №тЬег, 70, 835 
іовд1е(), метод 

БОМТокепЬіві, объект, 470, 925 
ІС^иегу, объект, 576, 588 
іодо1еС1а88(), метод объекта іС^иегу, 567 
іоСМТ8ігіп&(), метод объекта Баіе, 797 
іоІ808ігіп&(), метод объекта Баіе, 797 
іоЛ80І"І(), метод, 163 
Баіе, объект, 797 
реализация в классах, 243 
іоЬоса1еБаіе8ігіпв(), метод объекта Баіе, 798 
іоЬосаІеЬоѵгегСавеО, метод объекта 8ігіп& 875 
іоЬоса1е8ігіп#(), метод, 163 
Аггау, объект, 176, 778 
Баіе, объект, 798 
№тЬег, объект, 836 
ОЬіесі, класс, 851 
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реализация в классах, 243 
ІоЬосаІеТітеВігіпвО, метод объекта Баіе, 799 
іоЬосаІеІІррегСааеО, метод объекта 8ігіп#, 875 
іоЬоѵгегСаае(), метод объекта 8ігіп#, 876 
іооЬоп#, свойство объекта ГогтѴаІігіііу, 954 
іор, Іеіі, ѵгійіЬ и Ьеі#Ьі, свойства стиля, 456, 457 
іор,свойство 

СІіепіКесі, объект, 904 
\Ѵішклѵ, объект, 386,1025 
іоРгесіаіоп(), метод объекта №шЬег, 70, 836 
іо8ігіп#(), метод, 162 
Аггау, объект, 176, 778 
Вооіеап, объект, 780 
Баіе, объект, 799 
Еггог, объект, 804, 806 
Гипсііоп, объект, 814 
Ьосаііоп, объект, 371 
№шЬег, объект, 69, 837 
ОЪіесі, класс, 852 
Ке&Ехр, объект, 861 
8е1есііоп, объект, 440 
8 ігіпв, объект, 876 
определение класса объекта, 159 
преобразование логических значений в строки, 
62 

преобразование типов, 71 
реализация в классах, 242 
функций,213 

іоіаі, свойство объекта РгоягеааЕѵепі, 542,1006 
іоТіте8ігіп&(), метод объекта Баіе, 799 
іоІІррегСааеО, метод объекта 8ігіп#, 876 
іоІІТС8ігіп^(), метод объекта Баіе, 800 
ігасе(), метод объекта Сопаоіе, 907 
ігапаІогтО, метод объекта 
Сапѵа8Кеп<1егіпвСопіехі2Б, 683, 903 
ігапа1аіе(), метод объекта 
Сапѵа8Кеп<1егіпвСопіехі2Б, 681 
ігівдег(), метод объекта іС^иегу, 577, 582 
ІгівдегНаш11ег(), метод объекта іС^иегу, 584 
ігіт(), метод объекта 8ігіп#, 876 
ігіт(), функция, 613 
ігу/саісЬ/ііпаІІу, инструкция, 129 
множественные блоки саісЬ, 309 
ТѴіііег, сайт, модуль поиска с помощью метода 
ро8ІМе88а^е(), 718 
іуре, атрибут элемента <асгірі>, 341 
іуре, свойство 
ВІоЬ, объект, 887 
С88Ки1е, объект, 909 
С888іу1е8Ьееі, объект, 911 
Еѵепі, объект, 940 
ГогшСопігоІ, объект, 952 
Всгірі, объект, 1007 
8е1есі, элемент, 436 
8 іу1е, объект, 1011 
событий, 477 

элементов форм, 429, 430, 432 
ТуреЕггог, объект, 64, 878 

возбуждение ошибки при преобразовании 
типов, 69 

как результат попытки удалить свойство, 147 
ошибка при попытке создать или изменить 
свойства, 156 

ошибки доступа к свойствам, 146 
іуреМіатаісЬ, свойство объекта ГогтѴаІкІііу, 954 
іуреоі, оператор, 85,105, 232 


и объекты ХМЬ, 310 

применение к значениям пиіі и ітёейпеё, 62 
іуреа, свойство объекта БаіаТгапаіег, 511, 912 

КУ 

ІЛпі8 Аггау, класс, 728,1017 
ІЛпіІбАггау, класс, 728,1017 
ІЛпі32 Аггау, класс, 728,1017 
ипЬіпдО, метод объекта іС^иегу, 581 
ишіеііпей, значение, 62, 63 
возвращаемое функцией, 188 
и выражения обращения к свойствам, 82 
свойства, ошибка доступа, 146 
ишіе1е^аіе(), метод объекта іС^иегу, 585 
ішевсареО, функция, 879 
ипіоаб, событие, 482 

Веіогеііпіоаб Еѵепі, объект, 886 
ііптопі1огЕѵепІ8(), метод объекта 
Соп8о1еСотташ11лпе, 908 
ипаЬШО, метод объекта Аггау, 175,176, 779 
итѵгарО, метод объекта і(}иегу, 574 
ирйаіеО, метод объекта АрріісаііопСасЬе , 649,884 
иріоай, свойство объекта ХМЬНіірКеяиеаі, 542, 
1036 

ІШІЕггог, объект, 879 

1 ІШ (Шііогт Кеаоигсе НепіШег - унифициро¬ 
ванный идентификатор ресурса), 801 
сіесосіеілио, функция, 801 
<1есо<1еІЛиСотропеп1(), функция, 802 
епсобеШЭД), функция, 802 
епсо(іеІЛиСотропепі(), функция, 803 
ТШЬ-адреса 

ІІКЬ, объект, 1019 
анализ, 371 

аргументы функции ітрог!8сгірІ8(), 722 
веб-сокетов, 756 
двоичных объектов, 739 
относительные, 373 

шаблонные, в объявлениях кэшируемых 
приложений, 645 
ІІКЬ, объект, 1019 
игі, свойство 

Еѵеп18оигсе, объект, 943 
8 іога&еЕѵепі, объект, 1011 
\ѴеЪ8оскеі, объект, 1021 
ІІКЬ, свойство 

Боситепі, объект, 437, 917 
ТѴіпбоѵг, объект, 1025 
ивегА^епі, свойство 

Каѵідаіог, объект, 375, 996 
\ѴогкегКаѵі#аіог, объект, 1034 
ивегОаіа АРІ, 628 
иве 8Ігіс1, директива, 133 

ІІТС (ІІпіѵегааІ Соогёіпаіеё Тіте - универсальное 
скоординированное время), 781 
ІГГС(), метод объекта Баіе, 800 

V 

ѵа1(), метод объекта і(}иегу, 567 
ѵаіід, свойство объекта РогтѴаІібііу, 954 
ѵаІійаііопМеааа^е, свойство объекта ГогшСопігоІ, 
952 

ѵаіібііу, свойство объекта ГогшСопігоІ, 952 
ѵаіие, атрибут (свойств), 154 
ѵаіие, свойство 

БОМбеііаЫеТокепІлві, объект, 924 
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Гііеііріоай, объект, ограничение возможностей 
из соображений безопасности, 362 
ГогтСопігоІ, объект, 952 
Меіег, объект, 995 
Орііоп, объект, 1003 
Рго^гевв, объект, 1005 
элементов форм, 431, 432 
ѵаІиеАвБаіе, свойство объекта Іприі, 966 
ѵаІиеАвКишЬег, свойство объекта Іприі, 966 
ѵаІиеМізаіп#, свойство объекта ГогтѴаІісІііу, 954 
ѵа1ие01(), метод, 163 
Вооіеап, объект, 780 
Баіе, объект, 801 
№тЬег, объект, 838 
ОЬіесі, класс, 853 
8 ігіп&, объект, 877 
преобразование типов, 72 
реализация в классах, 243 
ѵа1иеа(), метод объекта СопвоІеСотташІІлпе, 908 
ѵаг, инструкция, 112 
ѵаг, ключевое слово, 74 
<ѵі<1ео>, элемент, 658 
сопігоів, атрибут, 658 
события, 486 
Ѵісіео, объект, 1019 

ѵі<1еоНеі#Ьі и ѵісІео\ѴісІіЬ, свойства объекта 
Ѵісіео, 1020 

ѵіе\ѵ, свойство объекта Еѵепі, 940 
ѵоід, оператор, 85,108 

принудительная подстановка значения 
ипйеііпей, возвращаемого выражением, 343 
ѵоіите, свойство 

МейіаЕІетепі, объект, 990 
управление воспроизведением, 660 

ѴѴ 

\\\Ѵ (неслово, метасимвол), 279, 283 
\\ѵг (слово, метасимвол), 279, 283 
\ѴЗС, консорциум 

стандарт ХМЬНІІрКедиеаі Ьеѵеі 2 (ХНК2), 527 
\ѴАІ-АКІА, стандарт, 361 
ѵгагп(), метод объекта Сопаоіе, 907 
ѵгааСІеап, свойство объекта СІоаеЕѵепі, 904 
\ѵаісЬРоаіііоп(), метод объекта Сеоіосаііоп, 708, 
956 

АѴеЪСЬ, прикладной интерфейс, 673 
ѵгеЪкіШКЬ.геѵокеОЪіесШКЦ), метод, 739 
АѴеЪВоскеі, объект, 1020 
\ѴеЬ8оскеі АРІ, спецификация, 755 
\ѴеЪ Зіога^е АРІ, 627 
спецификация, 488 
\ѴеЬ \Ѵогкег8, спецификация, 720 
\Ѵогкег, объект, 721 

«\ѴеЪ \Ѵогкега», фоновые потоки выполнения, 349 
лѵЬееШеІіа, свойства, 505 
лѵЬееШеІіа, свойство объекта Еѵепі, 940 
лѵЬееШеІіаХ и ѵѵЬееШеІіаѴ, свойства объекта 
Еѵепі, 940 

лѵЬісЬ, свойство объекта Еѵепі, 483, 578, 941 
ѵгЬіІе, циклы, 119 

сопііпие, инструкция, 127 
ѵгЬоІеТехі, свойство объекта Техі, 1014 
ѵгійіЬ, свойство 

СІіепіКесі, объект, 904 
ІГгате, объект, 962 
Іта^еБаіа, объект, 964 


Іта&е, объект, 963 
8 сгееп, объект, 377 
ТехіМеігіса, объект, 1016 
ѵгісііЬ и Ьеі^Ьі, свойства 
Сапѵаа, объект, 888 
8 сгееп, объект, 1006 
Ѵібео, объект, 1020 
объекта контекста холста, 679 
ѵгібіЬ и Ьеі^Ьі, свойства стиля, 456, 457 
ѵгі<1іЬ(), метод объекта і(}иегу, 569 
ѵгіНѴаІісІаіе, свойство объекта РогтСопігоІ, 953 
АѴішіоѵг, объект, 63,1022 
а1егі(), метод, 377 
аррІісаііопСасЬе, свойство, 646 
с1о8е<1, свойство, 385 
сопіігтО, метод, 377 
(ііаІо^Аг^итепіа, свойство, 378 
(Іоситепі, свойство, 334, 390 
БОМСопІепІЬоайед, событие, 498 
еѵепі, свойство, 493 
Ігатеа, свойство, 386 
ІгатеЕІетепі, свойство, 386 
^еіСотриіе(і8іу1е(), метод, 468 
&еі8е1есііоп(), метод, 440 
Ьіаіогу, свойство, 373 
Іеп^іЬ, свойство, 387 
1оа<1, событие, 498 

1оса18іога#е и аеааіопВіогаяе, свойства, 630 
Іосаііоп, свойство, 371 
пате, свойство, 383 
паѵідаіог, свойство, 374 
опЬеІогеипІоай, обработчик события, 495 
опеггог, свойство, 349, 379, 482 
опЬааЬсЬап^е, свойство, 711 
опіоаб, обработчик события, 335 
ореп(), метод, 343, 383 
орепег, свойство, 385 
ро8іМе88а&е(), метод, 716 

модуль поиска на сайте Тѵгіііег, 718 
рготрі(), метод, 377 
гоіаііоп, свойство, 488 
всаіе, свойство, 488 
гсгееп, свойство, 377,1006 
8Сго11(), метод, 425 
8Сго11Ву(), метод, 425 
8Сго11То(), метод, 425 
геіІпіегѵаІО, метод, 370 
&еіТітеоиі(), метод, 370 
&ЬоѵгМо<іаШіа1о&(), метод, 378 
аіога^е, событие, 488 
іор, свойство, 386 
ІШЬ, свойство, 1019 
конструкторы, 1025 
методы, 1025 
обработка ошибок, 379 
обработчики событий, 1028 
свойства, 1023 
события, 482 

Ьеіогергіпі и аііегргіпі, 488 
оШіпе и опііпе, 487 

средоточие всех особенностей и прикладных 
интерфейсов клиентского ЛаѵаВсгірі, 333 
ѵгіпсіоѵг, свойство объекта \Ѵіпсіоѵг, 334,1025 
\Ѵіп(іоѵгРгоху, объект, 389 
ѵгііЬ, инструкция, 131 
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ограничение на использование в безопасных 
подмножествах, 292 
\ѵііЬСге<1епііаІ8, свойство объекта 
ХМЬНМрКедиеаі, 546,1036 
АУогкег, объект, 721, 1029 

дополнительные особенности, 724 
обработчики событий, 1030 
■\Ѵогкег(), конструктор, 725 
\ѴогкегС1оЬа18соре, объект, 722, 1031 
свойства, 723 

\ѴогкегЬосаііоп , объект, 1032 

\ѴогкегКаѵі^аіог, объект, 1033 

ѵггар(), метод объекта і(}иегу, 574 

ѵггарА11(), метод объекта і(}иегу, 574 

ѵггарІппег(), метод объекта і(}иегу, 574 

ѵггііаЫе, атрибут (свойств), 154,155 

ѵггііеО, метод объекта Боситепі, 346, 351, 438, 921 

ѵггііеГі1е(), функция, 326 

ѵггііеГі1е8упс(), функция, 326 

ѵггііе1п(), метод объекта Боситепі, 439, 921 

лѵв:// или ѵгав://, протоколы, 756 

X 

ХНК2, стандарт, 527 
РогпШаіа, объект, 540 
іітеоиі, свойство, 544 
ХНТМЬ, язык разметки 
<8сгірі>, элемент, 338 

встраивание 8ѴС-графики в документы, 666 
чувствительность к регистру, 41 
ХМЬ, необязательное использование при работе 
с протоколом НТТР, 527 
ХМЬ, объект, 310 
ХМЬ, формат данных 

выполнение Р08Т-запросов с данными 
в формате ХМЬ, 538 

ХМЬННрКедиеві, объект, 337, 526, 1034 
НТТР-запросы и ответы, 529 
гевропаеТехі, свойство, 534 
геаропаеХМЬ, свойство, 534 
выполнение запроса, 529 
выполнение синхронных запросов в фоновых 
потоках выполнения, 726 
и локальные файлы, 529 
имитация в виде объекта ідХНК в і<3иегу 1.5, 
603 

имитация объекта ЕѵепіВоигсе, 552 
использование утилитами Діах в библиотеке 
ІС^иегу, 598 

константы, определяющие возможные значе¬ 
ния свойства геасІуЗіаіе, 1034 
междоменные НТТР-запросы, 545 
методы, 1036 

обработчики событий, 1038 
отправка простого текста серверу методом 
Р08Т, 531 

отправка сообщений пользователя в чат, 552 
оформление тела НТТР-запроса, 535 
политика общего происхождения, 363 
получение ответа, 532 

прерывание запросов и предельное время ожи¬ 
дания, 544 
свойства, 1035 

события, возникающие в ходе 
выгрузки файлов, 542 
выполнения НТТР-запроса, 541 


создание экземпляра, 527 
ХМЬШірКедііеаІО, конструктор, 725 
ХМЬННрКедиеаШрІоасІ, объект, 1039 
ХМЬЬіві, объект, 310 

У 

уіеіб, выражение, 306 
уіеіб, ключевое слово, 303 
уіеМГогЗіога^еІІрйаіеаО, метод объекта 
Каѵі&аіог, 997 
ѴШ, фреймворк, 368 

2 

2 -ішІех, свойство, 453 

А 

абсолютное позиционирование элементов, 451 
абстрактные классы, 252 
и иерархии классов, 258 
абстрактные методы, 252 
автономные веб-приложения, 643, 650, 652 
события, 487 

альтернативы в регулярных выражениях, 281 
альфа-значение, прозрачность, 458 
анимационные эффекты 
в библиотеке і^иегу, 978 
воспроизведение за счет управления встроен¬ 
ными стилями С88, 465 
модули С88 Т га па Шопа и Апітаііопа, 450 
поддержка в клиентских библиотеках, 467 
реализация собственных анимационных 
эффектов, 589 

реализация с помощью библиотеки і()иегу, 586 
отмена, задержка и постановка эффектов 
в очередь, 593 
простые эффекты, 588 
апострофы, 58 

экранирование в строковых литералах, заклю¬ 
ченных в одинарные кавычки, 58 
аппаратно-зависимые и аппаратно-независимые 
события, 480 

аргументы (функций), 193, 194 
как свойства объекта, 196 
необязательные, 193 

списки аргументов переменной длины, 194 
арифметические выражения, 88 
оператор +, 89 
поразрядные операторы, 91 
унарные арифметические операторы, 90 
арифметические операторы, 53 
асинхронная загрузка и выполнение сценариев, 
346 

асинхронный ввод/вывод 
НТТР-сервер (пример), 327 
ХМЬНЗДрКедиеаі и спецификация Кііе АРІ, 
версия 2, 487 
буферы, 324 

в интерпретаторе Кобе, 321 
модуль утилит клиента НТТР в Иобе, 329 
потоки ввода/вывода, 324 
сетевые взаимодействия, 327 
функции для работы с файлами и файловой си¬ 
стемой в модуле Іа интерпретатора Иобе, 325 
асинхронный обмен сообщениями между доку¬ 
ментами с различным происхождением, 717 
ассоциативность операторов, 88 
ассоциативные массивы, 143 
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атаки типа «отказ в обслуживании», 367 
атрибуты, 405 

НТМЬ как свойства объектов Еіетепі, 405 
в расширении Е4Х, 312 
данных, использование для реализации 
эффекта смены изображений, 657 
доступ к нестандартным НТМЬ-атрибутам, 406 
имена изменяемых С 88-атрибутов, объект 
с параметрами, 590 
как узлы типа Аііг, 408 
объектов, 158,159 
сіавв, атрибут, 159 
ехіепвіЫе, атрибут, 160 
ргоіоіуре, атрибут, 158 
свойств, 154,155 
копирование, 157 

получение и изменение значений, 154 
с данными, 407 

установка обработчиков событий, 490 
чтение и запись значений С88-атрибутов мето¬ 
дами объекта іС^иегу, 566 
чтение и запись значений НТМЬ-атрибутов ме¬ 
тодами объекта ]()ііегу, 565 
аудио и видео 

определение состояния мультимедийных эле¬ 
ментов, 661 

работа с аудио- и видеопотоками, 658 
выбор типа и загрузка, 659 
события мультимедийных элементов, 663 
управление воспроизведением, 660 
аудио- и видеозаписи 

МесІіаЕІетепі, суперкласс, 987 
МебіаЕггог, суперкласс, 992 
Ѵісіео, объект, 1019 
аффинные преобразования, 682 

Б 

базовый Лаѵа8сгірі, 25 
базы данных 

на стороне клиента, 747 
поддержка баз данных в броузерах, 628 
безопасность, 361 

данных в соокіев, 635 
и сценарии, 549 
клиентский Лаѵа8сгірі, 361 

атаки типа «отказ в обслуживании», 367 
межсайтовый скриптинг, 365 
неподдерживаемые возможности, 362 
ограничение возможностей, 362 
политика общего происхождения, 363 
междоменные НТТР-запросы, 545 
объект Сапѵав, метод іоПаіаІЖЦ), 698 
при сохранении данных на стороне клиента, 
629 

бесконечные циклы, 122 
библиотеки 

визуальных эффектов, 467 
клиентские, поддержка визуальных эффектов, 
467 

обеспечения совместимости, 356 
управление историей, 374 
блоки инструкций, 110 
блокирующее выполнение сценария, 346 
блочная модель (С88), 455 

модель Ъогйег-Ъох и свойство Ъох-віхіп#, 457 
І (}иегу. виррог і. ЬохМо<1е1, свойство, 613 


букмарклеты, 343 

для работы с выделенным текстом, 440 
использование ІШЬ-адресов Лаѵа8сгірі, 343 
буксировка (бга^-апб-бгор), 508 
БаіаТгапвіег, объект, 911 
бгавО, функция, вызов из обработчика собы¬ 
тия тоивейоѵгп, 501 
буксировка элементов документа, 501 
доступ к файлам, сбрасываемым пользовате¬ 
лем на элемент, 539 

получение файлов средствами ИпБ АРІ и их 
выгрузка с помощью НТТР-запросов, 542 
приемник буксируемых данных, 511 
собственный источник данных, 510 
события в источнике данных, 509 
список как приемник и источник (пример), 512 
буферы, в интерпретаторе №6е, 324 

В 

ввод/вывод, асинхронный 
в интерпретаторе №<1е, 321 
модуль утилит клиента НТТР в Кобе, 329 
ввод пользователя, фильтрация, 516 
веб-броузеры 

Ъох- 8 І 2 Іп 2 , свойство, 457 
сЬіІдгеп, свойство объекта Еіетепі, поддерж¬ 
ка, 402 

СОК8 (Сго88-Огі&іп Невоигсе 8Ьагіп&), заголов¬ 
ки, 545 

^ѵа8сгірі в веб-броузерах, 333 
Каѵіяаіог, объект, 374 
блочная модель С88, 457 

веб-сайты с информацией о совместимости, 353 
доступность веб-приложений, 360 
значения свойства геа<1у8іаіе объекта 
ХМЬНіірКедиеві, 532 
информация о броузере и об экране, 374 
использование вызываемых объектов, 214 
как операционные системы, 336 
область видимости 1оса18іога&е, 630 
область видимости веааіопЗіога^е, 630 
поддержка 
С88, 447 
8ѴС, 666 

баз данных, 628, 747 
объекта Еѵепі8оигсе, 552 
форматов обозначения цветов в С88, 458 
элемента <сапѵа&>, 672 
проблемы совместимости, 352 
различия в реализации операций композиции, 
700 

реализация модуля С88 Тгапвіііопв, 467 
реализация событий, возникающих в ходе 
выгрузки файлов, 542 
выполнения НТТР-запроса, 541 
редактирование содержимого документа, 441 
текущие версии, 355 
веб-документы и Лаѵа8сгірі, 336 
веб-жучки (ѵгеЪ Ъи&&), 525 
веб-приложения, 32 
автономные, 650 
и ЛаѵаЗсгірі, 336 

калькулятор платежей по ссуде, 33 
веб-сокеты, 755 

сервер на основе веб-сокетов и интерпретатора 
Кобе, 758 
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создание и регистрация обработчиков собы¬ 
тий, 755 

создание клиента чата, 757 
веб-страницы, 32 
веб-шрифты, 450 
вещественные литералы, 52 
вещественные числа, двоичное представление ве¬ 
щественных чисел и ошибки округления, 55 
взаимодействие документов с разным 
происхождением, 716 

взаимодействие между окнами в ЛаѵаЗсгірі, 387 
видимая область 
определение, 421 
определение размеров, 423 
видимость 

ѵіаіЬіІііу, свойство, 457, 458 
частичная видимость, свойства оѵегПо\ѵ и сіір, 
459 

визуальные эффекты 

в библиотеке і()иегу, 978 
методы объекта іС^иегу, 586 
реализация собственных анимационных эф¬ 
фектов, 589 

реализация с помощью библиотеки іС^иегу 
простые эффекты, 588 
эффект смены изображений, 656 
вкладки в окнах броузеров, 382 
вложенные функции, 188, 335 
возбуждение событий, 582 

предотвращение возбуждения событий архи¬ 
тектуры Д)ах, 610 
возврат каретки, 42 
возвращаемые значения 
обработчиков событий, 495 
обработчиков событий в библиотеке і()иегу, 577 
установка свойства геіигпѴаІие в значение 
Іаіве, 497 

восьмеричные значения, 52 
временная файловая система, 742 
всплывающие окна, блокирование в веб-броузе¬ 
рах, 384 

всплытие, 348, 477 

динамических событий, 585 
невсплывающие версии событий мыши в ІЕ, 
484 

обработка событий в библиотеке іС^иегу, 575 
событий клавиатуры в документе и окне, 484 
событий мыши, 485 
вспомогательные технологии, 360 

конфликт с анимационными эффектами, 588 
вспомогательные функции в библиотеке іС^иегу, 
982 

встраивание ЛаѵаВсгірі в разметку НТМЬ, 337 
<всгірі>, элемент, 338 
обработчики событий, 341 
сценарии во внешних файлах, 339 
встроенные стили, управление, 463 
встряхивание элемента из стороны в сторону 
(пример анимационного эффекта), 465 
выбор элементов документа, 393 
босшпепі.аЩ], коллекция, 400 
по значению атрибута Ш, 393 
по значению атрибута пате, 394 
по классу С88, 397 
по типу, 395 


вывод, определение функции і(}иегу.1п.ргіпі1п(), 
622 

выделенные фоновые потоки выполнения, 724 
выдел'енный текст, в документах, получение, 440, 
вызов конструктора базового класса, 252 
вызов конструктора и методов базового класса, 254 
вызов конструкторов, 192 
вызов методов, 190 
вызов функций, 189 
І()ііегу(), функция, 558 
вызов конструкторов, 192 
как инструкции-выражения, 110 
косвенный, 193 
обработчиков событий, 492 
вызываемые объекты, 214 
выполнение ^ѵаВсгірі-программ, 344 
модель потоков выполнения, 349 
последовательность выполнения, 350 
синхронные, асинхронные и отложенные сце¬ 
нарии, 345 

управляемое событиями, 347 
выполнение итераций 

с помощью циклов іог/іп, 122 
выполнение, управляемое событиями, 347 
выражение инициализации (циклы іог), 121 
выражение инкремента (циклы іог), 121 
выражение проверки (циклы іог), 121 
выражения, 79 

йеіеіе, оператор, 107 
Іуреоі, оператор, 105 
ѵоіб, оператор, 108 
арифметические, 88 

+ (сложение и конкатенации строк), опера¬ 
тор, 89 

вызова, 83,189,190 

вызов конструкторов, 192 
косвенный вызов, 193 
вычисление, 102 

еѵа1(), функция, 103 
генераторы, 308 
доступа к свойствам, 191 
вызов методов, 191 

инициализаторы объектов и массивов, 80 
использование еѵа1() в глобальном контексте, 
103 

использование еѵа1() в строгом режиме, 104 
левосторонние, 86 
логические, 98 

логическое ИЛИ (||), оператор, 99 
логическое И (&&), оператор, 98 
логическое НЕ (I), оператор, 100 
обращения к свойствам, 82 
оператор «запятая» (,), 108 
операторы, типы данных операндов, 86 
определений функций, 81,185 

в сравнении с инструкциями объявления 
функций, 114 
отношений, 93 
оператор іп, 97 
оператор іпвіапсеоі, 97 
операторы равенства и неравенства, 93 
операторы сравнения, 95 
первичные, 79 

перед ключевым словом іог в генераторах мас¬ 
сивов, 308 

поразрядные операторы, 91 
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порядок вычисления, 88 
присваивания, 100 

побочные эффекты, 110 
с операцией, 101 
создания объектов, 84 
унарные арифметические операторы, 90 
условный оператор (?:), 105 
вычисление выражений, 102 
еѵа1(), функция, 103 

использование еѵа1() в глобальном контексте, 
103 

использование еѵа1() в строгом режиме, 104 
вычисленные стили, 468, 469, 566 
получение, 468 

вычисляемые значения свойств размеров в С88, 
457 

Г 

генераторы, 303 
конвейеры, 305 

перезапуск с помощью методов веп<1() 
и іЬгоѵгО, 306 
генераторы массивов, 307 
синтаксис, 307 

геометрия документа и элементов и прокрутка, 
421 

координаты документа и видимой области, 421 
обработка событий колесика мыши (пример), 
506 

определение геометрии элемента, 423 
определение элемента в указанной точке, 424 
прокрутка, 425 

размеры, позиции и переполнение элементов, 
426 

чтение и запись параметров геометрии элемен¬ 
тов, 568 

геопозиционирование, 707 
гиперссылки 

Ілпк, объект, 984 
опсііск, обработчик событий, 434 
глобальные переменные, 45, 51 

как свойства глобального объекта, 77 
ограничение на использование в безопасных 
подмножествах, 292 
глобальные свойства, 815 
глобальные функции, 45, 815 
в Шііпо, 315 

глобальный объект, 63, 815 

свойства, ссылающиеся на предопределенные 
объекты, 815 

глобальный поиск по шаблону, 285, 286, 289 
градиенты 

СапѵавСгагііепі, объект, 890 
граница неслова () метасимвол, 284 
граница слова () символ в регулярных выражени¬ 
ях, 284 

графика, 672, 673 

8 ѴС (8са1аЫе Ѵесіог СгарЬіса - масштабируе¬ 
мая векторная графика), 665 
работа с готовыми изображениями, 656 
создание с помощью элемента <сапѵав>, 672 
графические атрибуты объекта контекста, 678 
графические интерфейсы пользователя 

создание графического интерфейса средствами 
языка Лаѵа на языке ^ѵаЗсгірі в Шііпо (при¬ 
мер), 319 


графические параметры (<сапѵав>), 894 
сохранение, 894 
грубое определение типа, 235 
группировка в регулярных выражениях, 281, 282 

д 

дата и время, 56 
Баіе, класс, 50 

Іо81гіп&(), метод, 72 
ѵа1ие01(), метод, 72 
Оаіе, объект, 781 

веШаіеО, метод, 785 
&еШау(), метод, 785 
^еіГи11Уеаг(), метод, 785 
&еШоигз(), метод, 786 
веІМШізесошІзО, метод, 786 
веШіпиІезО, метод, 786 
&еіМоп11і(), метод, 786 
&еі8есопсІ8(), метод, 786 
веіТішеО, метод, 787 
^еіТітегопеСЖаеіО , метод, 787 
веШТСЭаіеО, метод, 787 
^еШТСБауО, метод, 788 
ЯеШТСКиІІѴеагО, метод, 788 
ЯеШТСНоигвО, метод, 788 
&еШТСМі11І8есоп<І8(), метод, 788 
ЕеШТСМіпиіеаО, метод, 788 
2 еШТСМопіЬ() , метод, 789 
ЯеШТС8есош1в(), метод, 789 
&еіУеаг(), метод, 789 
поіѵ(), метод, 789 
рагае(), метод, 790 
ргоіоіуре, свойство, 140 
аеШаЪеО, метод, 790 
8еіГи11Уеаг(), метод, 791 
8 еШоиг&(), метод, 791 
8 еШШІ8есоп<І8(), метод, 792 
8 еіМіпи1е8(), метод, 792 
аеіМопіЬ(), метод, 792 
аеібесоікіаО, метод, 793 
аеіТіте(), метод, 793 
аеШТСІ)аІе(), метод, 793 
8еШТСГи11Уеаг(), метод, 794 
зеШТСНоигвО, метод, 794 
зеШТСМШІ8есопсІ8(), метод, 795 
аеШТСМіпиіеа(), метод, 795 
зеШТСМопіЬ(), метод, 795 
зеШТСВесопбзО, метод, 796 
веіУеаг(), метод, 796 
іоБаіе8ігіп^(), метод, 796 
іоСМТ8ігіп^(), метод, 797 
1о18081гш&(), метод, 797 
ІоЛ8(Ж(), метод, 797 
1оЬоса1еБа1е81гіп^(), метод, 798 
іоЬоса1е8ігіп^(), метод, 798 
іоЬоса1еТіте8ігіп^(), метод, 799 
іо8ігіп^(), метод, 799 
ІоТіте81гіп&(), метод, 799 
іоІІТС8ігіпе(). метод, 800 
ІІТС(), метод, 800 
ѵа1ие01(), метод, 801 
методы, 782 

преобразование в строки и в числа, 73 
сериализация в формат 180,162 
статические методы, 784 
двоичное представление вещественных чисел, 55 
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двоичные данные 
в НТТР-ответах, 535 

двоичные объекты и их прикладные интерфей¬ 
сы, 732 

двоичные объекты, 732, 886 

ІШЬ-адреса, отображение изображений, 736 

загрузка, 735 

использование, 734 

как файлы, 734 

конструирование, 736 

чтение, 739 

двухместные операторы, 86 
действия по умолчанию, для событий, 478 
деление на ноль, 54 
дескрипторы свойств, 154 
_ ргоіо _, свойство, 159 

вспомогательные свойства в ЕСМАЗсгірі 5, 268 
вспомогательные функции, 264 
получение для именованных свойств объектов, 
155 

диалоги, 377 

отображение разметки НТМЬ в диалоге 
с помощью метода 8ЬоѵгМо<1аШіа1ов(), 378 
динамические события, 584 
директивы, 133 
длина строки, 56 
определение, 59 
документы, 390 
ѵггіІе(), метод, 438 
ѵггііе1п(), метод, 439 
атрибуты элементов, 405 
вложенные НТМЬ-документы, 382 
выбор элементов, 393 
генерирование содержимого в процессе 
загрузки, 345 

геометрия документа и элементов и прокрутка, 
421 

загрузка нового документа, 372 
изменение структуры с помощью методов 
объекта іС^иегу, 571 
как деревья элементов, 402 
обзор модели БОМ, 390 
получение выделенного текста, 440 
происхождение, 631 
редактируемое содержимое, 441 
свойства объекта Боситепі, 437 
связывание с таблицами стилей, 446 
события загрузки, 498 
содержимое элемента, 409 
создание и вставка узлов, 413 
использование объектов 
БоситепіЕгаятепі, 416 
удаление и замена узлов, 415 
создание оглавления (пример), 418 
структура и навигация, 401 

документы как деревья узлов, 401 
элементы документа как свойства окна, 380 
домены 

йотаіп, атрибут соокіев, 636 
доступ к свойствам и наследование, 145 
доступность, 360 

дочерние окна и история посещений, 373 
древовидная структура 

геометрия документа и элементов и прокрутка, 
421 

документы как деревья элементов, 402 


представление НТМЬ-документов, 391 

Ж 

жадное повторение, 280 

3 

забоя символ в регулярных выражениях, 279 
заголовки, НТТР-запросы и ответы, 528 
Сопіепі-Ьеп&іЬ, заголовок, 542 
СОК8 (Сго88-Огі&іп Кеаоигсе 8Ьагіп#)» заголов¬ 
ки, 545 

выгрузка файлов посредством Р08Т-запросов, 
540 

заголовки в ответе, 531 

проверка заголовка Сопіепі-Туре в ответе, 535 
установка заголовка Сопіепі-Туре Р08Т- 
запроса, 536 

установка заголовков в запросе, 530 
загрузка содержимого документа, 344 
заимствование методов, 247 
закрытие окон, 385 
заливка 

области отсечения, 693 
цвет, градиенты и шаблоны, 687 
цветом, градиентом и шаблонами в объекте 
Сапѵав, 891 
замыкания, 203 

в методах чтения и записи свойств, 206 
доступ к аргументам внешней функции, 208 
использование в функции ітщиеІпіе&ег() 
(пример), 205 

использование методов доступа к свойствам, 
249 

лексические, краткая форма записи функций, 
309 

правила лексической области видимости для 
вложенных функций, 204 
запросы и ответы 

декодирование ответа, 534 
синхронные ответы, 533 
запросы и ответы (НТТР), 529 
выполнение запроса, 529 
компоненты ответа, 531 
оформление тела НТТР-запроса, 535 
порядок следования частей запроса, 531 
прерывание запросов и предельное время ожи¬ 
дания, 544 

запросы с данными в формате НТМЬ-форм, 536 
выгрузка файлов, 539 
выполнение СЕТ-запросов, 537 
выполнение Р08Т-запросов, 537 
запросы с МІМЕ-типом тиііірагі/іогт-сіаіа, 
540 

кодирование объектов, 536 
запросы с данными в формате Л8(Ж, 538 
запросы с данными в формате ХМЬ, 538 
зарезервированные слова, 44 
имена НТМЬ-атрибутов, 406 
использование в качестве имен свойств, 139 
получение и изменение значений свойств, 
142 

первичные выражения, 80 
зафиксированные объекты, 847, 849 
знаки препинания в регулярных выражениях, 278 
значение бесконечности, 53 
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идентификаторы 

в выражениях обращения к свойствам, 82 
в помеченных инструкциях, 124 
и символы управления форматом, 42 
определение, 44 
фрагментов в ТШЬ-адресах, 711 
изменяемые типы данных, 51 
изображения 

Іта&е, объект, 962 
вставка в холст, 696 

извлечение содержимого холста в виде изобра¬ 
жения, 698 

ненавязчивая реализация смены изображе¬ 
ний, 657 

обработки в фоновых потоках выполнения 
(пример), 725 

отображение с использованием ІШЬ-адресов 
двоичных объектов, 736 
рисование в элементе <сапѵав>, 892 
имена 

С88-свойств в ^ѵаЗсгірі, 464 
окон, 383 

свойств объектов и индексы в массивах, 166 
тегов, выбор элементов документа, 395 
функций, 186 
индексы в массивах, 164 

и имена свойств объектов, 166 
инициализаторы, выражения, 80 
инструкции, 109 
беЪивдег, 132 
игШі, 131 

выражения, 109, 110 

завершение, необязательные точки с запятой, 
46 

краткая сводка, 135 
объявления,109,112 
ѵаг, инструкция, 112 
объявления функций, 186 
определение, 27 
определения функций, 113 
перехода, 109, 124,125 

Ъгеак, инструкция, 125, 126 
сопііпие, инструкция, 126,128 
геіигп, инструкция, 127,129 
Ыігоѵг, инструкция, 128,129 
Ігу/саІсЬ/йпаІІу, инструкция, 129,130 
метки, 124,125 
помеченные, 124 

сопііпие, инструкция, 126 
прочие, 131 

составные и пустые, 110 
условные, 114 

еіве і?, инструкция, 116 
іі, инструкция, 114 
8ѴГІІСІ1, инструкция, 117 
циклов 

йо/ѵгЬіІе, инструкция, 120 
іог/іп, инструкция, 122 
іог, инструкция, 121 
ѵгЬіІе, инструкция, 119 
циклы, 119 
интерп ретаторы 

версии Лаѵа8сгірі, 297 

поддержка расширений ЛаѵаЗсгірі, 290 


поддержка расширения Е4Х (ЕСМА8сгірі іог 
ХМЬ), 310 
исключения 

Лаѵа, обработка как ^ѵаВсгірі-исключений - 
в Шііпо, 318 

возбуждаемые объектом АѴогкег, 722 
возбуждение, 128 

обработка с множественными блоками саісЬ, 
309 

обработка с помощью инструкции ігу/саісЬ/ 
Ііпаііу, 129 

история посещений, 373 
Нівіогу, объект, 958 

механизм управления историей посещений 
в НТМЬ5, 487, 711 
итераторы, 301 
итерации 

по полям, методам и свойствам Лаѵа-классов 
и объектов, 317 

по свойствам с помощью функции 
ІС}иегу.еасЬ(), 610 
расширения языка 
выражения, 308 
генераторы, 303 
генераторы массивов, 307 
итерируемые объекты, 302 

К 

калькулятор платежей по ссуде (пример), 33 
карринг, 211 

карты, отображение с использованием механизма 
геопозиционирования, 708 
квантификаторы регулярных выражений, 279 
клавиши-модификаторы, для событий мыши, 

483,500 

классификация броузеров, 356 
классы, 50, 221 

сІаввКате, свойство, 406 
абстрактные, 252 
в ЕСМАЗсгірі 5, 262 

дескрипторы свойств, 268 
определение неизменяемых классов, 263 
определение неперечислимых свойств, 262 
подклассы, 267 

предотвращение расширения классов, 266 
сокрытие данных объекта, 265 
в стиле Лаѵа в языке ЛаѵаВсгірі, 227 
8 еі, класс (пример), 238 
возможности, не поддерживаемые 
в ЛаѵаЗсгірі, 230 
определение класса Сотріех, 228 
типы-перечисления (пример), 239 
функции, определяющие простые классы, 
228 

встроенные, автоматически определяются во 
всех окнах, 388 
и конструкторы, 223 

и идентификация классов, 225 
СВОЙСТВО СОП8ІГ11СІОГ, 226 
и прототипы, 222 

объектно-ориентированное программирование 
в Лаѵа8сгірі 

наследование в сравнении с композицией, 
256 

отделение интерфейса от реализации, 258 
определение С88-свойств, 448 
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определение в нескольких окнах, 388 
определение классов объектов, 232 
грубое определение типа, 235 
использование имени конструктора как 
идентификатора класса, 234 
с помощью оператора іпвіапсеоТ, 232 
подклассы, 252 

иерархии классов и абстрактные классы, 258 
композиция в сравнении с наследованием, 
256 

определение подкласса, 252 
приемы объектно-ориентированного програм¬ 
мирования в ЛаѵаВсгірі 
заимствование методов, 247 
перегрузка конструкторов и фабричные 
методы, 250 
частные члены, 249 

расширение добавлением методов в прототип, 
231 

управление С88-классами, 470 
чтение и запись С88-классов, 566 
клиентский ЛаѵаЗсгірі, 29, 333, 334 
безопасность, 361 

атаки типа отказ в обслуживании, 367 
межсайтовый скриптинг, 365 
неподдерживаемые возможности, 362 
ограничение возможностей, 362 
политика общего происхождения, 363 
конструирование веб-приложений, 367 
модель потоков выполнения, 349 
проблемы совместимости, 352 
справочник, 881 
ключевые слова 

чувствительность к регистру, 41 
кнопки 

<Ьиііоп>, элемент, 428 

опсііск, обработчик событий, 343 
регистрация обработчиков событий сііск, 491 
Виііоп, объект, 888 
кнопки в формах, 433 
переключатели и флажки, 434 
кодовые пункты Юникода, 57, 515 
команды 

СопвоІеСоттапсИлпе, объект, 907 
редактирования текста, 443 
комментарии, 25 
Соттепі, узел, 905 

сгеаіеСоттепі(), метод объекта Боситепі, 413 
в Лаѵа8сгірі-коде в ІЖЬ-адресах, 342 
в таблицах стилей С88, 445 
создание узлов Соттепі, 918 
стили оформления, 43 
условные, 359 
композиция 

в сравнении с наследованием, 256 
в элементе <сапѵав>, 893 
пикселов в холсте, 698 

локальная и глобальная, 700 
компоненты редакторов в фреймворках, 443 
конвейеры генераторов, 305 
конечные числа, 817 
конкатенация строк, 59 

константы, область видимости блока и использо¬ 
вание ключевого слова Іеі, 295 
конструкторы, 140, 185, 815 

сопзігисіог, свойство объектов, 840 


ргоіоіуре, свойство, 158 
вызов, 192 

вызов конструктора базового класса, 254 
и прототипы объектов, 140 
классы, 223 

и идентификация классов, 225 
свойство сопзігисіог, 226 
объектов, 228 
определение, 50 
перегрузка, 250 

типизированных массивов, 1018 
контекст вызова, 185 
контекст выполнения, 382 
обработчиков событий, 493 
контекстные меню, 500 
контекст просмотра, 382 
контуры 

атрибуты рисования линий, 691 
определение, 675 

определение попадания точки в контур, 900 
холст, определение внутренней области конту¬ 
ра, 677 

элемент <сапѵаз> 

Ъе#іпРаіЬ(), метод, 897 
сІозеРаіЬО, метод, 898 
создание и отображение, 890 
координаты 

Сеосоогйіпаіез, объект, 955 
документа и видимой области, 421 
преобразование координат в видимой области 
в координаты документа, 426 
преобразование координат документа в коор¬ 
динаты видимой области, 427 
указателя мыши в системе координат окна, 483 
копии, структурированные, 712 
косвенный вызов, 193 
кривые Безье 

^иас^^а1ісСи^ѵеТо(), метод, 902 
рисование и заливка в холсте, 685 
круговая диаграмма в формате 8ѴС, построенная 
^ѵаВсгірі-сценарием, 667 
курсор, открытие в Іш1ехе<ШВ, 748 
кэширование, 643 

мемоизация функций, 220 
кэш приложений, 643 

значения свойства віаіиз, 649 
обновление кэша, 645 
создание файла объявления, 643 

Л 

левосторонние выражения, 86,122 
лексическая область видимости, 203 

и функции, совместно используемые в окнах 
или фреймах, 388 

правила для вложенных функций, 204 
лексическое замыкание, 309 
линейные градиенты, 690, 898 
линии, атрибуты рисования в холсте, 691 
литералы, 80 

вещественных чисел, 52 
литералы ХМЬ в программном коде Лаѵа- 
8 сгірі, 311 
объектов, 139 
определение, 43 
строковые, 56 
числовые, 52 
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логические выражения, 98 

логическое ИЛИ (||), оператор, 99 
логическое И (&&), оператор, 98 
логическое НЕ (!), оператор, 100 
логические значения, 49, 61 

преобразование объектов в логические значе¬ 
ния, 71 

локальные файлы и объект ХМЬНирКеяиеа!, 529 

М 

массивы, 50,164 
Аггау, класс, 50 

1о81гтв(), метод, 71 
Аггау, объект, 763 

сопсаі(), метод, 173, 765 
еѵегу(), метод, 178, 765 
Шіег(), метод, 177, 766 
?огЕасЬ(), метод, 176, 767 
іп<1ехО?(), метод, 180, 768 
іаАггауО, метод, 181 
Іоіп(), метод, 172, 769 
ІааіІшІехОІО, метод, 180, 769 
1еп&11і, свойство, 764, 770 
тар(), метод, 177, 770 
рор(), метод, 175, 771 
риаЬ(), метод, 175, 771 
гебисеО, метод, 178, 772 
гес!исеКі§М(), метод, 178, 773 
геѵегае(), метод, 172, 774 
8 МЯ(), метод, 175, 774 
&1ісе(), метод, 174, 775 
8 оте()> метод, 178, 775 
80 ГІ(), метод, 173, 776 
&р1ісе(), метод, 174, 777 
ІоЬоса1е8ігіпб(), метод, 176, 778 
Іо8ігіп&(), метод, 176, 778 
ипаМОД), метод, 175, 779 
методы, 764 

Лаѵа, получение и изменение элементов в про¬ 
граммах на языке Лаѵа8сгірІ Шііпо, 317 
80 ГІ(), метод, 247 

выражения обращения к свойствам, 82 
длина, 168 

добавление и удаление элементов, 169 
значений, присваивание с разложением, 298 
инициализаторы, 80 
итерации 

с помощью метода і()иегу.еас}і(), 610 
с помощью циклов Гог/еасЬ, 300 
методы, 172 

ЕСМАЗсгірі 5,176 
многомерные, 171 

обработка с помощью функций, 215 
обход элементов массива, 170 
объекты как ассоциативные массивы, 143 
отличие от других объектов, 181 
поиск по строкам с помощью регулярных вы¬ 
ражений, 286 

преобразование объекта іС^иегу в настоящий 
массив, 562 

присваивание функций элементам, 199 

разреженные, 167 

создание, 165 

сравнение, 66 

строки как массивы, 184 

типизированные, 1017 


типизированные массивы и буферы, 728 
разновидности типизированных массивов, 
728 

чтение и запись элементов массивов, 166 
междоменные НТТР-запросы, 545 

получение информации о ссылках с помощью 
НЕАБ-запросов при поддержке заголовка 
СОК8, 546 

межсайтовый скриптинг (Х88), 365 
мемоизация функций, 220 
метасимволы в регулярных выражениях, 277 
методы, 64, 65,185 

Лаѵа, вызов из программ на языке ЛаѵаЗсгірі 
в Шііпо, 316 
ІС^иегу (термин), 561 
абстрактные, 252 

вставки и удаления в библиотеке іС^иегу, 974 
выбора в библиотеке іС^иегу, 618, 969 
возврат к предыдущему выбору, 621 
использование результатов выбора 
в качестве контекста, 619 
вызов, 190 

выражения вызова, 83 
добавление в объекты-прототипы, 231 
заимствование, 247 
класса ОЪіесі, 162 
1 оЛ8СЖ(), 163 
ІоЬоса1е8ігіп&(), 163 
Іо8ігіп&(), 162 
ѵаІиеСЩ), 163 
массивов 

ЕСМАЗсгірі 3,172 
ЕСМАЗсгірі 5, 176 

массивов, введенные стандартом Е85, 356 
ограничение на использование в безопасных 
подмножествах, 293 
преобразования типов, 242 
сравнения, 244 
чтения и записи 

объекта іС^иегу, 565 
088-атрибутов, 566 
088-классов, 566 
НТМЬ-атрибутов, 565 
данных элемента, 570 
значений элементов НТМЬ-форм, 567 
параметров геометрии, 568 
содержимого элементов, 568 
свойств, 152 

механизм буксировки (сіга§-апсі-сігор) 

АРІ, определяемый стандартом НТМБ5, 486 
многомерные массивы, 171 
многострочный режим поиска по шаблону, 285 
многоугольники, рисование методами объекта 
Сапѵав, 675 
множества 

8 еІ, класс (пример), 238, 239 
мобильные устройства, события, 479 
модальные диалоги, 378 
модель выполнения фоновых потоков, 723 
модули, 270, 273 

область видимости функции как частное про¬ 
странство имен, 273 
объекты как пространства имен, 271 
мышь 

двунаправленное колесико мыши и событие 
ѵѵЬееІ, 485 
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координаты указателя мыши, 422 

Н 

набор символов, 41 

наиболее важные С88-свойства, 450 

наследование, 144 

в сравнении с композицией, 256 
и перечисление свойств, 149 
классы и прототипы, 222 
прототип конструктора как прототип нового 
объекта, 223 
свойств объектов, 144 
свойств с методами чтения и записи, 152 
создание новых объектов, наследующих прото¬ 
типы, 141 

нежадное повторение, 280 
неизменяемые классы, определение, 263 
неизменяемые объекты, 847, 849 
неизменяемые типы данных, 51 
неопределенные значения, 879 

переменные, объявленные без инициализато¬ 
ров, 112 

неполная иерархия классов узлов документов, 392 
нестандартные С88-свойства, 447 
нормализация способов кодирования Юникода, 43 

О 

области видимости блока, 76 

отсутствие, решение проблемы с помощью 
ключевого слова Іеі, 295 
области видимости переменных, 51, 75 
соокіеа, 635 

вложенные функции, 188 
замыкания, 203 
и функции, 185 

область видимости хранилища, 630 
фонового потока, 722 
функции как пространства имен, 76, 201 
функции обработчиков событий, 494 
цепочки областей видимости, 78 
области видимости функций, 51 
и подъем, 76 

как частные пространства имен модулей, 273 
обмен сообщениями 

тевва^е, событие, используемое для обмена 
асинхронными сообщениями, 487 
отправка данных объекту ЛѴогкег с помощью 
метода ровШевва^еО, 721 
обработка исключений, 129 
обработка событий колесика мыши, 504 
обработчики событий 

АррІісаііопСасЬе, объект, 884 
Еіетепі, объект, 931 
ЕѵепіЗоигсе, объект, 944 
ЕіІеКеайег, объект, 948 
Гогт, объект 
методы, 951 

ГогтСопігоІ, объект, 953 
МесііаЕІетепІ, объект, 990 
ТОпболѵ, объект, 1028 
\Ѵогкег, объект, 1030 
XМ^НирКе^ие8^, объект, 1038 
события геасіувіаіесЬап^е, 532 
в НТМЬ, 341 
в библиотеке іС^иегу, 577 
возникающих в ходе выполнения НТТР- 
запроса, 541 


возникающих в ходе выполнения выгрузки 
файлов, 542 
, вызов, 492 

аргумент обработчика события, 493 
возвращаемое значение обработчика, 495 
контекст обработчика события, 493 
отмена событий, 497 
порядок вызова, 495 

дополнительные способы регистрации обра¬ 
ботчиков событий в библиотеке іС^иегу, 579 
область видимости, 494 
определение, 31 

определение в автономных веб-приложениях, 
651 

определение в объекте ЕіІеКеабег, 740 
определение обработчика опсііск (пример), 31 
распространение событий, 496 
свойства, определяемые объектами 
НТМІіЕІетепІ, 405 
текстовых полей ввода, 435 
удаление в библиотеке іС^иегу, 580 
форм и их элементов, 432 
функции,348 

обратный порядок следования байтов (НШе- 
епсііап), 731, 913 
обход элементов массива, 170 
объектно-ориентированное программирование 
в ЛаѵаЗсгірі 

наследование в сравнении с композицией, 
256 

отделение интерфейса от реализации, 258 
строго типизированные языки, 221 
объектные базы данных, 748 
объектные типы, 49 
объекты, 137 

іпвіапсеоі, оператор, 97 
Лаѵа, изменение значений полей в КЬіпо, 317 
ІС^иегу, 561 
ХМЬ, 310 
атрибуты, 158,159 
с1а&8, атрибут, 159 
ехіепвіЫе, атрибут, 160 
ргоіоіуре, атрибут, 158 
атрибуты свойств, 154 
базового языка, 138 
вызываемые, 214 

выражения обращения к свойствам, 82 
выражения создания объектов, 84 
глобальный объект, 63 
инициализаторы, 80 
итерации по свойствам 

порядок перечисления в циклах Іог/іп, 123 
с помощью циклов Іог/іп, 122 
итерируемые, 302 
как пространства имен, 271 
конструкторов, 227 
контекста рисования, 673 
массивы объектов, 164 
методы, 185 

методы чтения и записи свойств, 152 
обертки, 64 

определение классов объектов, 232 
грубое определение типа, 235 
использование имени конструктора как 
идентификатора класса, 234 
с помощью оператора іпвіапсеоі, 232 
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перечисление свойств, 149 
подобные массивам, 182 
Аг^ишепів, объект, 194 
НТМІіСоІІесНоп, объект, 396 
ІС^иегу, 562 

типизированные массивы, 728 
получение и изменение значений свойств, 142 
и наследование, 144 

объекты как ассоциативные массивы, 143 
ошибки доступа, 145 

представление свойств в формате НТМЬ-форм, 
536 

преобразование в строки, 712 
проверка существования свойств, 148 
прототипов, 228 
свойства, 138 

свойства с методами доступа, 152 
сериализация, 161 
создание, 139,141 
прототипы, 141 
с помощью литералов, 139 
с помощью оператора пеѵѵ, 140 
с помощью функции ОЬіесІ.сгеаіеО, 141 
среды выполнения, 138 
ссылки на изменяемые объекты, 65 
структурированные копии, 712 
удаление свойств, 147 
экземпляров, 228 
объявление переменных, 74 
объявление функций, 187 
оглавление, пример создания оглавления доку¬ 
мента, 418 
окна, 369 

адрес документа и навигация по нему, 371 
загрузка нового документа, 372 
взаимодействие Лаѵа8сгір1-кода с окнами, 363 
взаимодействие между окнами в ЛаѵаЗсгірі, 
387 

закрытие окон, 385 
и история посещений, 373 
информация о броузере и об экране, 374 
обработка ошибок, 379 
определение позиций полос прокрутки, 422 
определение размеров видимой области, 423 
открытие и закрытие, 383 
политика общего происхождения, 
(Іоситепі.сіотаіп, свойство, 364 
работа с несколькими окнами и фреймами, 382 
таймеры, 370 

элементы документа как свойства окна, 380 
операторы, 84, 86 
сіеіеіе, 107 
іп, 97 

іпаіапсеоі, 97 
іуреоГ, 105 
ѵоісі, 108 

+ (сложение и конкатенации строк), оператор, 
89 

арифметические, 88 
ассоциативность, 88 
двухместные, 86 
«запятая» (,), 108 
количество операндов, 86 
левосторонние выражения, 86 
логическое И (&&), 98 
логическое ИЛИ (||), 99 


логическое НЕ (!), 100 
обзор операторов, 84 
операнды, 86 
отношений, 93 

перечень операторов Лаѵа8сгірі, 84 
побочные эффекты, 87,110 
поразрядные, 91 
порядок вычисления, 88 
приоритет, 87 

равенства и неравенства, 93 
сдвига, 92 
сравнения,95, 246 
тернарные, 86 
типы данных операндов, 86 
унарные, 86 

унарные арифметические операторы, 90 
условный оператор (?:), 105 
операции чтения, 948 

операционные системы, основа реализации меха¬ 
низмов буксировки (бга^-апб-бгор), 486 
определение класса объекта, 159 
определение собственных свойств функций, 200 
определение типа броузера, 374 

с помощью паѵі^аіог.ивегА^епі, 376 
определение элемента в указанной точке, 424 
отключение анимационных эффектов в библиоте¬ 
ке і()иегу, 588 

открывающие и закрывающие теги, 410 
открытие и закрытие окон, 383 
закрытие окон, 385 

отладка фоновых потоков выполнения, 727 
отложенное выполнение сценариев, 346 
отмена событий, 497 

ІехНпрігі и кеургеаа, 516 

относительное позиционирование элементов, 452 
относительные ІІКЬ -адреса, 373 
относительные значения, для числовых свойств 
при воспроизведении анимационных эффектов, 
590 

отрицания символ в классах символов, 278 
отрицательная бесконечность, 53 
отрицательный ноль, 54 

сравнение с положительным нулем, 54 
отступы 

в блочной модели С88, 455 
определение средствами С88, 454 
отсчет индексов с 0 (в массивах и строках), 164 
оформление тела НТТР-запроса, 535 
ошибки 

Еггог, класс, 50, 130 
Еггог, объект, 804 

ІаѵаЕхсерІіоп, свойство, 318 
теаза^е, свойство, 805 
пате, свойство, 805 
Іо8ігіпе(), метод, 806 
в броузерах, 353 
доступа к свойствам, 145 
обработка в объектах "ѴѴіпсІоѵѵ, 379 
обработка ошибок подобно событиям, 481 
округления вещественных чисел в двоичном 
представлении, 55 

П 

параметры (функций), 193,194 
необязательные, 193 
первичные выражения, 79 
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перегрузка конструкторов, 250 

перекрытие полупрозрачных окон (пример), 460 

переменные 

в генераторах массивов, 307 
глобальные, 45 
и типы данных, 51 
как свойства, 77 
область видимости, 75 

функции как пространства имен, 76 
цепочки областей видимости, 78 
объявление, 74 

повторные и опущенные объявления, 74 
с помощью ключевого слова Іеі, 295 
присваивание с разложением, 298 
присваивание функций, 199 
ссылка на переменную как первичное выраже¬ 
ние, 80 

переполнение, 53 

элементов, прокручиваемые элементы доку¬ 
мента, 427 

перехват событий, 478, 491, 496 

использование метода аеіСарІиге() в ІЕ для пе¬ 
рехвата событий мыши, 501 
перехватывающие обработчики событий, 491, 496 
события мыши в ІЕ, 501 
перечисление свойств, 149 
порядок в циклах Іог/іп, 123 
перечислимые свойства, 123 

итерации с помощью циклов Іог/еасЬ, 300 
получение имен собственных перечислимых 
свойств, 849 

печать, события Ьеіогергіпі и аііегргіпі, 488 
пикселы 

композиция в холсте, 698 
композиция в элементе <сапѵаэ>, 893 
манипулирование в объекте Сапѵаа, 894 
побочные эффекты выражений, 110 
повторение в регулярных выражениях, 279 
жадное, 280 
нежадное, 280 

поддержка метода ееІЕІетепІбВуСІаввКатеО, 398 
поддержка селекторов С88, 398 
подклассы, 252 

вызов конструктора и методов базового класса, 
254 

иерархии классов и абстрактные классы, 258 
композиция в сравнении с наследованием, 256 
определение, 252 
подмножества Лаѵа8сгірі, 291 
АНааІе, 293 
Саіа, 294 
(іоіох.аесиге, 294 
ГВЛ8, 294 

Місговоіі \ѴеЪ 8аш1Ьох, 295 
ТЬе Сооб Рагіз, 291 
подстроки, разбиение строк, 287 
подшаблоны в регулярных выражениях, 281 
подъем, 76 
подынструкции, 111 
позиции полос прокрутки окна, 422 
позиционирование элементов 
блочная модель С88, 455 

геометрия документа и элементов и прокрутка, 
421 

с помощью С88, 451 
текст с тенью (пример), 454 


чтение и запись параметров геометрии элемен¬ 
тов, 568 
по значению 

сравнение значений простых типов, 66 
поиск с заменой с использованием регулярных 
выражений, 285 

политика общего происхождения, 363 
и вызываемые ею проблемы, 364 
и файловые системы, 742 
объект Сапѵав, метод 1оБа1а11г1(), 698 
предотвращение обмена соокіев между сайта¬ 
ми, 636 

происхождение документа, 631 
положительная бесконечность, 53 
полупрозрачные окна, перекрытие (пример), 460 
получение, вставка и удаление правил из таблиц 
стилей, 473 

пользовательские объекты, 138 
пользовательский интерфейс 
ІС^иегу Ш, библиотека, 625 
события, 480 
поля 

в блочной модели С88, 455 
определение средствами С88, 454 
поля и методы класса, 227 
поля и методы экземпляров, 227 
помеченные инструкции, 124 
сопНпие, инструкция, 126 
поразрядные операторы, 91 
порядок вызова обработчиков событий, 495 
порядок вычисления операторов, 88 
по ссылке, сравнение объектов, 66 
постоянная файловая система, 742 
постфиксный оператор декремента, 91 
постфиксный оператор инкремента, 91 
потеря значащих разрядов, 54 
потоки ввода/вывода, в Кобе, 324 
потоки выполнения в клиентском ЛаѵаЗсгірІ, 349 
потоковые мультимедийные данные, свойство 
іпШаІТіте, 661 
правила стилей, 445, 908 

получение, вставка и удаление, 473 
правило ненулевого числа оборотов, 677 
представление элементов <8Іу1е> и <1іпк>, управ¬ 
ление таблицами стилей, 472 
преобразование 

8 еіТгап8Іогш(), метод, 903 
в строки, 176 

объектов в простые значения, 71 
системы координат в элементе <сапѵа&>, 892 
системы координат холста, 680 
математический смысл, 682 
примеры преобразований, 683 
типов, 67 

преобразования и равенство, 68 
префиксный оператор декремента, 91 
префиксный оператор инкремента, 91 
префиксы в именах нестандартных С88-свойств, 
447 

привлечение внимания к элементам документа, 
470 

приемы объектно-ориентированного программи¬ 
рования в ЛаѵаЗсгірі, 238 
8 еІ, класс (пример), 238 
заимствование методов, 247 
методы сравнения, 244 
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перегрузка конструкторов и фабричные мето¬ 
ды, 250 

стандартные методы преобразований, 242 
типы-перечисления (пример), 239 
частные члены, 249 

прикладной интерфейс к файловой системе, 742 
прикладные события, 481 
приоритет операторов, 87 
присваивание 
свойствам 

правила успешного присваивания, 146 
с разложением, 298, 303 
присваивания выражения, 100 
с операцией, 101 
пробельные символы 

в программном коде ЛаѵаЗсгірі, 42 
проверка орфографии в броузерах, 441 
проверка особенностей броузеров, 357 
проверка типа, 358 
проверка существования свойств, 148 
программы, на языке Лаѵа8сгірі, 344 
программы чтения с экрана, 360 
продолжительность анимационных эффектов, 586 
передача методам воспроизведения анимаци¬ 
онных эффектов, 587 
прозрачность 

композиция пикселов с разным уровнем про¬ 
зрачности, 699 

определение цветов в С88, 458 
происхождение документа, 363, 631 
прокрутка, 425 

8СГОІ1, событие окон, 483 
пространства имен 

сгеаіеЕ 1етепШ8(), метод объекта Боситепі, 
413, 918 

&е1Е1етепІ8ВуТа§КатеК8(), метод объекта 
Боситепі, 919 
І(}иегу, 560 

ІоокирКатеврасеІЖІО, метод объекта Кобе, 
1001 

1оокирРгеГіх(), метод объекта Кобе, 1001 
ргосева, пространство имен в Кобе, 323 
8 ѴС, 669 

для обработчиков событий в библиотеке 
ІС^иегу, 580 

область видимости функции как частное 
пространство имен, 273 
объекты, 271 
функции,201 

простые и объектные типы данных, 49 
простые типы данных, 49 

неизменяемые простые значения и ссылки 
на изменяемые объекты, 65 
преобразование, 67 

преобразование объектов в простые значения, 
71 

преобразование простых типов баѵаЗсгірІ 
в простые типы баѵа, 318, 319 
прототипы, 140, 228, 415, 841 
Аггау.ргоіоіуре, 164 
ІС^иегу.йі, 622 
и классы, 222 
и наследование, 138 
И СВОЙСТВО СОП8ІГ11СІОГ, 226 
конструкторов как прототипы новых объек¬ 
тов, 223 


корректная инициализация, ключ к созданию 
подклассов, 252 
определение, 138 

предотвращение расширения классов, 266 
проверка цепочки прототипов объекта, 233 
процедуры, 188 

прямой порядок следования байтов (Ьі^-епбіап), 
731, 913 

прямоугольники 

сІеагКесіО, метод, 897 
СІіепДОесІ, объект, 904 
Ш1КесІ(), метод, 899 
рисование в холсте, 687 
рисование в элементе <сапѵа&>, 892 

Р 

радиальные градиенты, 690, 898 
разделитель абзацев, 42 

разделяемые фоновые потоки выполнения, 724 
размеры холста, 679 
размеры элементов 

определение с помощью С88-свойств, 453 
разреженные массивы, 164,167 
разрывы строк 

в программном коде ЛаѵаЗсгірі, 42 
интерпретация, как точек с запятой, 46 
рамки 

в блочной модели С88, 455 
определение средствами С88, 454 
определение цвета рамки элемента, 458 
распространение событий, 477, 496 
определение, 477 
остановка, 941 
отмена,497 

растворение элемента (пример анимационного 
эффекта), 465 
расширения 

Е4Х (ЕСМАЗсгірІ Гог ХМЬ), 310 
выражения, генераторы, 308 
генераторы, 303 
генераторы массивов, 307 
итераторы, 301 
итерации, 300 
итераторы, 301 
циклы Гог/еасЬ, 300 

константы и контекстные переменные, 295 
краткая форма записи функций, 309 
предотвращение расширения классов, 266 
присваивание с разложением, 298 
расширяемость объектов, 847 
реализация свойства оиіегНТМЬ с помощью 
свойства іппегНТМЬ, 415 
реализация типов и классов 

объекты ХМІі и стандарт Е4Х, 310 
регистрация обработчиков событий, 348, 489 
возникающих в ходе выполнения НТТР- 
запроса, 542 

для событий 1оа<1 и сііск, 31 
дополнительные способы в библиотеке і(}иегу, 
579 

простые методы объекта іС^иегу регистрации 
обработчиков, 575 

с помощью метода асІсІЕѵепІІлзІепегО, 491 
удаление обработчиков событий в библиотеке 
}(}иегу, 580 

установкой атрибутов, 490 
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установкой свойств, 489 
регулярные выражения, 60, 276 
Ке&Ехр, объект, 287 
методы класса 8ігіп&, 285 
определение регулярных выражений, 276 
альтернативы, группировка и ссылки, 281 
задание позиции соответствия, 283 
знаки препинания, 278 
классы символов, 278 
литеральные символы, 276, 277 
специальные символы, 279 
флаги, 284 

определение шаблонов, 277 
подшаблоны, 281 

редактируемое содержимое документов, 441 
режим совместимости, 457 
реляционные базы данных, 748 
решето Эратосфена, алгоритм, 729 

С 

сборка мусора, 50 
свойства 

С88-свойства стиля, 445 
атрибуты, 154,155 

выражения обращения к свойствам, 82 
вычисленного стиля, 468 
глобальные, 815 
имена и значения, 139 
использование в качестве аргументов функ¬ 
ций, 196 

методы чтения и записи, 152 
наиболее важные С88-свойства, 450 
обработчиков событий, 341, 489 
объекта Боситепі, 437 

объекта НТМЬЕІетепі, отражающие НТМЬ- 
атрибуты, 405 

объектов ТОпболѵ, Босшпепі и Еіетепі, 335 
ограничение на использование в безопасных 
подмножествах, 293 
определение, 138 

определение неперечислимых свойств, 262 
определение собственных свойств объекта 
Гипсііоп, 200 
перечисление, 149 

получение и изменение значений, 142 
наследование свойств, 144 
объекты как ассоциативные массивы, 143 
ошибки доступа, 145 

преобразование имен НТМЬ-атрибутов, 406 
преобразование имен атрибутов с данными, 407 
присваивание функций свойствам, 199 
проверка существования, 148 
с данными, 152 
атрибуты, 154 
с методами доступа, 152 
дескрипторы свойств, 154 
добавление в существующие объекты, 152 
использование, 153 

определение с помощью литералов объек¬ 
тов, 152 

устаревшие приемы работы, 157 
сокращенная форма определения свойств 
в С88, 447 
удаление, 147 
форм и их элементов, 431 
функций,209 


холста, 894 
селекторы 
С88, 398, 445 

для правил стиля, 473 
использование в вызове функции і(}иегу(), 
558 

в библиотеке і()иегу, 613, 968 
группы, 617 
комбинированные, 617 
фильтры, 614 
серверный ЛаѵаЗсгірі, 314 

асинхронный ввод/вывод в интерпретаторе 
Кобе, 321 

управление баѵа с помощью Шііпо, 315 
сериализация объектов, 161, 717 
пример использования функции 
б8(ДО.8Ігіп8і?у(), 821 
сетевые взаимодействия 

модуль пеі в интерпретаторе Кобе, 327 
сетевых взаимодействий АРІ для веб¬ 
приложений, 337 

символы и кодовые пункты Юникода, 57 
символы, литеральные в регулярных выраже¬ 
ниях, 277 

символы управления форматом (Юникод), 42 
синхронное выполнение сценария, 346 
синхронные НТТР-ответы, 533 
система координат и преобразования, 892 
система координат холста, 679 
системы организации безопасного окружения, 292 
смена изображений, 656 
снежинки Коха, рисование (пример), 683 
собственные свойства, 139 
собственные события, реализация с помощью 
библиотеки іС^иегу, 584 
события, 476 

ЕггогЕѵепі, объект, 935 
НааЬСЬап^еЕѵепі, объект, 957 
НТМІі5, 486 
теаза^е, 717, 721, 993 
Мезза^еЕѵепІ, объект, 993 
Ра^еТгапзіііопЕѵепі, объект, 1003 
Рор8іаіеЕѵепІ, объект, 1004 
рго^геаа, 1005 
Рго^геааЕѵепІ, объект, 1005 
віогадо, 1010 

8іога&еЕѵепІ, объект, 1010 
архитектуры Аіах в библиотеке і()иегу, 608 
буксировки (бга&-апб-бгор), 508 
в библиотеке іС^иегу, 976 
ввода, аппаратно-зависимые и аппаратно¬ 
независимые, 480 
ввода текста, 515 

использование события ргорегіусЬап^е для 
определения факта ввода текста, 518 
фильтрация ввода (пример), 516 
возникающие в ходе выгрузки файлов, 542 
возникающие в ходе выполнения НТТР- 
запроса, 541 

возникающие в ходе приема ответа, 532 
вызов обработчиков событий, 492 
действия по умолчанию, 478 
загрузки документа, 498 
изменения состояния, 481 
источники событий в Косіе, 323 
категории, 480 
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клавиатуры, 518, 521 
кеуйоѵгп и кеуир, 519 

Кеутар, класс поддержки обработки комби¬ 
наций клавиш (пример), 520 
ввод текста, 515 
колесика мыши, 504 
обработка, 506 
модели ІЮМ, 485 
мультимедийных элементов, 663 
мыши, 483, 485, 500 
не зависящие от типа устройства, 361 
обзор, 347 

обработка событий кэша приложений, 646,648 
обработка с помощью библиотеки іС^иегу, 575 
Еѵепі, объект, 577 
возбуждение событий, 582 
динамические события, 584 
дополнительные способы регистрации обра¬ 
ботчиков событий в библиотеке іС^иегу, 579 
методы регистрации обработчиков, 575 
реализация собственных событий, 584 
удаление обработчиков событий, 580 
объекта 81ога§е, 633 
объект события, 477 
определение, 476 

определяемые стандартом 8егѵег-8епі Еѵепів 
для архитектуры Сотеі, 550 
от таймеров, обработка подобно обычным 
событиям, 481 

поддерживаемые объектом Боситепі, 921 
предельное время ожидания выполнения 
запросов, 544 
прерывания запросов, 544 
распространение, 477, 496 
реализация Лаѵа-интерфейса приемника собы¬ 
тий в ЛаѵаЗсгірі в Шііпо, 318 
регистрация обработчиков, 489 
сенсорных экранов и мобильных устройств, 488 
старые типы событий, 479 
тип или имя события, 476 
типы, 479 

установка атрибутов обработчиков событий, 
490 

цель события, 476 

совместимость на стороне клиента, 352 

библиотеки обеспечения совместимости, 356 
классификация броузеров, 356 
проверка особенностей, 357 
проверка типа броузера, 358 
режим совместимости и стандартный режим, 
358 

условные комментарии в Іпіегпеі Ехріогег, 359 
соглашения об именах С88-свойств в ЛаѵаЗсгірІ, 
464 

содержимое, простой клиентский сценарий, 
исследующий содержимое документа, 335 
создание новых таблиц стилей, 474 
сокращенная форма определения свойств в С88, 
447 

сопоставление с шаблонами, 60 
сортировка без учета регистра символов, массивы 
строк, 173 

составление цепочек вызовов методов, 190 
сохранение данных АРІ для веб-приложений, 337 
сохранение данных на стороне клиента, 627 
соокіеэ, 634 


реализация хранилища, 639 
безопасность и конфиденциальность, 629 
механизм сохранения иаегБаІа в ІЕ, 641 
свойства 1оса181ога&е и 8е&8іоп8іога^е, 630 
хранилище приложений и автономные веб¬ 
приложения, 643 

объявление кэшируемого приложения, 643 
списки 

аргументов переменной длины, 194 
фильтрация в расширении Е4Х, 312 
сравнение 

и преобразование типов, 68 
объектов, 66 
простых значений, 66 
сравнения методы 

реализация в классах, 244 
сотрагеТоО, метод, 246 
е^иа18(), метод, 244 
ссылки, 66 

Ілпк, объект, 984 
в регулярных выражениях, 281 
межсайтовый скриптинг, 365 
получение информации с помощью НЕАБ- 
запросов при поддержке заголовка СОК8, 546 
старые типы событий, 479 
события клавиатуры, 484 
события мыши, 483 
события объекта "ѴѴіпсІоѵѵ, 482 
события форм, 479 

статическое позиционирование элементов, 451 
стили, каскады, 446 
строгий режим, 133 

зарезервированные слова, 45 
строки, 56, 57 
8ігіп&, объект 

объекты-обертки, 64 

доступ к свойствам с использованием формы 
записи [], 143 

значения в таблицах стилей или в атрибуте 
віуіе, 463 

как массивы, 60,184 

методы, использующие регулярные выраже¬ 
ния, 285 

представление состояний приложения, 712 
преобразование массивов, 176 
преобразование между ЛаѵаЗсгірі и Лаѵа, 319 
преобразование объектов в строки, 71 
работа со строками, 59 
сопоставление с шаблонами, 60 
строковые литералы, 56 

и управляющие последовательности, 58 
структура документа и навигация по документу, 
401 

документы как деревья узлов, 401 
сценарии 

І()иегу.беі8сгірѣ(), функция, 598 
8сгірі, объект, 1007 

атрибут іуре, определяющий тип МІМЕ, 341 

во внешних файлах, 339 

синхронные, асинхронные и отложенные, 345 

Т 

таблицы стилей, 472 

С8881у1е8ЬееІ, объект, 910 
включение в НТ МЬ-документы, 446 
включение и выключение, 472 
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определение, 445 

получение, вставка и удаление правил, 473 
создание, 474 
таймеры, 370 

вспомогательные функции (пример), 370 
использование для воспроизведения анимации 
средствами С88, 465 
текст, 56 

встраивание произвольных текстовых данных 
с помощью элемента <всгірі>, 341 
в элементах <асгірі>, 411 
получение выделенного текста, 440 
работа со строками, 59 
рисование в холсте, 692 
рисование в элементе <сапѵаа>, 892 
содержимое элемента в виде простого текста, 
410 

сопоставление с шаблонами, 60 
с тенью, пример позиционирования элементов, 
454 

строковые литералы, 56 
текстовые поля ввода, 434 
управляющие последовательности в строко¬ 
вых литералах, 58 

чтение текстовых файлов с помощью объекта 
ГіІеКеабег, 740 
тени 

рисование в холсте, 695 
рисование в элементе <сапѵаа>, 893 
тернарные операторы, 86 
типизированные массивы и буферы 
&еі(), метод, 729 
8ііЬаггау(), метод, 730 
эффективность, 730 
тип (имя тега) 

выбор элементов документа, 395 
тип события, 476, 479 
тип сценария, 340 
типы данных, 25, 49 

баѵа, преобразование типов в Шііпо, 318 
аргументов функций, 197 
вещественные числа, 51 
изменяемые и неизменяемые, 51 
и классы, 232 

грубое определение типа, 235 
заимствование методов, 247 
методы сравнения, 244 
определение классов объектов с помощью 
оператора іпвіапсео?, 232 
стандартные методы преобразований, 242 
частные члены, 249 
и объявление переменных, 74 
классы, методы, 50 
логические значения, 61 
операндов и результата, 86 
определение классов объектов 
грубое определение типа, 235 
использование имени конструктора как 
идентификатора класса, 234 
поддерживаемые реализацией Азах в библио¬ 
теке і(}иегу, 601 
преобразование, 51, 67 

объектов в простые значения, 71 
преобразования и равенство, 68 
текст, 56 

работа со строками, 59 


сопоставление с шаблонами, 60 
целые числа, 51 
числа, 51 

типы-перечисления, 239 

для представления игральных карт, 241 
транзакции, управление в ІшіехесШВ, 749 
транспорты, 525 

третье измерение, свойство г-іпбех, 453 
трехмерная графика в элементе <сапѵа&>, 673 

У 

узлы, 391 

вставка узлов, 413 

использование объектов БоситепІГга^тепІ, 
416 

создание узлов, 413 
удаление и замена узлов, 415 
унарные арифметические операторы, 90 
унарные операторы, 86 
унаследованные свойства, 139 
управление встроенными стилями 
анимационные эффекты, 465 
управление историей посещений в НТМЬ5, 711 
управление таблицами стилей, 472 
управляемый событиями этап выполнения 
программ, 345 

управляющие последовательности 
в строковых литералах, 58 
условные инструкции, 109,114 
еівеіі, инструкция, 116 
і{, инструкция, 114 
8ЛѴІІСІ1, инструкция, 117 
в генераторах массивов, 308 
условные комментарии в Іпіегпеі Ехріогег, 359 
условный оператор (?:), 105 
установка свойств обработчиков событий, 489 

Ф 

фабричные методы, 250 

фабричные функции, создание и инициализация 
нового объекта, 222 
файловые системы, 742 

использование асинхронного интерфейса 
к файловой системе, 742 
использование синхронного интерфейса, 746 
работа с файлами в локальной файловой систе¬ 
ме, 742 

сохранение данных веб-приложений на сторо¬ 
не клиента, 629 
файлы 

АРІ к файлам и файловой системе в Кобе, 325 
Гііе, объект, 945 

выгрузка посредством НТТР-запроса Р08Т, 539 
как двоичные объекты, 734 
локальные файлы и объект XМ^Ш1рКе^ие5і , 
529 

мониторинг хода выгрузки файлов по протоко¬ 
лу НТТР, 542 

объявлений кэшируемых приложений, 643 
сложные объявления, 644 
Фибоначчи числа, функция-генератор, 305 
фиксировано позиционированные элементы, 452 
фильтрация ввода, 516 
флаги, регулярные выражения, 284, 289 
фоновые потоки выполнения, 720 

выполнение синхронных запросов с помощью 
объекта ХМЬНМрКеаиез! (пример), 726 
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и объект ГіІеКеасІег, 741 
использование синхронного интерфейса 
к файловой системе, 746 
область видимости, 722 
отладка,727 

форма представления чисел с фиксированной 
точкой,835 
формы НТМІі, 428 

НТТР-запросы с данными в формате НТМЬ- 
форм, 536 

возвращаемое значение обработчика события, 
предотвращение отправки формы с неверны¬ 
ми данными, 495 

выбор форм и элементов форм, 430 
обработчики событий форм и их элементов, 432 
свойства форм и их элементов, 431 
события, 479 
элементы, 428 

фрагменты контура (объект Сапѵаа), 675 
фреймворки, клиентские, 356, 367 
фреймы 

взаимодействие Лаѵа8сгір1-кода с фреймами, 

363 

видимая область, 421 

ослабление политики общего происхождения, 

364 

отношения между фреймами, 385 
работа с несколькими окнами и фреймами, 382 
функции,185 

агзшпепІ8[], массив, 761 
Ьіш1(), метод, 211 
са11() и арр1у(), методы, 210 
ГипсііопО, конструктор, 213 
І(}иегу(), функция ($()), 558 
Іо8ігіп&(), метод, 213 
аргументы и параметры, 193 

использование свойств объекта, 196 
необязательные аргументы, 193 
списки аргументов переменной длины, 194 
типы данных аргументов, 197 
вложенные, 335 

возвращающие массивы, присваивание 
с разложением, 298 
вызов, 189 

по мере готовности документа, 499 
вызываемые объекты, 214 
выражения вызова, 83 
выражения определений, 81 
высшего порядка, 217 
генераторы, 304 
глобальные, 45, 815 
замыкания, 203 
именование, 186 
как данные, 198 
как пространства имен, 201 
конструкторы, 815 
краткая форма записи, 309 
математические, 822 
мемоизация, 220 
обработка массивов, 215 

объявление переменных с помощью ключевого 
слова Іеі, 295 

ограничение на использование в безопасных 
подмножествах, 293 
определение, 50,185 

вложенных функций, 188 


определение собственных свойств, 200 
переходов, 592 
свойства, 209 
ІепеМі, 209 
ргоіоіуре, 209, 226 

совместное использование в окнах или фрей¬ 
мах, 387 

утилиты поддержки Азах в библиотеке іС^иегу, 
597 

функция і()иегу (термин), 561 
частичное применение функций, 218 
функции обратного вызова, 348 
І()иегу.аіах(), функция, 605 
передаваемые функциям 8е1Тітеоиі() 
и ееіІпіегѵа1(), 349 

передача методам воспроизведения анимаци¬ 
онных эффектов, 587 
функциональное программирование, 215 

X 

хранилища объектов, 748 
хранилище приложений, 643 

ц 

цвет 

Ьаскбгоиші-соіог, свойство, 453 
аЬабоіѵСоІог, свойство, 695 
определение с помощью С88, 458 
определение цвета в холсте, 687 
определение цвета контура в элементе 
<сапѵаа>, 891 
целые литералы, 52 
цепочки вызовов методов, 190 
цепочки областей видимости, 78 
циклы, 119,120 

<1о/лѵЬі1е, инструкция, 120 
Гог, инструкция, 121 
Іог/іп, инструкция, 122 
лѵЬіІе, инструкция, 119 
и инструкция сопііпие, 127 
цифры, А8СІІ, в регулярных выражениях, 279 

Ч 

частичное применение функций, 218 

частные свойства, 230 

частные члены, имитация в ЛаѵаЗсгірі, 249 

чат 

клиент на основе веб-сокетов, 757 
простой клиент на основе объекта ЕѵепіЗоигсе, 
551 

сервер на основе веб-сокетов и интерпретатора 
Койе, 758 

сервер чата, поддерживающий протокол 
8егѵег-8епі Еѵепів, 554 
числа, 51 

арифметические операции в ЛаѵаЗсгірі, 53 
вещественные литералы, 52 
двоичное представление вещественных чисел 
и ошибки округления, 55 
объекты-обертки, 64 

определение класса комплексных чисел (при¬ 
мер), 228 
преобразование 

объектов в числа, 71 
чисел в строки, 69 
целые литералы, 52 
числовые типы, 49 
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члены класса, в строго типизированных языках, 
227 

чувствительность к регистру в ЛаѵаЗсгірі, 41 

Ш 

шаблонные ІЖЬ-адреса, в объявлениях кэшируе¬ 
мых приложений, 645 

шаблоны, использование для рисования и залив¬ 
ки контуров, 890 
шестнадцатеричные значения, 52 
шестнадцатеричные цифры, определение цветов 
в формате КСВ, 458 
шрифты 

Топі-аіге, 1опі-\ѵеі§М и соіог, свойства стиля, 
463 

веб-шрифты в С88, 450 

Э 

экземпляры, 221 

СОП8ІШСІОГ, свойство, 226 
свойства объекта Ке&Ехр, 287 
создание и инициализация с помощью фабрич¬ 
ных функций,222 

создание с помощью фабричных методов, 250 
экранированные последовательности Юникода, 42 
экспоненциальная форма представления, 52, 834 
элементы 

<1І8р1ау и ѵІ8іЬі1ііу, свойства (С88), 457 
НТМІі-элементы и атрибуты, 932 
атрибуты, 405 

доступ к нестандартным НТМЬ-атрибутам, 
406 

как узлы типа АМг, 408 
с данными, 407 

вставка и замена элементов документа метода¬ 
ми объекта іС^иегу, 571 
выбор форм и элементов форм, 430 
выбор элементов документа, 393 
выбранные элементы в объекте іС^иегу, 561 
вычисленные стили, 447 
геометрия и прокрутка, 421 
документа как свойства окна, 380 
документы как деревья элементов, 402 
копирование методами объекта іС^иегу, 573 
массивов, 164 

методы в библиотеке і()иегу для работы 
с элементами, 972 

обертывание другими элементами с помощью 
методов объекта і()иегу, 574 
определение геометрии, 423 
позиционирование с помощью С88, 451 
проигрыватель, 987 
размеры, позиции и переполнение, 426 
содержимое, 409 
в виде НТМЬ, 409 
в виде простого текста, 410 
в виде текстовых узлов, 411 
удаление с помощью методов объекта іС^иегу, 
574 

формы НТМЬ, 428 

чтение и запись данных в элементе, 570 
чтение и запись параметров геометрии, 568 
чтение и запись содержимого элемента, 568 
элементы-выражения в инициализаторах масси¬ 
вов, 80 

эффект тени, 695 

бЬасіоѵѵВІиг, свойство холста, 695 


эффекты проявления и растворения 
Іа<1еІп() и 1асіеОи1(), методы, 586, 588 
ІайеТоО, метод, 588 

Ю 

Юникод, 41 

в идентификаторах, 44 
нормализация, 43 

символы, кодовые пункты и строки ЛаѵаЗсгірІ, 
57 

символы управления форматом, 42 
экранированные последовательности, 42 

Я 

явное преобразование типов, 69 
якорные элементы регулярных выражений, 283 
перечень, 284 




О’КЕІШГ 



^ѵа8сгірг. Подробное руководство 

В \ ~ 1 Шестое издание книги полностью пересмотрено, добавлены сведения о іаѵаЗсгірі 
в соответствии с современным положением дел в разработке приложений для ШгЬ 2.0. 
Данное руководство программиста с массой практических примеров может с успе¬ 
хом выполнять функции справочника по базовому языку )аѵа5сгір( и клиентским 
прикладным интерфейсам, предоставляемым броузерами. Благодаря добавлению новых глав 
книга содержит практически все сведения, необходимые для разработки сценариев )аѵа5сгірі: 

• Взаимодействие с протоколом НТТР и использование технологии А|ах 

• Обработка ХМЬ-документов 

• Создание графических изображений на стороне клиента с помощью тега <сапѵаз> 
и технологии 5ѴС 

• Пространства имен в )аѵа5сгірі, необходимые для разработки сложных программ 
• Классы, замыкания, статические значения 
• Новые технологии, вошедшие в стандарт НТМБ5 
• Применение библиотеки )<2иегу 

Часть I книги посвящена основам )аѵа5сгірі. В части II описывается среда разработки сценари¬ 
ев, предоставляемая броузерами. Основное внимание уделяется разработке сценариев с приме¬ 
нением методики ненавязчивого ^ѵаЗсгірі и модели ЕЮМ. Глубокое обсуждение тем клиент¬ 
ского ^ѵаЗсгірі иллюстрируется достаточно сложными примерами, которые показывают, как 

• Генерировать оглавление НТМЬ-документа 

• Воспроизводить аудио- и видеоролики 

• Автоматизировать проверку правильности заполнения форм 

• Рисовать динамические круговые диаграммы 

• Обеспечить перетаскивание НТМЬ-элементов мышью 

• Определять в веб-приложениях горячие комбинации клавиш 

* Создавать всплывающие подсказки с применением технологии А|ах 

• Применять ХРаіЬ и Х5ІЛГ для обработки ХМЬ-документов, загруженных средствами А)ах 

• Организовать хранение данных на стороне клиента 

• Взаимодействовать с сервером, применяя новую технологию ^еЬБоскеіз 

• Реализовать параллельное выполнение нескольких заданий с помощью технологии 
Ѵ7еЬ^огкег5 

Часть III - обширный справочник по базовому языку )аѵа5сгірі с описанием всех классов, объек¬ 
тов, конструкторов, методов, функций, свойств и констант, определенных в )аѵа5сгірі 1.8, Ѵ8 3.0 
и ЕСМАБсгірі 5. Часть ГѴ - справочник по клиентскому }аѵа5сгірг, в котором описываются АРІ 
веб-броузеров, стандарт ЭОМ АРІ Ьеѵеі 3 и недавно вошедшие в стандарт НТМБ5 технологии 
^еЬЗоскеіз и >ѴеЬ>Ѵогкег§, объекты 1оса15гога§е и зеззіопЗгога^е, а также теги <аисііо> и <ѵісіео>. 
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